Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

Simulink.SimulationOutput

访问仿真结果

说明

Simulink.SimulationOutput 对象包括所有记录的仿真数据和说明仿真条件的 SimulationMetadata 对象。Simulink.SimulationOutput 对象还包含关于仿真、仿真运行时间的有用元数据。您可以使用 Simulink.SimulationOutput 对象来检查仿真结果,也可以使用 Simulink.SimulationOutput 对象上的 plot 函数来可视化结果。对于使用 Simulink 中的 RunStep Forward 按钮调用的仿真,Simulink.SimulationOutput 对象存储在基础工作区中,其名称在模型参数中指定。Simulink.SimulationOutput 是可写的。

创建对象

默认情况下,您运行的每个仿真都会创建一个 Simulink.SimulationOutput 对象,其中包含仿真中记录的所有数据;以及一个 Simulink.SimulationMetadata 对象,其中包含仿真元数据。您可以通过多种方式访问 SimulationOutput 对象。

  • Simulink.SimulationOutput 对象返回记录的仿真数据。

  • 也可以使用 whogetfind 方法来访问输出变量名称及其各自的值。

Configuration Parameters 中,模型设置 Single simulation output 控制是在 Simulink.SimulationOutput 对象中返回仿真输出,还是在基础工作区中展开数据。您也可以在 sim 命令中以名称-值参数对组形式将 ReturnWorkspaceOutputs 设置为 on,使用命令行 API 来实现此行为。

属性

全部展开

用于仿真的元数据,以 Simulink.SimulationMetadata 对象形式返回。除 UserDataUserString 之外的字段都是只读字段。

此属性是只读的。

仿真记录错误消息以字符向量形式返回。当仿真运行没有错误时,ErrorMessage 属性为空。

对象函数

find Access and display values of simulation results
get 访问和显示仿真结果的值
getSimulationMetadataReturn SimulationMetadata object for simulation
setUserDataStore custom data in SimulationMetadata object that SimulationOutput object contains
setUserStringStore custom character vector in SimulationMetadata object in SimulationOutput object
who Access and display output variable names of simulation
plotPlot simulation output data in the Simulation Data Inspector

示例

全部折叠

对模型进行仿真,将 Simulink.SimulationOutput 对象的结果放在 simOut 中,然后查看仿真元数据。

仿真 vdp 模型。

simOut = sim('vdp','SaveState','on','StateSaveName','xoutNew',...
                     'SaveOutput','on','OutputSaveName','youtNew')
 Simulink.SimulationOutput:

                xoutNew: [65x2 double] 
                youtNew: [65x2 double] 

     SimulationMetadata: [1x1 Simulink.SimulationMetadata] 
           ErrorMessage: [0x0 char] 

获取变量 youtNew 的值。

simOut.youtNew

Simulink® 返回并显示值。

获取仿真的时间信息。

myMetadata = simOut.SimulationMetadata
myMetadata = 

  SimulationMetadata with properties:

        ModelInfo: [1×1 struct]
       TimingInfo: [1×1 struct]
    ExecutionInfo: [1×1 struct]
       UserString: ''
         UserData: []
myMetadata.TimingInfo
ans = 

  struct with fields:

          WallClockTimestampStart: '2016-12-30 08:47:51.739935'
           WallClockTimestampStop: '2016-12-30 08:47:58.185579'
    InitializationElapsedWallTime: 5.9166
         ExecutionElapsedWallTime: 0.1910
       TerminationElapsedWallTime: 0.3380
             TotalElapsedWallTime: 6.4456
在 R2010a 中推出