Trace signals during simulation
Simulink / Dashboard
The Dashboard Scope block shows connected signals during simulation on a scope display. You can use the Dashboard Scope block with other Dashboard blocks to build an interactive dashboard of controls and indicators for your model. The Dashboard Scope block provides a complete picture of a signal's behavior over the course of the simulation. Use the Dashboard Scope block to display signals of any data type that Simulink® supports, including enumerated data types. The Dashboard Scope block can display up to eight signals from a matrix or bus.
Dashboard blocks do not use ports to connect to signals. To connect Dashboard blocks to signals in your model, use connect mode. Connect mode facilitates the process of connecting Dashboard blocks in your model, especially when you want to connect multiple blocks at once. If you only want to connect a single Dashboard block, you can also use the Connection table in the block dialog box to make the connection.
To enter connect mode, click the Connect button that appears above your unconnected Dashboard block when you pause on it.
In connect mode, when you select one or more signals or blocks, a list of parameters and signals available for connection appears. Select a signal or parameter from the list to connect the selected Dashboard block. To connect another Dashboard block, pause on the block and click the Connect button above it. Then, make a selection of signals and blocks in your model, and choose a signal or parameter to connect.
When you finish connecting the Dashboard blocks in your model, click the Exit button in the upper-right of the canvas to exit connect mode.
You can add data cursors to the Dashboard Scope to inspect the displayed signals. The data cursors show when the Dashboard Scope block is selected. With the Dashboard Scope block selected, you can move cursors along the displayed signals to see the data values corresponding to each time sample. When you display two cursors, a box between the cursors along the time axis displays the time difference between the two cursors.
To add data cursors, right-click the Dashboard Scope block. Under the Data Cursors menu, select the number of cursors you want to add.
You can also zoom and pan to inspect your signals. To change zoom and pan modes, right-click the Dashboard Scope block, and select the zoom or pan mode you want.
The Dashboard Scope block displays complex signals according to their Complex Format. You can configure the Complex Format for a signal using the Instrumentation Properties dialog box, accessible when you right-click the logging badge for the signal and select Properties. A signal can have a Complex Format of Real-Imaginary, Magnitude-Phase, Magnitude, or Phase. When you set the Complex Format for a signal to Real-Imaginary or Magnitude-Phase, the Dashboard Scope block displays both components of the signal together. The real or magnitude component displays in the color indicated in the Connection table. The imaginary or phase component displays in a different shade of the color indicated in the Connection table.
You cannot save the block connections or properties in model files that use
To save connections and properties, save the model file in the
Dashboard blocks cannot connect to blocks that are commented out.
Dashboard blocks cannot connect to signals inside reference models.
If you turn off logging for a signal connected to a Dashboard block, the model stops sending data from that signal to the block. To view the signal again, reconnect the signal.
Connection— Select signals to connect and display
Select one or more signals to connect using the Connection table. Populate the Connection table by selecting signals of interest in your model. Select the check box next to the signal you want to display. Click Apply to connect the signal.
Time Span— Set horizontal axis span
A finite, real, double, scalar value that sets the time span of the scope display.
When Time Span is set to
block sets its time span to the model's simulation stop time.
Min— Set y-axis minimum
A finite, real, double, scalar value that sets the minimum of the vertical axis on the scope display.
The Min value must be less than the Max value.
Max— Set y-axis maximum
A finite, real, double, scalar value that sets the maximum of the vertical axis on the scope display.
The Max value must be greater than the Min value.
Legend— Set position of legend
Options from the drop-down menu specify the position of the legend in the scope display. The legend shows the color chosen for each connected signal next to the signal's name.
Scale axes limits at stop— Autoscale axes limits when simulation finishes
When on, performs a fit-to-view operation on the data displayed in the scope when the simulation stops.
Show "Double-click to connect" message— Show or hide message
When on, shows instructional text if the block is not connected. When the block is not connected, you can turn this parameter off to hide the text.