@chraibi chraibi released this Jun 13, 2018 · 1 commit to master since this release

Assets 4

Introduction

Jülich Pedestrian Simulator (JuPedSim) is an open source framework for simulating and analyzing pedestrian dynamics.

JuPedSim comes with four different modules:

  • jpseditor: Geometry editor. For changes in this release, see CHANGLOG
  • jpscore: The simulation module. For changes in this release, see CHANGLOG
  • jpsvis: Geometry and trajectories visualization tool (not actively developed)
  • jpsreport: Analysis module For changes in this release, see CHANGLOG

Documentation

@chraibi chraibi released this Nov 6, 2017 · 12 commits to master since this release

Assets 3

Introduction

Jülich Pedestrian Simulator (JuPedSim) is an open source framework for simulating and analysing pedestrian dynamics.

JuPedSim comes with four different modules:

  • jpseditor: Geometry editor. For changes in this release, see CHANGLOG
  • jpscore: The simulation module. For changes in this release, see CHANGLOG
  • jpsvis: Geometry and trajectories visualization tool (not actively developed)
  • jpsreport: Analysis module For changes in this release, see CHANGLOG

Documentation

Pre-release

@chraibi chraibi released this Oct 11, 2016 · 58 commits to master since this release

Assets 8

Introduction

Jülich Pedestrian Simulator (JuPedSim) is an open source framework for simulating and analysing pedestrian dynamics.

JuPedSim comes with four different modules:

  • jpseditor: Geometry editor. For changes in this release, see CHANGLOG
  • jpscore: The simulation module. For changes in this release, see CHANGLOG
  • jpsvis: Geometry and trajectories visualization tool (not actively developed)
  • jpsreport: Analysis module For changes in this release, see CHANGLOG

Installer (Windows)

The directory sample contains some project files that should get you started.

Open a command-line shell (PowerShell) and call jpscore.exe with an inifile to start a simulation.

This should produce a trajectory file, which can be visualized by jpsvis.exe.

Besides, you can open the geometry file with jpsvis.exe for visualisation or
with jpseditor for editing.

Added: further sample files for jpsreport are added to the executable.

Installer OSX

For jpseditor and jpsvis use the dmg-files.

Installer Linux

For Debian based distributions use the attached deb-files.

Some packages have dependencies that might not be installed and therefore have to be installed separately.

Type

dpkg-deb -I <one_of_our_deb_files> 

to find out about the necessary dependencies.

Install with

sudo dpkg -i <one_of_our_deb_files>

In case you don't have root privilege you can proceed as follows:

mkdir tmp && cd test

# download for example jpseditor.deb 
wget https://github.com/JuPedSim/JuPedSim/releases/download/v0.8.1/jpseditor.deb

ar x jpseditor.deb

tar xvzf data.tar.gz 

./usr/bin/jpseditor

Install dependencies on Ubuntu:

The main dependencies are Qt, VTK and Boost. To install (tested on Ubuntu 14)

QT

sudo apt-get install qt5-default qttools5-dev-tools

VTK

sudo apt-get install libvtk5-dev libvtk5.8-qt4 python-vtk libvtk-java

BOOST

The available versions of Boost on Ubuntu/Debian are old and do not fulfill the requirements of JuPedSim. Therefore, you will have to compile it. You can use this script to do so.

Tutorials

Tutorials how to use jpseditor and jpscore can be found in our YouTube channel

Issues

Please check our issue tracker.

Pre-release
Pre-release

@piccolodream piccolodream released this Jul 15, 2015 · 64 commits to master since this release

Assets 3

We are proud to announce the next release of JuPedSim, a tool for simulating pedestrians evacuations. Four modules are shipped with this release:

  • JPScore: command line simulation core
  • JPSvis: visualization module
  • JPSreport: reporting tool
  • JPSeditor: editor for the geometry

Here are the noteworthy features, please consult the documentation and our YouTube channel for the complete set.

What's new

JPSeditor (New module for manipulating geometry files)


  • Editor for the geometry
  • Import dxf files
  • Tutorial available at our YouTube channel

JPScore


Added
  • Risk tolerance factor (value in [0 1]) for pedestrian. Pedestrians with high values are likely to take more risks.
  • Sources for generating agents at runtime. Parameter are frequency (agents per seconds) and maximum number
  • Option to color the pedestrians by group, spotlight, velocity, group, knowledge, router, final_goal, intermediate_goal. Usage: (
    <trajectories format="xml-plain" fps="8" color_mode="group">)
  • More control over the triangulation specially to avoid skinny triangles. Usage: <navigation_mesh method="triangulation" minimum_distance_between_edges="0.5" minimum_angle_in_triangles="20" use_for_local_planning="true" />
  • Improved statistics. The flow curve for the different exits can be computed at runtime.
  • Changelog file
  • Rimea testcases
  • Unit tests are now based on the Boost testing engine
