Skip to main content

JuPedSim is an open source pedestrian dynamics simulator

Project description

JuPedSim Logo

DOI GitHub license PyPI - Python Version PyPI - Version

JuPedSim - Jülich Pedestrian Simulator

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.

Table of Contents

Main Feature

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.

Where to get it

It is easiest to install directly with pip from

pip install jupedsim

For information how to build JuPedSim from source, visit our GitHub repository.




The documentation of JuPedSim is hosted on:

Getting Help

For usage questions, the best place to go to are the GitHub discussions and the documentation.

Issues, Discussion and Development

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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jupedsim-1.0.5.tar.gz (24.5 MB view hashes)

Uploaded source

Built Distributions

jupedsim-1.0.5-cp312-cp312-win_amd64.whl (512.9 kB view hashes)

Uploaded cp312

jupedsim-1.0.5-cp311-cp311-win_amd64.whl (513.1 kB view hashes)

Uploaded cp311

jupedsim-1.0.5-cp310-cp310-win_amd64.whl (512.1 kB view hashes)

Uploaded cp310

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page