Python package to create physics-based pedestrian models from crowd measurements
Project description
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
We provide the following usage notebook on Google Colab:
- Quick-start with the generalized pedestrian model.
The notebook can be used to create a model for the following environments:
- Walking paths in a narrow corridor.
- Intersecting walking paths.
- Walking paths on a train station platform.
Using the CLI
Install the package from source
git clone https://github.com/c-pouw/physics-based-pedestrian-modeling.git
cd physics-based-pedestrian-modeling
pip install -e .
Run the main processing script for one of the available parameter files (listed below)
python physped/main.py params=PARAM_NAME
Parameter Files
Parameter configurations are handled by 
- single_paths: Trajectories in a narrow corridor.
- intersecting_paths: Trajectories intersecting in the origin.
- asdz_pf12: Complex trajectories on the Amsterdam Zuid train platform 1 and 2.
License
- Free software: 3-clause BSD license
