Table of Contents generated with DocToc

Several operational models are implemented in jpscore. An operational model defines how pedestrians moves from one time step to the next. In the definition of agent’s properties it is mandatory to precise the number of the model to be used e.g.:

<agents operational_model_id="n">

where n is 1, 2, 3, 4 or 5.

General model parameters (for all models)

The definition of any model parameter is composed of two different sections:

Model_parameters

Agent_parameters

The agent parameters are mostly identical for all models. Exceptions will be mentioned explicitly.

The parameters that can be specified in this section are Gauss distributed (default value are given).

Desired speed

Shape of pedestrians

Pedestrians are modeled as ellipses with two semi-axes: $a$ and $b$, where

$ a= a_{min} + a_{\tau}v, $

and

$ b = b_{max} - (b_{max}-b_{min})\frac{v}{v^0}. $

$v$ is the peed of a pedestrian.

Other parameters in this section are:

Generalized Centrifugal Force Model

Generalized Centrifugal Force Model is a force-based model.

Usage:

<model operational_model_id="1" description="gcfm">

Gompertz model

Gompertz Model is a force-based model.

Usage:

<model operational_model_id="2" description="gompertz">

Collision-free speed model

Collision-free speed model is a velocity-based model. See also this talk for more details about the model.

Usage:

<model operational_model_id="3" description="Tordeux2015">

Model parameters

Besides the options defined in Mode_parameters the following options are necessary for this model:

The names of the aforementioned parameters might be misleading, since the model is not force-based. The naming will be changed in the future.

Agent parameters (recommendations)

Actually, this model assumes circular pedestrian’s shape, therefore the parameter for the semi-axes Agent_parameters should be chosen, such that circles with constant radius can be obtained. For example:

<bmax mu="0.15" sigma="0.0" />
<bmin mu="0.15" sigma="0.0" />
<amin mu="0.15" sigma="0.0" />
<atau mu="0." sigma="0.0" />

This defines circles with radius 15 cm.

In summary the relevant section for this model could look like:

<model operational_model_id="3" description="Tordeux2015">
    <model_parameters>
        <solver>euler</solver>
        <stepsize>0.05</stepsize>
        <exit_crossing_strategy>3</exit_crossing_strategy>
        <linkedcells enabled="true" cell_size="2"/>
        <force_ped  a="5" D="0.2"/>
        <force_wall a="5" D="0.02"/>
    </model_parameters>
    <agent_parameters agent_parameter_id="1">
        <v0 mu="1.34" sigma="0.0" />
        <v0_upstairs mu="0.668" sigma="0.167" />
        <v0_downstairs mu="0.750" sigma="0.188" />
        <v0_idle_escalator_upstairs mu="0.5" sigma="0.0" />
        <v0_idle_escalator_downstairs mu="0.5" sigma="0.0" />
        <bmax mu="0.15" sigma="0.0" />
        <bmin mu="0.15" sigma="0.0" />
        <amin mu="0.15" sigma="0.0" />
        <atau mu="0." sigma="0.0" />
        <tau mu="0.5" sigma="0.0" />
        <T mu="1" sigma="0.0" />
    </agent_parameters>
</model>

Wall-avoidance model

Wall-avoidance model is a velocity-based model. The Wall-Avoidance Model focuses on valid pedestrian positions. The interaction of agents with walls takes precedence over the agent-to-agent interaction. There are two key aspects:

Valid exit strategies are {6, 8, 9}. Please see details below.

(Sample) Usage:

<model operational_model_id="4" description="gradnav">
  <model_parameters>
    <solver>euler</solver>
    <stepsize>0.01</stepsize>
    <exit_crossing_strategy>9</exit_crossing_strategy>
    <floorfield delta_h="0.0625" wall_avoid_distance="0.4" 
        use_wall_avoidance="true" />
    <linkedcells enabled="true" cell_size="4.2" />
    <force_ped nu="3" b="1.0" c="3.0" />
    <force_wall nu="1" b="0.70" c="3.0" />
    <anti_clipping slow_down_distance=".2" />
  </model_parameters>
  <agent_parameters agent_parameter_id="0">
    <v0 mu="1.5" sigma="0.0" />
    <bmax mu="0.25" sigma="0.001" />
    <bmin mu="0.20" sigma="0.001" />
    <amin mu="0.18" sigma="0.001" />
    <tau mu="0.5" sigma="0.001" />
    <atau mu="0.23" sigma="0.001" />
  </agent_parameters>
</model>

Parameters

Generalized Centrifugal Force Model with lateral swaying

The Generalized Centrifugal Force Model with lateral swaying is mostly identical to the GCFM Model, but instead of a variable semi-axis $b$ of the ellipse simulating the pedestrian, pedestrians perform an oscillation perpendicular to their direction of motion. As a consequence the parameter Bmax is ignored.

Usage:

<model operational_model_id="5" description="krausz">

Four Parameters can be passed to control the lateral swaying, for example:

<sway ampA="-0.14" ampB="0.21" freqA="0.44" freqB="0.35" />

Setting ampA and ampB to 0 disables lateral swaying. If not specified, the empirical values given in Krausz, 2012 are used, that is: