Save and Share Simulation Data Inspector Data and Views
After you inspect, analyze, or compare your data in the Simulation Data Inspector, you can share your results with others. The Simulation Data Inspector provides several options for sharing and saving your data and results, depending on your needs. With the Simulation Data Inspector, you can:
Save your data and layout modifications in a Simulation Data Inspector session.
Share your layout modifications in a Simulation Data Inspector view.
Share images and figures of plots you create in the Simulation Data Inspector.
Create a Simulation Data Inspector report.
Export data to the workspace.
Export data to a file.
Save and Load Simulation Data Inspector Sessions
If you want to save or share data along with a configured view in the Simulation Data Inspector, save your data and settings in a Simulation Data Inspector session. You can save sessions as MAT- or MLDATX-files. The default format is MLDATX. When you save a Simulation Data Inspector session, the session file contains:
All runs, data, and properties from the Inspect pane, including which run is the current run and which runs are in the archive.
Plot display selection for signals in the Inspect pane.
Subplot layout and line style and color selections.
Note
Comparison results and global tolerances are not saved in Simulation Data Inspector sessions.
To save a Simulation Data Inspector session:
Hover over the save icon on the left side bar. Then, click Save As.
Name the file.
Browse to the location where you want to save the session, and click Save.
For large datasets, a status overlay in the bottom right of the graphical viewing area displays information about the progress of the save operation and allows you to cancel the save operation.
The Save tab of the Simulation Data Inspector preferences menu on the left side bar allows you to configure options related to save operations for MLDATX-files. You can set a limit as low as 50MB on the amount of memory used for the save operation. You can also select one of three Compression options:
None
, the default, applies no compression during the save operation.Normal
creates the smallest file size.Fastest
creates a smaller file size than you would get by selectingNone
, but provides a faster save time thanNormal
.
To load a Simulation Data Inspector session, click the open icon on the left side bar. Then, browse to select the MLDATX-file you
want to open, and click Open.
Alternatively, you can double-click the MLDATX-file. MATLAB® and the Simulation Data Inspector open if they are not already open.
When the Simulation Data Inspector already contains runs and you open a session, all of the runs in the session move to the archive. The view updates to show plotted signals from the session file. You can drag runs between the work area and archive as desired.
When the Simulation Data Inspector does not contain runs and you open a session, the Simulation Data Inspector puts runs in the work area and archive as specified in the file.
Share Simulation Data Inspector Views
When you have different sets of data that you want to visualize the same way, you can save a view. A view saves the layout and appearance characteristics of the Simulation Data Inspector without saving the data. Specifically, a view saves:
Plot visualization type, layout, axis ranges, linking characteristics, and normalized axes
Location of signals in the plots, including plotted signals in the archive
Signal grouping and columns on display in the Inspect pane
Signal color and line styling
To save a view:
Click Visualizations and layouts
.
In Saved Views, click Save current view.
In the dialog box, specify a name for the view and browse to the location where you want to save the MLDATX-file.
Click Save.
To load a view:
Click Visualizations and layouts
.
In Saved Views, click Open saved view.
Browse to the view you would like to load, and click Open.
Share Simulation Data Inspector Plots
Use the snapshot feature to share the plots you generate in the Simulation Data Inspector. You can export your plots to the clipboard to paste into a document, as an image file, or to a MATLAB figure. You can choose to capture the entire plot area, including all subplots in the plot area, or to capture only the selected subplot.
Click the camera icon on the toolbar to access the snapshot menu. Use the
radio buttons to select the area you want to share and how you want to share the plot.
After you make your selections, click Snapshot to export the plot.
If you create an image, select where you would like to save the image in the file browser.
You can create snapshots of your plots in the Simulation Data Inspector programmatically using Simulink.sdi.snapshot
.
Create Simulation Data Inspector Report
To generate documentation of your results quickly, create a Simulation Data Inspector report. You can create a report of your data in either the Inspect or the Compare pane. The report is an HTML file that includes information about all the signals and plots in the active pane. The report includes all signal information displayed in the signal table in the navigation pane. For more information about configuring the table, see Inspect Metadata.
To generate a Simulation Data Inspector Report:
Click the create report icon
on the left bar.
Specify the type of report you want to create.
Select Inspect to include the plots and signals from the Inspect pane.
Select Compare to include the data and plots from the Compare pane. When you generate a Compare Runs report, you can choose to Report only mismatched signals or to Report all signals. If you select Report only mismatched signals, the report shows only signal comparisons that are not within the specified tolerances.
Specify a File name for the report, and navigate to the Folder where you want to save the report.
Click Create Report.
The generated report automatically opens in your default browser.
Export Data to the Workspace or a File
You can use the Simulation Data Inspector to export data to the base workspace, a MAT file, or a Microsoft® Excel® file. You can export a selection of runs and signals, runs in the work area, or all runs in the Inspect pane, including the Archive.
When you export a selection of runs and signals, make the selection of data to export before
clicking the export button .
Only the selected runs and signals are exported. In this example, only the
x1
signals from Run 1 and Run 2 are exported. The check box
selections for plotting data do not affect whether a signal is exported.
When you export a single signal to the workspace or a MAT file, the signal is exported to a
timeseries
object. Data exported to the workspace or a MAT file
for a run or multiple signals is stored as a
Simulink.SimulationData.Dataset
object.
To export data to a file, select the File option in the
Export dialog. You can specify a file name and browse to the
location where you want to save the exported file. When you export data to a MAT file, a
single exported signal is stored as a timeseries
object, and runs or
multiple signals are stored as a Simulink.SimulationData.Dataset
object.
When you export data to a Microsoft
Excel file, the data is stored using the format described in Microsoft Excel Import, Export, and Logging Format.
To export to a Microsoft Excel file, select the XLSX extension from the drop-down. When you export data to a Microsoft Excel file, you can specify additional options for the format of the data in the exported file. If the file name you provided already exists, you can choose to overwrite the entire file or to only overwrite sheets containing data that corresponds to the exported data. You can also choose which metadata to include and whether signals with identical time data share a time column in the exported file.
Export Video Signal to an MP4 File
You can export a 2D or 3D signal that contains RGB or monochrome video data to an MP4 file using the Simulation Data Inspector. For example, when you log a video signal in a simulation, you can export the data to an MP4 file and view the video using a video player. To export a video signal to an MP4 file:
Select the signal you want to export.
Click Export
in the toolbar on the left or right-click the signal and select Export.
In the Export dialog box, choose to export Selected runs and signals to a file.
Specify a file name and the path to the location where you want to save the file.
Select
MP4 video file
from the list and click Export.
For the option to export to an MP4 file to be available:
You must export only one signal at a time.
The selected signal must be 2D or 3D and contain RGB or monochrome video data.
The selected signal must be represented in the Simulation Data Inspector as a single signal with multidimensional sample values.
You may need to convert the signal representation before exporting the signal data. For more information, see Analyze Multidimensional Signal Data.
The data type for the signal values must be
double
,single
, oruint8
.
Exporting a video signal to an MP4 file is not supported for Linux® operating systems.