Single simulation output
Option to return simulation results as single
Model Configuration Pane: Data Import/Export
By default, when you simulate a model, simulation results are returned as a single
Simulink.SimulationOutput object that contains complete simulation
metadata and all simulation data logged to the workspace. Using the single-output format
makes processing results from several simulations easier and provides better support for
parallel and batch simulations. When you return results as a single simulation output,
the syntax to simulate a model programmatically is the same for the
All simulation data logged to the workspace is returned as a single
Simulink.SimulationOutputobject. By default, the name of the variable that stores the
out. To use a different variable name, specify a valid MATLAB® variable name in the text box.
When you simulate a model programmatically, the name you specify in the text box does not determine the name of the variable that stores the
SimulationOutputobject is stored in the variable to which you assign the return argument. For example, for this simulation, the
SimulationOutputobject variable name is
simOut = sim(simIn);
Logged simulation results are returned as one or more variables, depending on the logging options configured in the model.
When you simulate the model using a syntax of the
simfunction that returns multiple output arguments, the
simfunction does not return the logging variables. The logging variables are available in the workspace after the simulation completes. Syntaxes of the
simfunction that return multiple arguments are not recommended.
Simulating a model creates one or more
Simulink.SimulationOutputobjects in any of these situations, even when you disable Single simulation output:
You run a set of simulations using the Multiple Simulations pane.
You simulate the model programmatically using one or more
You simulate the model using a
simfunction syntax that returns results as a single simulation output.
For more information, see
When you log data using the To File block, the data logs to the specified file and does not appear in the single
When you select Log Dataset data to file, the data that logs to the MAT file is not included in the single
Enabling fast restart enables the Single simulation output parameter.
whofunction for the
Simulink.SimulationOutputobject to view a list of the variables in the object.
To use the Logging intervals parameter, you must select Single simulation output.
The table summarizes recommended values for this parameter based on considerations related to code generation.
|Type: string | character vector|
|Value: valid MATLAB variable name|
Introduced in R2009b