The Simulation Data Inspector compares the data and metadata for runs and individual signals. You can analyze comparison results with the difference plot and tolerance features. You can control the comparison through comparison settings. For more information on the comparison settings, see How the Simulation Data Inspector Compares Data. This example builds on and uses data generated in Inspect Simulation Data.
This example continues from Inspect Simulation Data. You can also use this script to generate the data required for the example.
% Load system load_system('slexAircraftExample') % Configure signals to log Simulink.sdi.markSignalForStreaming('slexAircraftExample/Pilot', 1, 'on') Simulink.sdi.markSignalForStreaming('slexAircraftExample/Aircraft Dynamics Model', 3, 'on') Simulink.sdi.markSignalForStreaming('slexAircraftExample/Aircraft Dynamics Model', 4, 'on') % Change Pilot signal to sine set_param('slexAircraftExample/Pilot', 'WaveForm', 'sine') % Simulate model sim('slexAircraftExample') % Change Pilog signal to square set_param('slexAircraftExample/Pilot', 'WaveForm', 'square') % Simulate Model sim('slexAircraftExample')
You can compare signals to analyze the relationship between your model's inputs and
outputs. For example, compare the
Stick input signal to the output
alpha, rad. Then, specify tolerance values to analyze the
To compare the
alpha, rad signal to the
Navigate to the Compare pane.
To view a list of signals available for comparison, click the Baseline text box, and select Signals.
Stick (Run 1: slexAircraftExample).
Click the Compare to text box, and select Signals.
alpha, rad (Run 1: slexAircraftExample).
Alternatively, you can select the Baseline and Compare to signals through the context menu when you right-click a signal in the Inspect pane.
alpha, rad and
Stick signals are
Run 1. The signals do not match within the absolute,
relative, and time tolerances, all set to 0 by default.
From a visual inspection of the signals, you can see
Stick. Add a time tolerance to the
to account for the lag.
0.5 into the Time Tolerance field of the
properties pane to the left of the graphical viewing area. When you specify a tolerance
for a Baseline signal, its Override Global
Tolerance field automatically changes to
yes. When you
click away from the Time Tolerance field of the signal properties,
the comparison runs again, using the signal-level tolerance you specified. If you want to
use global tolerance values for the signal, click the Override Global
Tolerance field and select
no from the drop-down.
The Simulation Data Inspector draws the tolerance band around the plotted Baseline signal and around the signed difference signal displayed in the bottom subplot. The bar along the top of the difference plot shows pass and out of tolerance regions for the comparison in green and red.
The Simulation Data Inspector draws the tolerance region with the most lenient interpretation of the specified tolerances for each point. For more information on how the Simulation Data Inspector calculates the tolerance band, see Tolerance Specification.
The time tolerance covers the phase difference between the two signals, but the comparison still does not pass due to the amplitude difference. You can add a magnitude tolerance as either an Absolute Tolerance or a Relative Tolerance.
To add an absolute tolerance to the
Stick signal, enter
0.05 into the Absolute Tolerance field in the
properties pane. With the combination of the absolute and time tolerances, the signal
You can also use the Simulation Data Inspector to compare all logged signals in a model at once by comparing runs. Run comparisons provide useful information about the effects of changing model parameters. For example, change the frequency cutoff of the filter for the control stick input signal. Then, evaluate the effect on the output signal with the Simulation Data Inspector.
Click the Model Explorer button to access the Model Workspace variables.
Change the value of
Ts in the Model
1 and close
the Model Explorer.
Simulate the model with the new filter.
On the Compare pane in the Simulation Data Inspector, click the Baseline text box, and select Runs.
From the list of runs, select
Click the Compare to text box, and select Runs.
Run 3: slexAircraftExample and click
The Compare pane lists all signals from the runs with a comparison result. In this example, the comparison results of the aligned signals do not match. The signal differences are not within the specified tolerance values, all of which are set to zero.
The Simulation Data Inspector only compares signals from the Baseline run that align with a signal from the Compare To run. If a signal from the Baseline run does not align with a signal from the Compare To run, the signal is listed in the Compare pane with a warning. . For more information on signal alignment, see Signal Alignment.
To plot comparison data, select the signal you want to see in the
Compare pane. Here, the top plot shows the
rad/sec signals from the Baseline and Compare
To runs. The bottom plot shows the difference between the signals and a
graphical representation of the tolerance.
To qualify signals in the run comparison, you can add global tolerances to the
comparison using the global tolerance fields above the graphical viewing area. Enter one
or more desired tolerance values, and click Compare to run the
comparison again with the new tolerance values. Change the Global Time
0.75 and the Global Abs
0.075, and run the comparison. The Simulation
Data Inspector draws the tolerance band around the Baseline signal
and on the signed difference plot on the lower half of the graphical viewing area. With
the new tolerance values, the
signals pass the comparison.
alpha, rad signal to analyze the comparison's out of
tolerance regions. Click the arrow buttons in the tool strip to navigate through the comparison's out of
tolerance regions. Two cursors on the plot show the beginning and end of the first out of
tolerance region. You can use your keyboard arrows to explore the signal and tolerance
values throughout each out of tolerance region. To view the next out of tolerance region,
click the right arrow button in the tool strip.
To resolve the out of tolerance regions, you can choose to modify the global tolerance
values or to add a signal specific tolerance to the
alpha, rad signal
using the signal properties.