Main Content

Simulink.sdi.loadView

Load a view file to visualize data in the Simulation Data Inspector

Description

Simulink.sdi.loadView(filename) applies the visualization information in the view file, filename, to the data in the Simulation Data Inspector.

A view contains information about the layout and plots in the graphical viewing area as well as properties of plotted signals. When you load a view, the Simulation Data Inspector uses the properties and preferences in the file to display data currently in the Simulation Data Inspector. Signals in the Simulation Data Inspector align with the signals in the view according to these properties, in order:

  1. Block path

  2. Signal ID

  3. Signal name

Aligned signals are plotted in the graphical viewing area. Use a view to apply a consistent set of visualization settings to multiple sets of similar data.

The view file includes the following information:

  • Subplot layout and visualization type

  • Settings for each visualization type in the layout

  • Signal selection mode

  • Replay controls visibility

  • Metadata displayed in the work area

  • Settings for signal grouping in the work area

  • Plotted signals and the line style and color for each plotted signal

A view file does not contain data. To load a session file that contains data and visualization information, use the Simulink.sdi.load function.

example

Examples

collapse all

This example visualizes the output from the vdp model, saves the configuration as a view, and then uses the view to visualize the output from another simulation of the same model.

To generate data to plot in the Simulation Data Inspector, simulate the model.

mdl = "vdp";
open_system(mdl)
set_param("vdp/Mu","Gain","1")
sim(mdl);

Programmatically Configure and Save a View

The vdp model is configured to log two signals, x1 and x2. Plot each signal on a subplot in a 2-by-1 layout.

Simulink.sdi.setSubPlotLayout(2,1)

To plot one signal on each subplot, first access the Simulink.sdi.Run object for the simulation.

runIDs = Simulink.sdi.getAllRunIDs;
vdpRunID = runIDs(end);
vdpRun = Simulink.sdi.getRun(vdpRunID);

Then, you can access the data for each signal in a Simulink.sdi.Signal object and use the plotOnSubPlot function to specify where to plot each signal.

x1 = getSignalByIndex(vdpRun,1);
x2 = getSignalByIndex(vdpRun,2);

plotOnSubPlot(x1,1,1,true)
plotOnSubPlot(x2,2,1,true)

View the result in the Simulation Data Inspector.

Simulink.sdi.view

The x1 and x2 signal plotted in the Simulation Data Inspector.

Then, save the view.

Simulink.sdi.saveView("vdpView.mldatx")

Use the View

To mimic a situation where the Simulation Data Inspector is configured differently and contains data from another simulation, this example clears data from the Simulation Data Inspector, loads a view that represents the default visualization configuration, and runs another simulation of the vdp model.

Simulink.sdi.clear
Simulink.sdi.loadView("default.mldatx");
set_param("vdp/Mu","Gain","2")
sim("vdp");

Use the Simulink.sdi.loadView function to apply the saved view from the previous simulation.

Simulink.sdi.loadView("vdpView.mldatx")

You can open the Simulation Data Inspector to view the results using the Simulink.sdi.view function. The saved view includes information regarding the axes limits. When you use a view to apply visualization settings, you may need to adjust axes limits or zoom levels to fit data from a modified simulation.

The x1 and x2 signal plotted in the Simulation Data Inspector using a saved view.

Input Arguments

collapse all

Name of the view file, specified as a string or character vector. You can specify filename as only the file name when the file is on the MATLAB® path, or you can specify a full path to the file.

Example: 'myView.mldatx'

Data Types: char | string

Version History

Introduced in R2019b