Library

RT-EVENTS Sink

Block

Description

The RTE Scope block displays signals generated during a simulation. The block can have multiple axes (one per port); all axes have a common time range with independent y-axes. The scope allows you to adjust the amount of time and the range of input values displayed. You can move and resize the scope window.

If the signal is continuous, the scope produces a point-to-point plot. If the signal is discrete, the Scope produces a stair-step plot.

To provide a more stable display, the block has an option called the trigger. This option causes the scope to pause after reaching the right-hand side of the screen and wait for a specified event before returning to the left-hand side of the screen and drawing the next trace. The effect is to resynchronize the timebase to the input signal, preventing horizontal drift of the scope. Trigger scope allows the display of nonperiodic signals such as single pulses, as well as periodic signals such as sine waves and square waves.

The Scope provides toolbar buttons that enable you to zoom in on displayed data, display all the data input to the Scope, preserve axis settings from one simulation to the next, limit data displayed, save data to the workspace and select and display specific time range. The toolbar buttons are labeled in this figure, which shows the Scope window as it appears when you open a Scope block. For more help on these features see the Simulink Scope documentation.

RTE Scope toolbar buttons

Mask

RTE Scope Mask

Parameters

External Trigger	Set the kind of trigger use to trigger the scope. Select None to disable this feature or any other values to activate this feature. Double or RTE Boolean signal can be used to trigger the scope. When RTE Boolean signal is used to trigger the scope, the synchronization can occur anywhere in the calculation step.
Number of Axes	Set the number of y-axes in this data field. There is a limit of 6 axes the block can contain. All axes share the same time base (x-axis) but have independent y-axes. Note that the number of axes is equal to the number of input ports.
Time Range	Change the x-axis limits by entering a number. Entering a number of seconds causes each screen to display the amount of data that corresponds to that number of seconds.
Save Data to Workspace	You can automatically save the data collected by the block at the end of the simulation by selecting the Save data to workspace checkbox. If you select this option, the Variable name becomes active.
Variable Name	Enter a variable name in the Variable name field. The specified name must be unique among all data logging variables being used in the model. Other data logging variables are defined on other Scope blocks, To Workspace blocks, and simulation return variables such as time, states, and outputs. Being able to save Scope data to the workspace means that it is not necessary to send the same data stream to both a Scope block and a To Workspace block.
Format	Data can be saved in only one format: Structure with time.
Limits Data Points to Last Events	You can limit the number of data points saved to the workspace by selecting the Limit data points to last N events checkbox and entering a value in its data field. The Scope relies on its data history for zooming and autoscaling operations. If the number of data points is limited to 1,000 events and the simulation generates 2,000 events, only the last 1,000 events are available for regenerating the display.
Number of Points	Number of data points to store in memory
Signal Name Format	You can choose to display none, short or long signal labels.
Discretization of Continuous Signals	When checked, display continuous signal as a stair-step plot instead of a point-to-point plot.

Input

Inputs	Signals to display.
External Trigger	The external signal that triggers the scope.

Output

None.

Characteristics

Direct Feedthrough	No
Sample Time	No
Work Offline	Yes
Dimensionalized	Yes

Example

The rte_encoder.mdl model demonstrates how to use RT-EVENTS blocks to simulate an incremental encoder connected to a rotating object. This example also shows how to use blocks of the library to insert fault, to filter noise and to measure some characteristics of RTE Boolean signal.

In this example, the RTE Scope block is used to display simulated signals. For more examples consult RT-EVENTS demos.