== Agent Parameters ==
[[TracNav(doc/app/partoc|nocollapse)]]
\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
'''NAMELIST group name: {{{agents_par}}}'''

||='''Parameter Name'''  =||='''[../fortrantypes FORTRAN Type]'''  =||='''Default Value'''  =||='''Explanation'''  =||
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#a_rand_target '''a_rand_target''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
L(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * .F.
}}}
{{{#!td
Flag for agents within a group to have random targets outside of model domain.\\\\
One logical value per agent [#number_of_agent_groups group]. If .T., each agent in that group will have a random target just outside the model domain. Otherwise a target (see [#at_x at_x]/[#at_y at_y]) must be set manually for each agent group.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#adx '''adx''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
Distance along x between agents within an agent source (in m).\\\\
Each agent source is defined as an area from x = [#asl asl] to [#asr asr] and y = [#ass ass] to [#asn asn]. The first agent is released at x = asl; y = ass. More agents are released at x = asl + N * '''adx''' (x <= asr) and y = ass + N * ady (y <= asn), forming a raster.\\\\
To add a random element to these release points, see [#random_start_position_agents random_start_position_agents].
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#ady '''ady''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
Distance along y between agents within an agent source (in m).
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#agent_maximum_age '''agent_maximum_age''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
Maximum time an agent can spend in the simulation before it is deleted.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#agent_time_unlimited '''agent_time_unlimited''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
L
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
.F.
}}}
{{{#!td
Flag to determine number of unlimited dimensions in NetCDF output file.\\\\
In the agent NetCDF output file only the number of agents is an unlimited dimension by default. Contrarily, the time dimension is estimated as having a size of 1.2 * [/wiki/doc/app/d3par#end_time end_time] / [#dt_write_agent_data dt_write_agent_data] by default. If this flag is set to .T., both dimensions are set as unlimited. This requires NetCDF4, HDF5 and results in a much larger output file.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#alloc_factor_mas '''alloc_factor_mas''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
20.0
}}}
{{{#!td
Factor (in percent) describing the memory allocated additionally to the memory needed for initial agents at a given grid cell.\\\\
Implementation is the same as [/wiki/doc/app/parpar#alloc_factor alloc_factor].
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#asl '''asl''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
Left border of agent source(s) (in m).\\\\
Check [#adx adx] for information of agent sources.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#asn '''asn''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
North border of agent source(s) (in m).\\\\
Check [#adx adx] for information of agent sources.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#asr '''asr''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
Right border of agent source(s) (in m).\\\\
Check [#adx adx] for information of agent sources.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#ass '''ass''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
South border of agent source(s) (in m).\\\\
Check [#adx adx] for information of agent sources.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#at_x '''at_x''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
x-coordinate of agent group target (in m).\\\\
Each agent in a group will navigate through building topography toward the corresponding target with x = '''at_x''' and y = at_y
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#at_y '''at_y''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R(100)
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
100 * 9999999.9
}}}
{{{#!td
y-coordinate of agent group target (in m).\\\\
Each agent in a group will navigate through building topography toward the corresponding target with x = at_x and y = '''at_y'''
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#bc_mas_lr '''bc_mas_lr''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
C*15
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
'absorb'
}}}
{{{#!td
Boundary condition for agents at the left and right model boundary.\\\\
By default, agents are deleted when they leave the model domain ('''bc_mas_lr''' = '' 'absorb' '').\\
Cyclic lateral boundary conditions can be introduced by setting bc_mas_lr = '' 'cyclic' ''. 
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#bc_mas_ns '''bc_mas_ns''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
C*15
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
'absorb'
}}}
{{{#!td
Boundary condition for agents at the north and south model boundary.\\\\
By default, agents are deleted when they leave the model domain ('''bc_mas_ns''' = '' 'absorb' '').\\
Cyclic lateral boundary conditions can be introduced by setting bc_mas_ns = '' 'cyclic' ''. 
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#coll_t_0 '''coll_t_0''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
3.0
}}}
{{{#!td
Range of unscreened interactions for social force model (in s).\\\\
Collision avoidance of pedestrians is implemented according to the approach of [http://motion.cs.umn.edu/PowerLaw/ Karamouzas et al. (2014)]. This parameter implies a maximum range that pedestrians consider for collision avoidance, i.e., potential collisions that will occur more than '''coll_t_0''' in the future are largely ignored.\\\\
'''NOTE''': This parameter should generally not be changed.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#corner_gate_start '''corner_gate_start''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
0.7
}}}
{{{#!td
Distance of navigation gate starting point to obstacle corner (in m).\\\\
Convex obstacle corners are used for agents to navigate towards their target (see [#at_x at_x]/[#at_y at_y]). In order to avoid collisions with these obstacles, the navigation points do not coincide exactly with the obstacle corners but are shifted outward along the bisector of the corner. The navigation point for each agent at a given corner is chosen randomly along a line following the corner bisector starting at '''corner_gate_start''' outward from the corner and ending at corner_gate_start + [#corner_gate_width corner_gate_width] outward from the corner, forming a 'gate' at each obstacle corner through which agents can pass. This gate helps to avoid clustering of agents moving in different directions at corner navigation points.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#corner_gate_width '''corner_gate_width''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
1.0
}}}
{{{#!td
Width of navigation gate at obstacle corners (in m).\\\\
See [#corner_gate_start corner_gate_start] for details.
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#deallocate_memory_mas '''deallocate_memory_mas''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
L
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
.T.
}}}
{{{#!td
Parameter to enable deallocation of unused memory.\\\\
If the number of agents in a grid box exceeds the allocated memory, new memory is allocated. However, if the number of agents per grid box is only temporarily high, most of the memory will be unused later. If deallocate_memory = .T., the allocated memory used for agents will be dynamically adjusted with respect to the current number of agents every [#step_dealloc_mas step_dealloc_mas]'th timestep. 
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#dist_to_int_target '''dist_to_int_target''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
R
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
0.75
}}}
{{{#!td
Distance (in m) at which an intermittent target counts as reached.\\\\
Each agent in an agent group navigates toward that groups target ([#at_x at_x]/[#at_y at_y]). To do this a preprocessed navigation mesh (visibility graph) is searched via the A*-algorithm for the most efficient path toward the target. The agent successively navigates toward a number of intermittent targets along the calculated path, each such target providing the direction of the driving force until it is reached. Each intermittent target counts as reached as soon as the distance between it and the current agent position is smaller than '''dist_to_int_target'''. Then, the next intermittent target along the path is chosen. 
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#dt_agent '''dt_agent''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
DATA TYPE
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
DEFAULT VALUE
}}}
{{{#!td
EXPLANATION
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#PARAMETER '''PARAMETER''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
DATA TYPE
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
DEFAULT VALUE
}}}
{{{#!td
EXPLANATION
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#PARAMETER '''PARAMETER''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
DATA TYPE
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
DEFAULT VALUE
}}}
{{{#!td
EXPLANATION
}}}
|----------------
{{{#!td style="vertical-align:top; text-align:left;width: 150px"
[=#PARAMETER '''PARAMETER''']
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 50px"
DATA TYPE
}}}
{{{#!td style="vertical-align:top; text-align:left;style="width: 75px"
DEFAULT VALUE
}}}
{{{#!td
EXPLANATION
}}}