represents simulation data from functions such as SystemModelSimulate etc.


  • SystemModelSimulationData is generated by functions such as SystemModelSimulate and SystemModelSimulateSensitivity and provides ways of summarizing, exploring and extracting results.
  • SystemModelSimulationData[]["Properties"] gives a list of possible properties.
  • Properties of simulation data are obtained from SystemModelSimulationData[]["property"].
  • For simulations with dynamic graphics, sim["Diagram",t] returns Graphics at time t.
  • Dynamic graphics for component "c1.c2..." are shown with sim["Diagram",{"c1","c2",},t].
  • Properties of the simulated model: »
  • "Descriptions"variable and parameter descriptions
    "Model"SystemModel object of the simulated model
    "ModelName"fully qualified name of the model
    "ParameterNames"parameter variables in the model
    "PlotNames"names of plots in model
    "StateVariables"continuous state variables in the model
    "VariableNames"dependent variables in the model
  • For variable and parameter lists, SystemModelSimulationData[][{property,patt}] returns the elements of property whose names match the string pattern patt.
  • Properties specific to the simulation: »
  • "SimulationInterval"simulation interval {tmin,tmax}
    "SimulationLength"simulation length tmax-tmin
    "NumberOfEvents"number of events in the simulation
    "Events"time points where events occurred
    "Samples"time points when variables were sampled
  • Properties related to values of variables and parameters: »
  • {"v1","v2",}simulation for v1, v2,
    {"p1","p2",}parameter value for p1, p2,
    "RawData",{"v1","v2"}time-value pairs for v1, v2,
  • Simulation results for variables "vi" are returned as functions that can be evaluated for any time t. »
  • Simulation results from SystemModelSimulationData object sim can be evaluated at a point t with sim[{"v1","v2",},t].
  • In sim["RawData",{"v1",}] events are indicated by duplicate time-value pairs at the same time point.
  • Variables "vi" and parameters "pi" are given using strings.
  • Complete lists of simulation results and parameter values: »
  • "VariableValues"simulations {"v1"->f1,}
    "ParameterValues"parameters {"p1"->c1,}
  • Lists of simulation results from sim can be evaluated at a point t with sim["VariableValues",t].
  • Variables depend on parameters vi[t,pj]; the sensitivity of a variable to a parameter pj is the partial derivative pjvi[t,pj]. Sensitivities can be computed using SystemModelSimulateSensitivity. »
  • Sensitivities can be accessed using {{vi,pi},}.
  • Properties related to sensitivities include:
  • "SensitivityNames"variable parameter sensitivities
    "SensitivityValues"sensitivities {{vi,pi}->gi,j,}
  • The option TargetUnits controls the unit of simulation results:
  • Noneno unit (default)
    "Unit"unit defined in model
    "DisplayUnit"display unit defined in model


open allclose all

Basic Examples  (1)

Simulate a model:

Click for copyable input

Get all variable names in the model:

Click for copyable input

Get the trajectory of one variable:

Click for copyable input

Get trajectories for all variables:

Click for copyable input

Show the simulation interval:

Click for copyable input

Scope  (20)

Applications  (9)

Properties & Relations  (1)

See Also

SystemModelSimulate  SystemModelPlot  SystemModelSimulateSensitivity


Introduced in 2018