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 Hydra .

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