Skip to content

Add animation functions for trajectories and Voronoi cells in Jupyter notebooks #550

Description

@schroedtert

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

  • Usage is demonstrated in the user guide notebook
  • IPython is listed as an optional dependency with a descriptive error when missing

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationusabilityAnything increasing the usablity

    Fields

    No fields configured for Feature.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions