Summary
Add animate_trajectories and animate_voronoi_cells functions to PedPy that render frame-by-frame animations of pedestrian data directly in Jupyter notebooks.
Background / Context
PedPy currently supports static trajectory and Voronoi plots but has no animation capability. Animating pedestrian movement over time is a core analysis and presentation need for users working in notebook-based workflows. This is a frequently requested feature.
Technical Details
- Animations should be based on
matplotlib.animation.FuncAnimation and rendered in notebooks via IPython.display.HTML
- Interface should align with existing
plot_trajectories for parameter naming consistency (e.g. traj, walkable_area, color_data, color_column, cmap)
IPython should be an optional dependency with a descriptive error when called outside a notebook environment
- New functions belong in
pedpy/plotting/
Acceptance Criteria
Summary
Add
animate_trajectoriesandanimate_voronoi_cellsfunctions to PedPy that render frame-by-frame animations of pedestrian data directly in Jupyter notebooks.Background / Context
PedPy currently supports static trajectory and Voronoi plots but has no animation capability. Animating pedestrian movement over time is a core analysis and presentation need for users working in notebook-based workflows. This is a frequently requested feature.
Technical Details
matplotlib.animation.FuncAnimationand rendered in notebooks viaIPython.display.HTMLplot_trajectoriesfor parameter naming consistency (e.g.traj,walkable_area,color_data,color_column,cmap)IPythonshould be an optional dependency with a descriptive error when called outside a notebook environmentpedpy/plotting/Acceptance Criteria
IPythonis listed as an optional dependency with a descriptive error when missing