JuPedSim is a library for simulating pedestrian dynamics. This software is mainly developed at the Institute for Civil Safety IAS-7 of the Jülich Research Center (Forschungszentrum Jülich) in Germany.
JuPedSim offers a Python interface, to set up and conduct pedestrian dynamics simulations. With JuPedSim you can simulate small, simple layouts as bottleneck, but you can also simulate large, complex scenarios. In these complex scenarios, different crowd management measures can be modeled with built-in modules.
For simulating the pedestrian movement and interactions JuPedSim offers two different microscopic models out of the box. The Collision Free Speed Model, as the name imply a speed model. And a force model with the Generalized Centrifugal Force Model.
With JuPedSim different decisions-making processes in the agents route choice can be modeled. These routes may consist of multiple steps the agents have to complete. One step may already be completed when an agent reaches the target, but it may also only be completed when a condition like a waiting is fulfilled. After each completion one of the built-in deciders can be used to conditionally modify the agents next target.
It is easiest to install directly with pip from PyPi.org
pip install jupedsim
For information how to build JuPedSim from source, visit our GitHub repository.
The documentation of JuPedSim is hosted on: https://www.jupedsim.org
For usage questions, the best place to go to are the GitHub discussions and the documentation.
If you found a bug and want to give us a chance to fix it we would be very happy to hear from you. To make it easy for us to help you please include the following information when you open a new issue:
- What did JuPedSim do?
- What did you expect JuPedSim to do?
- How can we reproduce the issue?
If you encounter a bug and are would like to submit a fix feel free to open a PR, we will look into it.
Before embarking on larger work it is a good idea to discuss what you plan.