Accepts pedestrians generated somewhere (e.g. in some other pedestrian flowchart, that the pedestrians exited via PedExit block) at input port, assigns their physical parameters and injects pedestrians into the simulated environment at specified location.

This block also can be used to organize groups from sequence of pedestrians on input port. Allows defining multiple criteria for groups creation — group size, form, groups arrival rate, pedestrians interarrival delay, etc.

Also, this block can be used to change pedestrian parameters like speed, color, diameter, etc.

Appears at

Here you choose whether you define the place where pedestrians appear with a target line, a point (x, y) with specified coordinates, or a node.

Name: locationType
Type: PedConstants.LocationType
Valid values:
PedEnter.LOCATION_LINE — line
PedEnter.LOCATION_POINT — point (x, y)
PedEnter.LOCATION_NODE — node

Target line

[Visible if Appears at: line]
Target line, where pedestrians appear.

Type: TargetLine
Local variable: T ped — the pedestrian

Level

[Visible if Appears at: point (x, y)]
Level, where pedestrians appear.

Type: Level
Local variable: T ped — the pedestrian.

X

[Visible if Target is point (x, y)]
X-coordinate of the point where pedestrians appear.

Type: double
Local variable: T ped — the pedestrian

Y

[Visible if Target is point (x, y)]
Y-coordinate of the point where pedestrians appear.

Type: double
Local variable: T ped — the pedestrian

Node

[Visible if Appears at: node]
Polygonal node or rectangular node, where pedestrians appear.

Type: AreaNode
Local variable: T ped — the pedestrian

Comfortable speed

Speed which is comfortable for the pedestrian. In the absence of external factors pedestrian will move with this speed.

Type: double
Default value: uniform(0.5, 1) meters per second
Local variable: T ped — the pedestrian

Initial speed

Initial speed of the pedestrian.

Type: double
Default value: uniform(0.3, 0.7) meters per second
Local variable: T ped — the pedestrian

Diameter

Diameter of the pedestrian.

Type: double
Default value: uniform(0.4, 0.5) meters
Local variable: T ped — the pedestrian

Create groups

If the checkbox is selected, this block will create groups of pedestrians.

Name: createGroups
Type: boolean
Set new value at runtime: set_createGroups(new value)

New group is created

[Visible if Create groups is selected]
Defines how groups are created: whether a group is created when the specified group size is reached (on size reached), or when the specified timeout expires (on timeout), or when delay between pedestrian arrivals exceeds the specified gap value (on time gap).

Name: groupingMode
Type: PedConstants.GroupingMode
Set new value at runtime: set_groupingMode(new value)
Valid values:
PedEnter.GROUPING_MODE_SIZE_REACHED — on size reached
PedEnter.GROUPING_MODE_TIMEOUT — on timeout
PedEnter.GROUPING_MODE_TIME_GAP — on time gap

Group size

[Visible if Create groups is selected and New group is created: on size reached]
Size of newly created group (number of pedestrians making up one group). If you leave the default value here, groups containing 2 or 3 pedestrians will be created with equal probabilities.

Type: int
Default value: uniform_discr(2, 3)
Local variable: T leader — the group leader

Group assembly time

[Visible if Create groups is selected and New group is created: on timeout]
Time given for group creation. When this timeout elapses, the group creation is finished and next group starts forming.

Type: double
Default value: exponential(12) seconds

Maximum gap between members

[Visible if Create groups is selected and New group is created: on time gap]
Maximum pedestrian interarrival time, for them to be collected in one group. In case pedestrian interarrival time exceeds this value, new group is created.

Type: double
Default value: 2 seconds

Group formation

[Visible if Create groups is selected]
Form of the group: swarm, front, or chain.

Name: groupFormation
Type: PedConstants.GroupFormation
Set new value at runtime: set_groupFormation(new value)
Valid values:
PedEnter.GROUP_FORMATION_SWARM — swarm
PedEnter.GROUP_FORMATION_CHAIN — chain
PedEnter.GROUP_FORMATION_FRONT — front

Group behavior in services

[Visible if Create groups is selected]
Here you can define how the groups of pedestrians created by this block behave while passing the services (if some other behavior is not defined in the block PedService).

All group members are serviced individually — Each member of the group should be serviced individually. The example of such a service: turnstiles.
Only one group member is serviced, others wait in a queue — The example: a family buying cinema tickets at the counter. All the family members wait in a queue to choose the seats together, but only one of them — the head of the family pays and gets serviced.
Only one group member is serviced, others wait in a waiting area — The example: a tourist group buying museum tickets. The tourists do not wait in the queue, they just wait in a separate area (modeled by a network node) for their tour guide to buy the tickets for the whole group.

Name: serviceGroupBehavior
Type: PedConstants.ServiceGroupBehaviorType
Set new value at runtime: set_serviceGroupBehavior(new value)
Valid values:
PedEnter.SGB_INDIVIDUAL_SERVING — All group members are serviced individually
PedEnter.SGB_ONE_MEMBER_IS_SERVED_OTHERS_WAIT_IN_QUEUE — Only one member is serviced, others wait in a queue
PedEnter.SGB_ONE_MEMBER_IS_SERVED_OTHERS_WAIT_IN_AREA — Only one member is serviced, others wait in a waiting area

Cancelling a pedestrian cancels the group

[Visible if Create groups is selected]
If the checkbox is selected (true), cancelling command for one pedestrian will cancel it for all pedestrians from his group.

Name: solidCancelling
Type: boolean
Set new value at runtime: set_solidCancelling(new value)

On enter

Java code executed when a pedestrian enters the block.

Local variable: T ped — the pedestrian

On exit

Java code executed when a pedestrian exits the block.

Local variable: T ped — the pedestrian

On begin grouping

[Visible if Create groups is selected]
Java code executed when the first member of a new group enters the block.

Local variables:
T leader — the leader of the current group
PedGroup group — the group being currently created

On end grouping

[Visible if Create groups is selected]
Java code executed when the group assembly is finished.

Local variables:
T leader — the leader of the current group
PedGroup group — the just assembled group

Function	Description
long countPeds()	Returns the total number of pedestrians passed through this block.
long countGroups()	Returns the number of created groups (including the group which is currently being created).
int size()	Returns the number of pedestrians that are currently inside the block.
void take(Agent ped)	Inserts the given agent in the process flow by outputting it from the out port.
Agent remove(Agent agent)	Removes the specified agent from the block.

in

The input port.

out

The output port.

How can we improve this article?

Send