Documentation Center

  • Trials
  • Product Updates

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

LabelDescription
INPort for arriving entities, which the block counts.

Entity Output Ports

LabelDescription
OUTPort for departing entities. You see this port 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 Vary 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 Vary 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. You see this field only if you set Store data when scope is closed to Limited.

Was this topic helpful?