SimEvents^®

Instantaneous Entity Counting Scope - Plot entity count versus time

Library

SimEvents Sinks

Description

This block creates a plot by counting arriving entities at each arrival time. The block restarts the count from 1 when the time changes. As a result, the count is cumulative for a given time instant but not cumulative across the entire simulation.

Note If you want to plot the total number of arriving entities across the entire simulation, connect the #d signal of the Entity Departure Counter block to the Signal Scope block.

Use the Enable entity OUT port option to choose whether the entity advances to a subsequent block or whether the block absorbs the arriving entity.

Ports

Entity Input Ports

Label	Description
IN	Port for arriving entities, which the block counts.

Entity Output Ports

Label	Description
OUT	Port for departing entities. This port appears only if you select Enable entity OUT port.

Dialog Box

To open the block dialog box, click the Parameters toolbar button in the plot window.

Plotting Tab

Enable entity OUT port: Causes the block to have an entity output port labeled OUT, through which the arriving entity departs. If you clear this box, the block absorbs arriving entities.
Open scope at start of simulation: Selecting this option causes the plot window to open when you start the simulation. If you clear this box, you can open the plot window by double-clicking the block icon.

Axes Tab

Initial X axis lower limit, Initial X axis upper limit: The interval shown on the X axis at the beginning of the simulation. The interval might change from this initial setting due to zooming, autoscaling, or the If X value is beyond limit setting.
If X value is beyond limit: Determines how the plot changes if one or more X values are not within the limits shown on the X axis. For details, see Varying Axis Limits Automatically.
Initial Y axis lower limit, Initial Y axis upper limit: The interval shown on the Y axis at the beginning of the simulation. The interval might change from this initial setting due to zooming, autoscaling, or the If Y value is beyond limit setting.
If Y value is beyond limit: Determines how the plot changes if one or more entity counts are not within the limits shown on the Y axis. For details, see Varying Axis Limits Automatically.
Show grid: Toggles the grid on and off.

Figure Tab

Title: Text that appears as the title of the plot, above the axes.
Y label: Text that appears to the left of the vertical axis.
X label: Text that appears below the horizontal axis.
Position: A four-element vector of the form [left bottom width height] specifying the position of the scope window. (0,0) is the lower left corner of the display.
Show number of entities: Displays the number of plotted points using an annotation in the plot window.

Data History Tab

Store data when scope is closed: Select Unlimited to have the block cache all data for future viewing, Limited to cache a portion of the most recent data, and Disabled to avoid caching undisplayed data.
Limit data points to: The number of data points the block caches, using the most recent data. This field appears only if you set Store data when scope is closed to Limited.