The core module for performing the simulation (i.e. computing the trajectories).
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. We will try hard to fix it.
- Be patient. We are scientists and PhD/master students. Therefore, we primarly care about our research and theses.
Enjoy!
- Simulate pedestrians movement in a space continuous geometry
- Forces-based models for describing the pedestrians interactions
- Shortest and quickest path route choice strategies
- Loading and visualizing trajectories and geometries
- Easy to use visualization interface
- Making high quality videos directly from the visualization interface or generating png screenshots
- XML based input files
To highlight some features of JuPedSim we have uploaded some videos on our YouTube channel.
This version comes with no installer. So just download the archive corresponding to your architecture and unzip them and you are ready to go. The binaries are only available for windows at the moment. For other architectures (Linux, OSX) you will need to compile the sources. See the section Compiling from sources.
As JuPedSim comes with no installer, you just need to delete the unziped directory.
jpscore.exe my_simulation_ini.xml
from the command line (or also dropping the file on the executable) will generate a trajectory file, which you can visualize with jpsvis
.
You will find some projects samples in the downloaded files and further information in the manual.
You can compile the simulation core for your specific platform with the supplied cmake script. The only requirement is a compiler supporting the new standard c++11.
cmake -G "MinGW Makefiles" CMakeLists.txt
mingw32-make.exe
cmake CMakeLists.txt
make
cmake CMakeLists.txt
make
Note that the OpenMP acceleration might be missing under OSX
For the visualization module (jpsvis
) at least Qt version 4.5 and VTK version 4.8 are required.
You can download the latest version of QT here and the latest version of VTK here.
There is no special hardware/software requirements for running JuPedSim. The distributed binaries however, are only available for windows at the moment. For compiling from sources you need a compiler with c++11 support is needed for the core. Qt version >=4.5 and VTK >5.8 are needed for the visualization.
Some verification tests are still failing. The actual cdash-board can be found here Occasionaly jpscore crashes if the input file is not valid. Make sure to validate your XML input files with the supplied XSD files.
-
What is the official page of JuPedSim? www.jupedsim.org and the contact is info at jupedsim.org. You will find more information on the working group and other tools and experimental pedestrians data we have been collecting over the years.
-
Where is the official repository? JuPedSim is developed at the Forschungszentrum Jülich in Germany and the bleeding edge code is in their intern git repository. At the moment only specific tags are pushed to GitHub.
-
Is there a manual? Of course, the user's guide is found in the downloaded archive.
-
Are the models validated? We are actually setting up verification and validation tests. Some verification tests are included in this version but most of them will be available with the next version. This is an ongoing process.
-
How can I contribute to JuPedSim? Testing and reporting bugs will be great. If you may want to contribute actively to the code, by implementing new models and/or features, you are welcome to do so.