Plot data from attribute of arriving entities
This block creates a plot using data from a real scalar-valued attribute of arriving entities. Use the Y attribute name parameter to specify which attribute to plot along the vertical axis.
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.
The Plot type parameter on the Plotting tab determines whether and how the block connects the points that it plots. For details, see Connections Among Points in Plots.
Use the X value from parameter to select the type of data for the horizontal axis. The table below describes the choices.
|Source of X Data||Description of Plot|
|Event time||Plot of the specified attribute versus simulation time.|
|Index||Plot of the successive values of the specified attribute against a horizontal axis that represents the index of the values. The first entity's attribute value has an index of 1, the second entity's attribute value has an index of 2, and so on. For example, you might use this option when multiple entities might arrive simultaneously, to help determine the exact sequence among the simultaneous attribute values.|
The figures below illustrate the different sources of data for the horizontal axis. The plots look similar, except that the second plot has uniform horizontal spacing rather than time-based spacing between successive points.
Entity Input Ports
|IN||Port for arriving entities, whose attributes contain the data to plot.|
Entity Output Ports
|OUT||Port for departing entities. You see this port only if you select Enable entity OUT port.|
Signal Output Ports
|#a||Number of entities that have arrived at the block since the start of the simulation.|
The initial output value is 0. This value is in effect from the start of the simulation until the first update by the block.
To open the block dialog box, click the Parameters toolbar button in the plot window.
The presentation format for the data. See Connections Among Points in Plots for details.
Name of the attribute to plot along the vertical axis.
Source of data for the plot's horizontal axis. See Selecting Data for the Horizontal Axis for details.
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.
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.
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.
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.
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.
Determines how the plot changes if one or more attribute values are not within the limits shown on the Y axis. For details, see Vary Axis Limits Automatically.
Toggles the grid on and off.
Text that appears as the title of the plot, above the axes.
Text that appears to the left of the vertical axis.
Text that appears below the horizontal axis.
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.
Displays the number of plotted points using an annotation in the plot window.
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.
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.
These parameters determine whether the block produces data at signal output ports or omits those ports. For descriptions of the data and ports, see the preceding table, "Signal Output Ports".