physics-based-pedestrian-modeling 0.3.0

Python package to create physics-based pedestrian models from crowd measurements

Data-driven physics-based modeling of pedestrian dynamics

Project Overview

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. Preprint, https://arxiv.org/abs/2407.20794

Documentation

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

Usage Notebooks

^{_{- Quick-start notebook demonstrating the generalized pedestrian model.}}

This notebook can be used to create a model for all the environments that rely on public data sets without the need to locally install the package.

Installation

Alternatively, you can locally install the package from PyPI

pip install --upgrade 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 file name of the environment. The configuration file names 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

The environments that rely on public data sets can be used by overwriting the 'params' variable with one of the following configuration file names:

Narrow corridor

Trajectories of walking paths in a narrow corridor.

Configuration file name: narrow_corridor

Intersecting walking paths

Trajectories of intersecting walking paths.

Configuration file name: intersecting_paths

Train station platform

Trajectories of walking paths in the Amsterdam Zuid train station on platform 1 and 2.

Configuration file name: asdz_pf12

License

• Free software: 3-clause BSD license