SimEvents^®

X-Y Attribute Scope - Plot data from two attributes of arriving entities

Library

SimEvents Sinks

Description

This block plots a curve using data from two real scalar-valued attributes of arriving entities. Use the Y attribute name and X attribute name parameters to specify which attributes to plot.

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.

Ports

Entity Input Ports

Label	Description
IN	Port for arriving entities, whose attributes contain the data to plot.

Entity Output Ports

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

Signal Output Ports

Label	Description
#a	Number of entities that have arrived at the block since the start of the simulation.

The initial output value, which is in effect from the start of the simulation until the first update by the block, is 0.

Dialog Box

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

Plotting Tab

Plot type: The presentation format for the data. See Connections Among Points in Plots for details.
Y attribute name: Name of the attribute to plot along the vertical axis.
X attribute name: Name of the attribute to plot along the horizontal axis.
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 Y values 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.

Statistics Tab

These parameters determine whether certain ports produce data throughout the simulation, produce data only when you stop or pause the simulation, or are omitted from the block. For descriptions of the affected ports, see the "Signal Output Ports" table above.

Number of entities arrived: Controls the presence and behavior of the signal output port labeled #a.

Examples

You can modify the example in Example: A Packet Switch to check that all possible combinations of source and destination are used in the simulation. Insert an X-Y Attribute Scope block between the Path Combiner and Output Switch blocks and use it to plot the Destination attribute against the Source attribute.