documentation | jpscore | jpsreport
This repository consists of two modules for simulating and anlyzing pedestrian dynamics. These are:
jpscore
: the core module computing the trajectories.jpsreport
: a tool for analyzing the trajectories and measuring the density, flow and velocity.
The build is tested on Ubuntu 18.04 with gcc-9.1 / clang-8 and on macOS Mojave 10.14.5 with dependencies from Homebrew and Apple LLVM 10.
On Linux you will need a C++17 capable compiler and a standard library that
supports <filesystem>
. On macOS you will need the system compiler with C++17
and filesystem from boost.
Required:
- boost (>= 1.65)
- libomp (if you want to use OpenMP with Apple LLVm or Clang on Linux)
- spdlog (libspdlog-dev on Ubuntu, spdlog on brew)
- fmtlib (libfmt-dev on Ubuntu, fmt on brew)
- cmake (>= 3.1)
Recommended:
- ninja-build
Once you have installed all dependencies and cloned the repository continue with a ninja based build:
mkdir build
cd build
cmake -GNinja -DCMAKE_BUILD_TYPE=Debug <path-to-cmakelists>
ninja
Alternatively you can generate a make based build with:
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug <path-to-cmakelists>
make -j$(nproc)
Note: If you do not want to use OpenMP you have to pass -DUSE_OPENMP=OFF
to
cmake on generation.
cmake -DCMAKE_BUILD_TYPE=Debug -DUSE_OPENMP=OFF <path-to-cmakelists>
The following configuration flags are available:
Build jpscore
with OpenMP support, generation will fail if OpenMP cannot be
found.
MSVC only support OpenMP 2.0 Standard and is therefor disabled on Windows.
Build internal Doxygen based documentation
Build unit tests and add them to ctest
Build full system tests and add them to ctest
Build an additional target jpscore_asan
with address and undefined behavior
sanitizer enabled. Note there is an approx. 2x slowdown when using
jpscore_asan
over jpscore
Build unittests with code coverage.
See Getting started with jupedsim.
To highlight some features of JuPedSim we have uploaded some videos on our YouTube channel.
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.
Enjoy!