The Simulation Data Inspector tool provides the capability to inspect and compare time series data. There are several methods for launching the Simulation Data Inspector tool, see Open the Simulation Data Inspector Tool to choose the method that best supports your workflow. The Simulation Data Inspector window includes the following elements:
Three tabs: Inspect Signals, Compare Signals, and Compare Runs
The Signal Browser table appears on each of the three tabs. You can customize the information displayed in the Signal Browser table by performing the following tasks:
The Plot View displays in the right pane of the Simulation Data Inspector tool. To modify a plot, refer to the following:
To launch the Simulation Data Inspector tool, choose one of the following methods:
MATLAB command-line: Enter
Simulink Editor: Click the Record button arrow.
Select Simulation Data Inspector from the list.
There are several methods for populating the Simulation Data Inspector with data.
If you are using the record button to simulate and record data, you must specify your model to export signals. For more information, see:
After your model is configured to export signal data, see Record Simulation Data.
If you want to view previously logged signal data, see Import Logged Signal Data.
For a list of Simulink® data export formats that are not supported in the Simulation Data Inspector, see Limitations of the Simulation Data Inspector.
To add or remove a column, right-click the Signal Browser table title bar. Select Columns and click an option on the list. The column is displayed in the table.
Column Options for the Inspect Signals and Compare Signals Tabs
|Run||Name of a simulation run|
|Block Path||Path to the source block for the signal|
|Block Name||Name of the source block|
|Absolute Tolerance||Positive number (user-specified)|
|Relative Tolerance||Positive number (user-specified)|
|Synchronization Method||Method to align time vector: union, intersection, uniform (user-specified)|
|Interpolation Method||Method to align data: zoh, linear (user-specified)|
|Data Source||Name for the data (logsout.Stick.Data)|
|Model||Model name for the signal data|
|Signal Name||Signal name for the data (Stick)|
|Time Series Root||String signifying the name of the Simulink.Timeseries object (logsout.Stick.Time)|
|Time Source||String signifying the array containing the time data (logsout.Stick.Time)|
|Port||Index of the output port that emits the signal logged|
|Dimensions||Number of dimensions of the signal|
|Channel||Channel of matrix data|
Column Options for Compare Runs Tab
|Result||Result of the comparison for the signal across the specified runs|
String identifying the data source
Signal names from two runs for comparison:
Positive number (user-specified)
Positive number (user-specified)
Method to align time vector: union, intersection, uniform (user-specified)
Method to align data: zoh, linear (user-specified)
Channel of matrix data
After selecting a column option, the new column is added to the table in the order that it appears in the options list.
You can customize the organization of your logged data in the Signal Browser table. By default, data is first organized by run. You can then organize your data by model hierarchy, logged variable, or no hierarchy.
If your model contains referenced models to view, you can group your data by model hierarchy and then by the logged variables. To change the grouping in the Signal Browser table:
At the bottom of the Signal Browser table, click the Change Grouping link.
In the Group Signals dialog box, in the first Then By list, select Model Hierarchy.
In the second Then By list, select Logged Variable.
Click OK. The Signal Browser table groups the signal data by model and then by the logged variables.
To remove the hierarchy and display a simple list of logged signals, you can select None in the Group Signals dialog box.
To rename a run name:
If the Signal Browser table is not grouped by run, right-click the table and in the menu select Group By > Run.
Double-click the Run row.
Type the new run name and press Enter.
Click in the Line column of a signal.
Specify the color, Line Style, and Marker for the signal.
In the Signal Browser table, right-click a run or signal for a menu list of options.
|Display the list of Column options. See Column Options for the Inspect Signals and Compare Signals Tabs||Columns|
|Group signal data by the specified options: Run, Block Path, Data Source, Model, and Signal Name (this option does not appear in the Compare Runs tab)||Group By|
|Highlight the source of the selected signal in the model diagram||Highlight signal source in model|
|Open the Variable Editor and display the selected signal data||Export signal to variable editor|
|Save signal data in the run to the base workspace||Export run to base workspace|
|Delete the highlighted signal in the Signal Browser table (this option does not appear in the Compare Runs tab)||Delete|
|Display the signal properties of the selected signal||Properties|
The Properties dialog box displays the following signal information.
In the Signal Browser table, right-click a run name to view a list of options. To open the Run Properties dialog box, from the options list, select Properties.
To modify a plot, you can:
Toolbar: Select icons to zoom into data, move the plot, or add a data point to the plot. For more information on these icons, see the Toolbar section.
Plot options: Click on the plot to select alternatives for plotting the data.
|To...||Simulation Data Inspector...|
|Original Axes||Plots the data according to the maximum and minimum values of the data points. (default)|
|Normalized Axes||Normalizes the data for each signal from —1 to 1 along the y-axis. If the data is already within that range, the data is displayed as a constant at 1.|
|Stairstep||Plots the data as a stairstep plot. (default)|
|Line||Interpolates the data points and produces a linear plot.|
|Plot in New Figure||Launches the graph in a MATLAB® figure window.|
New figure: Click on the plot and select Plot in New Figure. The plot opens in a new figure window.
For more information on plotting and customizing your data plots using the GUI tools, see Figures, Plots, and Graphs.
To view an example, see Create, Save, and Print a Figure.
The toolbar contains the following command buttons.
|Clear the Simulation Data Inspector of all data.|
|Open a MAT-file previously saved from the Simulation Data Inspector.||Open|
|Save data in Simulation Data Inspector to a MAT-file.|
|Open the Import Data tool.|
|Mark a run to overwrite on the next simulation/record.|
|Configure appending new runs to the top or bottom of the run list. Specify a run naming rule.|
|Zoom in along the time axis. After selecting the icon, on the graph, click and hold the left mouse button and drag the mouse to select an area to enlarge.|
Zoom in T
|Zoom in along the data value axis. After selecting the icon, on the graph, click and hold the left mouse button and drag the mouse to select an area to enlarge.|
Zoom in T
|Zoom in on a section of the graph along both axes. After selecting the icon, on the graph, click and hold the left mouse button, and drag the mouse to select an area to enlarge.|
Zoom in T and Y
|Zoom out from the graph. After selecting the icon, click the graph to incrementally zoom out.|
|Fit the plot to the graph. After selecting the icon, click the graph to enlarge the plot to fill the graph.|
Fit to View
|Move the plot in the graph up, down, left, or right. After selecting the icon, on the graph, click and hold the left mouse button and move the mouse to the area of the graph that you want to view.|
|Display the T and Y values of a data point in the plot. After selecting the icon, click a point on the line to view a data point.|