Fixed
  • Visibility in 3D
  • Numerous geometrical operations

JPSreport


Added
  • Added four demos as examples for using JPSreport
  • Added the option for specifying the location of scripts in configuration file.
  • Embedded python scripts (_Plot_N_t.py, _Plot_timeseries_rho_v.py) for plotting N-t diagram (Method A), time series of density/velocity diagram (Method C and D) and Voronoi diagrams (Method D).
  • Added python script (SteadyState.py) for automatically detecting steady state of pedestrian flow based on time series of density and velocity. When plotting fundamental diagrams normally only data under steady state are used due to its generality.
  • Added python script (_Plot_FD.py) for plotting fundamental diagram based on the detected steady state.
Changed
  • Changed the data type of frame rate (fps) from integer to float
  • Changed the way for dealing with pedestrian outside geometry. In old version JPSreport stops when some pedestrians are outside geometry but now it continue working by
    removing these pedestrians from the list.
  • More than one sub rooms in one geometry can be analyzed independently.
Fixed
  • Obstacles inside geometry.

JPSvis


Added
  • Display the geometry structure individual room/subroom.
  • Now build on OSX/Linux/Windows

    Fixed

  • Compilations issues on OSX

@piccolodream piccolodream released this Feb 4, 2015 · 77 commits to master since this release

Assets 3

We are proud to announce the second release of JuPedSim, a tool for simulating pedestrians evacuations. Three modules are shipped with this release:

  • JPScore: command line simulation core
  • JPSvis: visualization module
  • JPSreport: reporting tool

Here are the noteworthy features, please consult the documentation and our YouTube channel for the complete set.

New features


New module (JPSreport)
  • New module for analysing trajectories and generating different kind of plots including time series, Voronoi densities, profiles, fundamental diagrams.
JPScore
  • Steering the simulation with predefined events (closing or opening doors during the simulation)
  • Information sharing between the pedestrians. The agents now share their knowledge about closed doors.
  • Pre evacuation time for groups of agents.
  • Adjustable velocities on stairs and even terrain for group of agents.
  • Stability and performance improvement. The simulation is approx 40% faster for larger scenarios and you will notice it
  • New route choice model, cognitive map, giving agents the possibility to explore the environment and discover doors for instance.
  • Different sensors for improving the navigation of pedestrians (smoke/jam sensor).
  • New verification and validation tests.
  • General statistics over the evacuation (for instance areas egress time and door usage)
  • Support for Visual Studio and Xcode compilers.
JPSvis
  • Saving and restoring settings from previous session.
  • Making high quality videos directly from the visualization interface or generating png sequences
  • Performance improvement

Showcase


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

Additional infos


Additional information on the build procedure or installation for different IDEs and platforms are found :
here for jpscore
here for jpsreport

Basic Usage


Running

>> jpscore.exe 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.

Running

>> jpsreport.exe report_ini.xml

Don't forget to have a look at the demos folder for more examples.

Known issues


For a complete list of issues, please visit our official bug tracking system at
https://cst.version.fz-juelich.de/public.

Pre-release

@piccolodream piccolodream released this Aug 5, 2014 · 97 commits to master since this release

Assets 3

We are proud to announce the first pre-release of our software JuPedSim for simulating pedestrians evacuations. Please note that it is a pre-release version for developers only. We are working hard towards the final release for this version. Two modules are shipped with this pre-release:

  • JPScore: command line simulation core
  • JPSvis: visualization module

Features


  • 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 sequences
  • XML based input files

Installing


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.

Uninstalling


As JuPedSim comes with no installer, you just need to delete the unzipped directory.

Basic Usage


Running

>> 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.

Showcase


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

Compiling from sources


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.

Windows (tested on Win7 with MinGW 4.8)

cmake -G "MinGW Makefiles " CMakeList.txt
make-mingw32.exe

Linux (tested on Ubuntu 14.04 with gcc 4.8)

cmake   CMakeList.txt
make

OSX (tested on OSX Maverick with clang 5.1)

cmake   CMakeList.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 (visualization toolkit) here.

System Requirements


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.

Known Issues


  • Some verification tests are still failing
  • Occasional crashes if the input files are not valid. Make sure to validate you XML input files with the supplied XSD files.

Frequently Asked Questions


  1. 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.
  2. 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.
  3. Is there a manual ?
    • Of course, the user's guide is found in the downloaded archive.
  4. 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.
  5. How can I contribute to JuPedSim?
    • Testing and reporting bugs will be great. If you want to contribute actively to the code, by implementing new models and/or features, you are welcome to do so. Please contact uns per mail at
      info at jupedsim.org so that we can grant you access to the repositories.