Data-driven physics-based modeling of pedestrian dynamics

Python package to create physics-based pedestrian models from pedestrian trajectory measurements. This package is an implementation of the data-driven generalized pedestrian model presented in:

Pouw, C. A. S., van der Vleuten, G., Corbetta, A., & Toschi, F. (2024). Data-driven physics-based modeling of pedestrian dynamics. Phys. Rev. E 110 (6 Dec. 2024), p. 064102. DOI: 10.1103/PhysRevE.110.064102.

Abstract. We introduce a data-driven physics-based generalized Langevin model that allows robust and generic modeling of pedestrian behavior across any environment where extensive pedestrian trajectory data is available. Our model effectively captures the complex interplay between the deterministic movements and stochastic fluctuations associated with walking.

Documentation

• Documentation: https://c-pouw.github.io/physics-based-pedestrian-modeling.

Usage Notebook

This Goolge Colab notebook can be used to create pedestrians models without the need to install the package or download any data. The notebook can be used with all the environments discussed below, or can be easily adapted for any other data set.

• Notebook: https://colab.research.google.com/github/c-pouw/physics-based-pedestrian-modeling/blob/master/usage_notebooks/physped_quick_start.ipynb

Installation

You can install the package from PyPI

pip install physics-based-pedestrian-modeling

Using the CLI

Run the main processing script for one of the available environments by overwriting the params variable with the configuration filename of the environment. The configuration filenames associated to every environment are specified below. These parameter configurations are handled by Hydra, see their documentation for more details .

physped_cli params=CONFIGURATION_FILE_NAME

Similarly, we can overwrite all the other parameter directly from the command line. For instance, if we want to process the narrow corridor trajectories with a different noice intensity, e.g. sigma=0.7, we can simply run

physped_cli params=narrow_corridor params.model.sigma=0.7

Creating the model for multiple parameter values can be achieved by adding -m and listing the variables. For example

physped_cli -m params=narrow_corridor params.model.sigma=0.5,0.7,0.9

Available environments

Every environment discussed in the paper that relies a on public data set can be modeled using the cli by overwriting the 'params' variable with one of the following configuration filenames:

Narrow corridor

The dynamics of a single pedestrian walking undisturbed through a narrow corridor is possibly one of the simplest conceivable dynamics; an almost one-dimensional movement solely confined by two parallel corridor walls.

To model this environment we use the public pedestrian trajectory dataset: Crowdflow – diluted pedestrian dynamics in the Metaforum building of Eindhoven University of Technology.

Configuration filename: narrow_corridor

Intersecting walking paths

Trajectories of intersecting walking paths. We synthesize these from the narrow corridor trajectory data set for which half of the trajectories are rotated by 90 degrees. Note that these trajectories were measured in the dilute limit, consequently there is no interaction between them.

Configuration filename: intersecting_paths

Train station platforms

Complex dynamics of pedestrians walking across real-life train platforms.

Eindhoven train station track 3-4.

Configuration filename: eindhoven_pf34.

To model this environment we use the public pedestrian trajectory dataset: Data-driven physics-based modeling of pedestrian dynamics - dataset: Pedestrian trajectories at Eindhoven train station

Amsterdam Zuid train station track 1-2.

Configuration filename: asdz_pf12.

To model this environment we use the public pedestrian trajectory dataset: Trajectory data Amsterdam Zuid (track 1-2) underlying the PhD-thesis: Mind your passenger! The passenger capacity of platforms at railway stations in the Netherlands

License

• Free software: 3-clause BSD license

Contact