JuPedSim

JuPedSim is a framework designed to support students and researchers in investigating pedestrian dynamics and conducting research related to the development and validation of new models or model features. It enables the analysis of experiments and facilitates the proper visualization of results.

7
mentions
4
contributors

Cite this software

What JuPedSim can do for you

DOI GitHub license PyPI - Python Version PyPI - Version

Jülich Pedestrian Simulator - JuPedSim

JuPedSim is a library to simulate 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.

Installation

It is easiest to install directly with pip from PyPi.org

pip install jupedsim

Usage

Please consult our documentation.

Contributing

JuPedSim is licensed under GNU LGPLv3 hence we are looking forward to your contributions and would be happy to see questions, issues and pull requests.

Questions

If you have a question or a problem please open a new topic in GitHub discussions.

Issues

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?

Pull Requests

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.

While we are very happy if you contribute we reserve us the right to decline your PR because it may not fit into our vision of JuPedSim.

License

GNU LGPLv3

Building from source

Here you have two options.

With setuptools

You will need a C++20 capable compiler and CMake >= 3.19 installed on your system. Then install our python dependencies via pip. Our python package dependencies are listed in requirements.txt in the root of this repository. Now you can call pip install .

E.g.:

cd jupedsim
pip install -r requirements.txt
pip install .

Compile yourself

You will need a C++20 capable compiler and CMake >= 3.19 installed on your system. Then install our python dependencies via pip. Our python package dependencies are listed in requirements.txt in the root of this repository. Now you can generate makefiles with CMake, then compile and run the python library.

pip install -r jupedsim/requirements.txt
mkdir jupedsim-build
cd jupedsim-build
cmake ../jupedsim
make -j
source ./environment

The last line in the above description will populate the python path with the location of our python code and the native library.

[!WARNING]

When sourcing ./environment from the build folder you need to ensure JuPedSim is not installed in the current python environment. Otherwise there will be erroneous calls to the wrong python code, resulting in crashes and/or exceptions.

Logo of JuPedSim
Keywords
Programming languages
  • Python 73%
  • C++ 21%
  • Jupyter Notebook 5%
  • C 1%
  • CMake 1%
License
  • LGPL
</>Source code
Packages
pypi.org

Participating organisations

Forschungszentrum Jülich

Mentions

Contributors

Mohcine Chraibi
Mohcine Chraibi
TS
Tobias Schrödter
Developer
Forschungszentrum Jülich GmbH
KK
Kai Kratz
Leader
Forschungszentrum Jülich GmbH
CH
Christian Hirt
Developer
Forschungszentrum Jülich GmbH

Related software

PedPy

PE

PedPy is a Python library for the analysis of pedestrian movement data.

Updated 5 months ago
3 1

SUMO

SU

Eclipse SUMO is an open source, highly portable, microscopic and continuous traffic simulation package designed to handle large networks. It allows for intermodal simulation including pedestrians and comes with a large set of tools for scenario creation.

Updated 5 months ago
16 10