In the configuration file, the following sections should be defined:
<?xml version="1.0" encoding="UTF-8" ?> <JPSreport project="JPS-Project" version="0.8" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://github.com/JuPedSim/jpsreport/blob/develop/xsd/jps_report.xsd">
It might be useful to precise a logfile (for debugging purposes):
indicates the file name corresponding to the trajectory files to analyze. Note that the file should be in the same location as the configuration file.
<geometry file = "geo_KO_240_050_240.xml" />
indicates the location and the name of the trajectory files that will be analyzed.
The format of trajectory files should be
The supported unit of the trajectories is
Two other sub-options
path can be supplied.
path is given, then all files with the corresponding format in
the given folder will be considered as the upcoming trajectories
JPSreport will try to load them one by one.
path are given, then only the given trajectories
will be considered (several
file tags can be given at the same time).
The location can be either absolute path or relative path to the location of the inifile. A path is considered absolute if it starts with “/” (Linux system) or contains “:” (Windows system).
<trajectories format="txt" unit="m"> <file name="traj_KO_240_050_240.txt" /> <file name="traj_KO_240_060_240.txt" /> <path location="./" /> </trajectories>
gives relative path based on the location of inifile or the absolute path.
Indicates the types and location of the measurement areas you plan to use for analysis. Mainly two kind of measurement areas can be defined:
area_B: a 2D area and can be polygon (the orientation of its points is clockwise)
area_L: a reference segment line defined by two points.
area_L is only used in method A, while
area_B is used for method B, method C and method D.
Several measurement areas can be given and distiguished with different
zPos is used to indicate the position of measuement area in z axis.
zPos is useful for geometry with several stories.
- the option
length_in_movement_directionis only used in method B and the value will be ignored in other methods.
- If not given in method_B, the effective distance between entrance point to the measurement area and the exit point from the measurement area will be used.
<measurement_areas unit="m"> <area_B id="1" type="BoundingBox" zPos="None"> <vertex x="-2.40" y="1.00" /> <!-- Clockwise --> <vertex x="-2.40" y="3.00" /> <vertex x="0" y="3.00" /> <vertex x="0" y="1.00" /> <length_in_movement_direction distance="2.0" /> </area_B> <area_L id="2" type="Line" zPos="None"> <start x="-2.40" y="1.00" /> <end x="0" y="1.00" /> </area_L> <area_L id="3" type="Line" zPos="None"> <start x="-2.40" y="2.00" /> <end x="0" y="2.00" /> </area_L> </measurement_areas>
precises the method for calculating the instantaneous velocity of pedestrian at time from trajectories:
<velocity frame_step="10" set_movement_direction="None" ignore_backward_movement="false"/>
Possible parameters are
frame_stepgives the size of time interval for calculating the velocity. The default value is 10.
set_movement_directionindicates in which direction the velocity will be projected. The value of
None, which means that you don’t consider the movement direction and calculate the velocity by the real distance. This is the default value.
- Any real number from
360which represents the angular information of the direction in the coordination system. Note that the axis can be represented either by
Y-or by 0, 90, 180, 270.
SeeTraj. For complex trajectories with several times of direction change, you can indicate the detailed direction using the angular information in the trajectory file (By adding a new column in
.txtfile or adding a new variable in
.xmlfile with the indicator
ignore_backward_movementindicates whether you want to ignore the movement opposite to the direction from
set_movement_direction. The default value is
Indicates the parameters related to each measurement method.
Four different methods
method_D are integrated in the current
JPSreport and can be chosen for the analysis.
Further information relating to each method can be found
in Pedestrian fundamental diagrams: Comparative analysis of experiments in different geometries.
For definition see Method A.
<method_A enabled="true"> <measurement_area id="2" frame_interval="100" plot_time_series="true"/> <measurement_area id="3" frame_interval="100" plot_time_series="true"/> </method_A>
Possible parameters are:
idspecifies the location of the reference line. several measurement areas can be set in one inifile with different id-numbers.
frame_intervalspecifies the size of time interval (in frame) for calculating flow rate.
plot_time_seriesspecifies whether output the ()-Diagram.
Output data (in the folder: ‘./Output/Fundamental_Diagram/FlowVelocity/’). See
For definition see Method B
<method_B enabled="false"> <measurement_area id="1" /> </method_B>
this method can only be used to analyze one directional
(or part of one directional) pedestrian movement in corridors.
The speed is defined by the length of the measurement area
length_in_movement_direction and the time a pedestrian stays in the area.
Possible parameters are:
measurement_areagiven by an
idnumber. Note that the measurement area for method_B should be rectangle based on the definition of the method.
Output data: mean density and velocity of each pedestrian ( and ).
For definition see Method C.
<method_C enabled="true"> <measurement_area id="1" plot_time_series="false"/> </method_C>
Possible parameters are:
idindicates the size and location of the measurement_area. Several measurement areas can be set in one inifile.
plot_time_seriesspecifies whether output the () and () diagrams.
Output data: mean density and velocity of over time and .
For definition see Method D
<method_D enabled="true"> <measurement_area id="1" start_frame="None" stop_frame="None" plot_time_series="false" get_individual_FD="false"/> <one_dimensional enabled="false"/> <cut_by_circle enabled="false" radius="1.0" edges="10"/> <output_voronoi_cells enabled="false" plot_graphs="false"/> <profiles enabled="false" grid_size_x="0.20" grid_size_y="0.20"/> </method_D>
Possible parameters are:
- For each
measurement_area, several id numbers can be set in one inifile.
stop_framegive the starting and ending frame for data analysis. The default values of these two parameters are
None. If you plan to analysis the whole run from beginning to the end, set both of
stop_frameis not, then analysis will be performed from beginning of the trajectory to the
stop_frame = None, it will analyze from the
start_frameto the end of the movement.
plot_time_seriesspecifies whether output the and -diagram.
get_individual_FDdetermines whether or not to output the data for individual fundamental diagram in the given measurement area, which is based on the Voronoi density and velocity of each pedestrian in a given measurement area but not mean value over space. If true, the related data will be written in the folder ./Output/Fundamental_Diagram/IndividualFD/
one_dimensionalshould be used when pedestrians move on a line single-file experiment.
cut_by_circledetermines whether to cut each cell by circle or not. Two options
radiusof the circle and the number of
edgeshave to be supplied for approximating the circle if
output_voronoi_cellsspecifies whether or not to output data for visualizing the Voronoi diagram. Two options
plot_graphshave to be set. If both of them are
true, files including Voronoi cells, speed and the coordinates of pedestrian corresponding to each cell as well as the figures of Voronoi cells will be created in the folder ./Output/Fundamental_Diagram/Classical_Voronoi/VoronoiCell/. If the latter is
false, only the data will be created but the figures will not be plotted. When
false, nothing will be created.
profilesindicates whether to calculate the profiles over time and space. If
enabledis true, the resolution which is decided by the parameters
grid_size_xshould be set. The data will be in the folder ./Output/Fundamental_ Diagram/Classical_Voronoi/field/.
Output data: Mean density and velocity over time and . Sample data for plotting the Voronoi cells. Data for plotting profiles. Data of individual Fundamental diagram.