States
Description
Saves state data to the specified variable in the MATLAB® workspace during simulation.
Category: Data Import/Export
Settings
Default: Off, xout
On Log state data to the MATLAB workspace during simulation.
Specify the name of the variable used to store states data. See State Information for more information.
OffDo not log state data during simulation.
Tips
Specify the format for the logged states data using the Format parameter.
To log fixed-point states data, log states data using the
Datasetformat.When you log states data using the
Datasetformat, states data streams to the Simulation Data Inspector during simulation.Datasetformat does not support:Rapid accelerator simulation
Logging states information inside a function-call subsystem
Code generation
The state logging variable is empty when you enable states logging for a model that has no states.
If you log states data in a format other than
Dataset, you can convert the logged data toDatasetformat. Converting the data toDatasetmakes it easier to post process with other logged data. For more information, see Dataset Conversion for Logged Data.If you log states data in
Arrayformat while also logging time or inStructure with timeformat, check the Record logged workspace data in Simulation Data Inspector parameter to view the data in the Simulation Data Inspector after simulation.
Command-Line Information
Parameter: SaveState |
Value: 'on' | 'off' |
Default: 'off' |
Parameter: StateSaveName |
| Type: character vector |
| Value: any valid value |
Default: 'xout' |
Recommended Settings
| Application | Setting |
|---|---|
| Debugging | No impact |
| Traceability | No impact |
| Efficiency | No recommendation |
| Safety precaution | No recommendation |