Table of Contents generated with DocToc
Open source framework for simulating, analyzing and visualizing pedestrian dynamics.
Goal
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:
-
jpscore: the core module computing the trajectories. See list of implemented models. -
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. -
jpsvis: a tool for visualizing the input (geometry) and output (trajectories) data. -
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 https://github.com/JuPedSim/JuPedSim.git
cd JuPedSim
git submodule update --init --recursive
make -f Makefile.cmake checkNote: 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 releaseSupport
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.
Contact/Feedback
You have found a bug in the code? Please help us with your feedback. You can contact us per mail at
info at jupedsim dot org.