Analysis with JPSreport

In the directory demos some sample files will get you started.

The organization of JPSreport is as follows


Preparing the input files

Three input files are required to run JPSreport:

  • Trajectory file: Pedestrian’s 2D position information over time. .xml and .txt formats are supported.
  • Geometry file: Geometry for a certain trajectory data. This file should be in .xml format.
  • Configuration file: This inifile gives some information related to each measurement method. e. g. the location of measurement areas, the chosen method etc. This file should be in .xml format.

Run JPSreport

After succesfully compiling the code you can just run jpsreport in a terminal as follows:

./bin/jpsreport inifile.xml

inifile.xml defines all the needed information to start a analysis with JPSreport.


Possible output of JPSreport includes data for plotting fundamental diagrams, Voronoi diagrams and profiles of pedestrians etc. in a given geometry. All the output data, e.g. density and speed, are stored in different folders as plain text in ASCII format.

After a successful analysis additional folder named Output will be created in the same directory as the used inifile. It contains the basic data including plain text and eventually figures (depending on your specifications in the inifile).