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 your data from the Simulation Data Inspector.

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:

  1. Hover over the save icon on the left side bar. Then, click Save As.

  2. Name the file.

  3. 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 selecting None, but provides a faster save time than Normal.

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 reflect 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 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:

  1. Click the layout button .

  2. Click Save current view.

  3. In the dialog box, specify a name for the view and browse to the location where you want to save the MLDATX-file.

  4. Click Save.

To load a view:

  1. Click the layout button .

  2. Click Open saved view.

  3. 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 a 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:

  1. Click the create report icon on the left side bar.

  2. Under Include in report, specify the type of report you want to create.

    • Select Inspect Signals to include the plots and signals from the Inspect pane.

    • Select Compare Runs 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.

  3. Specify a File name for the report, and navigate to the Folder where you want to save the report.

  4. Click Create Report.

    The generated report automatically opens in your default browser.

Export Data from the Simulation Data Inspector

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 the plotting area do not affect whether a signal is exported.

When you export a single signal, the signal is stored in timeseries format in the workspace variable or MAT-file. Exported data for a run or multiple signals is stored in Simulink.SimulationData.Dataset format.

Note

When you export a run that contains logged parameter data, the exported Simulink.SimulationData.Dataset contains a Simulink.SimulationData.Parameter element for each logged parameter.

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 in timeseries format, and runs or multiple signals are stored in Simulink.SimulationData.Dataset format. When you export data to a Microsoft Excel file, the data is stored in the format described in Microsoft Excel Import and Export 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.

Related Topics

Simulink Documentation

Support