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 line, a point, or a node.
Syntax: PedConstants.LocationType locationType
Default value: PedConstants.LocationType.LINE
Valid values:
PedConstants.LocationType.LINE
PedConstants.LocationType.POINT
PedConstants.LocationType.NODE -
[Visible if Appears at: line]
Target line, where pedestrians appear.Value type: TargetLine
Local variable: ped — the pedestrian -
[Visible if Appears at: point (x,y)]
Level, where pedestrians appear.Value type: Level
Local variable: ped — the pedestrian. -
[Visible if Target is point (x,y)]
X (Y) coordinate of the point where pedestrians appear.Value type: double
Local variable: ped — the pedestrian -
[Visible if Appears at: node]
Polygonal node or rectangular node, where pedestrians appear.Value type: AreaNode
Local variable: ped — the pedestrian -
Speed which is comfortable for the pedestrian. In the absence of external factors pedestrian will move with this speed.
Value type: double
Default value: uniform(0.5,1) meters per second
Local variable: ped — the pedestrian -
Initial speed of the pedestrian.
Value type: double
Default value: uniform(0.3, 0.7) meters per second
Local variable: ped — the pedestrian -
Diameter of the pedestrian.
Value type: double
Default value: uniform(0.4, 0.5) meters
Local variable: ped — the pedestrian
- Create groups
-
If the checkbox is selected, this block will create groups of pedestrians.
Syntax: boolean createGroups
- 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).Syntax: PedConstants.GroupingMode groupingMode
Set new value dynamically: set_groupingMode(new value)
Valid values:
PedConstants.GroupingMode.SIZE_REACHED
PedConstants.GroupingMode.TIMEOUT
PedConstants.GroupingMode.TIME_GAP -
[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 and 3 pedestrians will be created with equal probabilities.Value type: int
Default value: uniform_discr( 2, 3 )
Local variable: leader — the leader of the group -
[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.Value type: double -
[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.Value type: double
Default value: 2 seconds - Group formation
-
[Visible if Create groups is selected]
Form of the group: swarm, front, or chain.Syntax: PedConstants.GroupFormation groupFormation
Set new value dynamically: set_groupFormation(new value)
Valid values:
PedConstants.GroupFormation.SWARM — swarm
PedConstants.GroupFormation.CHAIN — chain
PedConstants.GroupFormation.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.Get value: PedConstants.ServiceGroupBehaviorType serviceGroupBehavior
Set new value dynamically: set_serviceGroupBehavior(new value)
Valid values:
PedConstants.ServiceGroupBehaviorType.INDIVIDUAL_SERVING - All group members are serviced individually
PedConstants.ServiceGroupBehaviorType.ONE_MEMBER_SERVED_OTHERS_WAIT_IN_QUEUE - Only one member is serviced, others wait in a queue
PedConstants.ServiceGroupBehaviorType.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), canceling command for one pedestrian will cancel it for all pedestrians from his group.Syntax: boolean solidCancelling
- On enter
-
Code executed when a pedestrian enters the block.
Local variable: ped — the pedestrian
- On exit
-
Code executed when a pedestrian exits the block.
Local variable: ped — the pedestrian
- On begin grouping
-
Code executed when the first member of a new group enters the block.
Local variables:
leader — the leader of the current group
PedGroup group — the group being currently created - On end grouping
-
Code executed when the group assembly is finished.
Local variables:
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?
-