Utilization #
The Utilization component evaluates the environmental utilization by processing simulation recordings and generating a visual representation in the form of a colored mesh, which illustrates the level of utilization over time or within a specific region.
- Component Name: Utilization
- Description: Computes the environment’s utilization based on a flow simulation recording. Provides different modes of analysis, such as total utilization or utilization within a specific time frame, visualized using colored meshes.
- Category: Flow > Util

Inputs: #
- Rec (R): The Flow Simulation Recording from which utilization data is extracted. (Type:
Flow Simulation Recording) - Time (T): (Optional) The time frame to evaluate the utilization. If not provided, the total utilization is computed. (Type:
Number) - Region (R): (Optional) A list of curves defining the specific regions within the environment for which the utilization is to be calculated. (Type:
Curve (List))
Outputs: #
- cMesh (cM): A colored mesh representing the utilization of the environment. Areas with higher utilization are represented with distinct colors, providing visual feedback on agent density and movement within the environment. (Type:
Mesh (List))
Custom UI:
- This component features a multi-dropdown menu that allows users to select the model type (Evacuation or Crowd) and utilization mode (Total or Time Frame).
- A checkbox titled Show Legend enables users to toggle the legend’s visibility, which shows the mapping of colors to utilization values.
Checkpoints #
The Checkpoints component calculates the time between designated checkpoints in the environment, based on the flow simulation recording. Users can choose whether the calculation is based on the average time across all agents or for individual agents.
- Component Name: Checkpoints
- Description: Computes the time taken by agents to reach the specified checkpoints within the environment based on the simulation recording.
- Category: Flow > Util

Inputs: #
- Rec (R): The Flow Simulation Recording from which agent data is extracted for calculating time between checkpoints. Type:
Flow Simulation Recording - cPoints (cPts): A list of points representing the locations of the checkpoints in the environment. Type:
Point (List)
Outputs: #
- Time (T): A data tree of times taken by agents to travel between the designated checkpoints. Depending on the mode selected (Average or All Agents), this output can provide average times or individual times for each agent. Type:
Number (Tree)
Custom UI:
- This component features a dropdown menu that allows users to select the Time Mode, which determines how the checkpoint times are computed:
- Average: Calculates the average time taken by all agents.
- All Agents: Calculates the time for each individual agent.
EvaluateSection #
The EvaluateSection component calculates the flow rate of agents passing through a defined section of the environment, expressed in terms of agents per minute.
- Component Name: EvaluateSection
- Description: Calculates the number of agents passing through a specified section per minute based on the flow simulation recording.
- Category: Flow > Util

Inputs: #
- Rec (R): The Flow Simulation Recording containing agent data, which is used to evaluate agent movement through the specified section. (Type:
Flow Simulation Recording) - sCurve (S): A curve defining the section of the environment through which agent flow is evaluated. (Type:
Curve)
Outputs:
- Agent/m (A/m): The number of agents passing through the defined section per minute, providing insight into agent density and flow rate. (Type:
Integer)
Follow Agent #
The Follow Agent component allows you to follow a specific agent from the simulation in real-time, tracking its movements as it navigates through the environment.
- Component Name: Follow Agent
- Description: Enables real-time following of a specific Flow Agent in the simulation.
- Category: Flow > Util

Inputs: #
- Agent (A): The Flow Agent that will be followed during the simulation. (Type:
FlowAgent) - Follow (F): A boolean parameter to enable or disable following the selected agent. When set to
True, the simulation will focus on the specified agent. (Type:BooleanDefault:False)
Outputs: #
This component does not have any outputs, as it directly manipulates the view to follow the selected agent in the simulation.