Main Content

Entity Output Switch

Output entities

expand all in page
  • Library:

  • SimEvents

  • Entity Output Switch block

Description

The Entity Output Switch block allows you to select an output port for the departure of an entity among multiple entity output ports. The selected port can change during the simulation and you can choose the criterion for switching between output ports.

Here are some scenarios in which you might use an output switch:

  • Entities advance to one of several queues based on efficiency or fairness concerns. For example, airplanes advance to one of several runways depending on queue length, or customers advance to the first available cashier out of several cashiers.

    Comparing different approaches to efficiency or fairness, by testing different rules to determine the selected output port of the output switch, might be part of your goal in simulating the system. For an example, see Route Vehicles Using an Entity Output Switch Block.

  • Entities advance to a specific destination based on their characteristics. For example, parcels advance to one of several delivery vehicles based on the locations of the specified recipients.

  • Entities use an alternate route in case the preferred route is blocked. For example, a communications network drops a packet if the route to the transmitter is blocked and the simulation gathers statistics about dropped packets.

Alternatively, you can use the Entity Gate block to control the flow of entities on a specific entity path. For more information, see Using Entity Priority to Sequence Departures.

Ports

Input

expand all

Input entity port for entities entering the block.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | enumerated | bus | fixed point

Input control port for the incoming control entity that determines the output port for the entities departing from the block.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

Output

expand all

Output entity port for entities exiting the block.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | enumerated | bus | fixed point

Output entity port for entities exiting the block.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | enumerated | bus | fixed point

Parameters

expand all

Number of output ports for entity departure.

Programmatic Use

Block Parameter: NumberOutputPorts
Type: character vector
Values: '2' | scalar
Default: '2'

Choose the criterion for switching between output ports.

  • To output the entity to the first unblocked port, select First port that is not blocked.

    Assume an example where entities arriving at the Entity Output Switch block depart through the first entity output port that is not blocked, as long as at least one entity output port is not blocked. An everyday example of this approach is a single queue of people waiting for service by one of several bank tellers, cashiers, call center representatives, etc. Each person in the queue wants to advance as soon as possible to the first available service provider without preferring one over another.

  • To output entities in a round robin fashion among the output ports, select Round robin.

  • Select From control port to let the control port determine the selected port for entity departure. A control port will appear to input an anonymous entity carrying data with a value greater than 0 and smaller than or equal to the number of output ports to determine the active port.

  • To specify an attribute that determines the output port, select From attribute. The attribute value is greater than 0 and smaller than or equal to the number of output ports to determine the active port.

    Consider the situation in which parcels are sorted among several delivery vehicles based on the locations of the specified recipients. If each parcel is an entity, then you can attach data to each entity to indicate the location of its recipient.

  • To randomly select an output port for entity departure, select Equiprobable. Set the Seed to generate a random number and to determine the active output port.

Note

The block rounds a double precision value to the nearest integer less than or equal to its value as port selection. For instance, the value 0.3 is rounded of to 0 which is not a valid value for port selection.

Programmatic Use

Block Parameter: SwitchingCriterion
Type: character vector
Values: 'First port that is not blocked' | 'Round robin' | 'From control port' | 'From attribute' | 'Equiprobable'
Default: 'First port that is not blocked'

Select the initial port for the entity departure.

Dependencies

This parameter is visible when Switching criterion is set to Round robin or From control port.

Programmatic Use

Block Parameter: InitialPortSelection
Type: character vector
Values: '1' | scalar
Default: '1'

Specify the attribute name used to switch the output port.

Dependencies

This parameter is visible when Switching criterion is set to From attribute.

Programmatic Use

Block Parameter: SwitchAttributeName
Type: character vector
Values: 'Attribute1' | character vector
Default: 'Attribute1'

Specify the seed for the random number generator to determine the output port.

Dependencies

This parameter is visible when Switching criterion is set to Equiprobable.

Programmatic Use

Block Parameter: Seed
Type: character vector
Values: '34567' | scalar
Default: '34567'

Model Examples

Route Vehicles Using an Entity Output Switch Block

Route Vehicles Using an Entity Output Switch Block

Route vehicles to two different pumps in a gas station by controlling an Entity Output Switch block.

Open Model
Resource Allocation from Multiple Pools

Resource Allocation from Multiple Pools

A technique for allocating resources from multiple resource pools. It shows how to choose a pool from which to draw a resource, based on given criteria.

Open Model
Job Scheduling and Resource Estimation for a Manufacturing Plant

Job Scheduling and Resource Estimation for a Manufacturing Plant

Model a manufacturing plant. The plant consists of an assembly line that processes jobs based on a pre-determined schedule. This example walks you through a workflow for:

Open Script
Comparing Queuing Strategies

Comparing Queuing Strategies

Have you ever been in a supermarket checkout and wondered why you are in the slowest line? This example shows how queuing systems can be modeled in SimEvents for this type of application. Two parallel versions of a simple model of a four register supermarket counter are presented - one that uses four separate queues and one with a single "serpentine" queue that feeds all registers.

Open Model
Modeling a Kanban Production System

Modeling a Kanban Production System

A production system that uses kanbans to manage production activities. Analysis of simulation results highlights problems in the system and suggests ways to improve its performance.

Open Model
Effects of Communication Delays on an ABS Control System

Effects of Communication Delays on an ABS Control System

How stochastic network traffic causes timing latency and uncertainty in an anti-lock braking system (ABS) that uses Control Area Network (CAN) communications. The model is representative of a real-world heavily-loaded network and also illustrates a domain-specific model of a distributed system. By including real-world timing effects in a model, you gain confidence about the behavior and robustness of your design before you test it in hardware.

Open Model

Version History

Introduced in R2016a

See Also

| | | | | | | |

Topics