Open source framework for simulating, analyzing and visualizing pedestrian dynamics. DOI



The primary goal of JuPedSim is to provide students and researchers with a framework to investigate pedestrian dynamics and focus on research, i.e. development and validation of new models or model features, analysis of experiments and proper visualization of results.

For any scientist and especially for bachelor/master/PhD students it is important to not loose time in developing “help tools” e.g. scripts to visualize their results or editing geometries.


JuPedSim is currently focusing on evacuation, but easily extendable to cover other areas e.g. passengers exchange, commuter traffic in railway stations etc.

Finally, JuPedSim also provides sample data sets for calibration and validation. We are developing some standards and benchmark scenarios for evaluation pedestrian simulations based on a large experimental database, which was established over the last years. See for example

Organization of the code

JuPedSim consists of four modules which are loosely coupled and can be used independently at the moment. These are:

  1. jpscore: the core module computing the trajectories. See list of implemented models.
  2. jpsreport: a tool for analyzing the trajectories and validating the model. It implements a couple of measurement methods including the Voronoi-method for calculating the density.
  3. jpsvis: a tool for visualizing the input (geometry) and output (trajectories) data.
  4. jpseditor: a tool for creating and editing geometry files with dxf import/export capabilities.


Showcase and tutorials

To highlight some features of JuPedSim we have uploaded some videos and tutorials on our YouTube channel.

Quick Install

git clone
cd JuPedSim
git submodule update --init --recursive
make -f Makefile.cmake check

Note: it is very important to update the submodule, otherwise the they will be empty!

CMake will eventually report any missing packages. Please fix these errors/warnings first before proceeding with the compilation of JuPedSim with

make -f Makefile.cmake check release


We are heavily working on this project which means that:

  • It’s not done. We will be releasing new enhancements, bug fixes etc.
  • We love your support. If you find any errors or have suggestions, please write an issue in our issue-tracker. We will try hard to fix it.
  • Be patient. We are scientists and PhD/master students. Therefore, we primarily care about our research and theses.


info at jupedsim dot org