Main Content

单一仿真输出

用于将仿真结果作为单个 Simulink.SimulationOutput 对象返回的选项

模型配置窗格: 数据导入/导出

描述

默认情况下，当您仿真一个模型时，仿真结果以单个 Simulink.SimulationOutput 对象形式返回，该对象包含完整的仿真元数据和工作区中记录的所有仿真数据。使用单一输出格式可以更轻松地处理多个仿真的结果，并为并行和批量仿真提供更好的支持。当您将结果作为单一仿真输出返回时，以编程方式仿真模型的语法对于 sim、parsim 和 batchsim 函数是相同的。

设置

on (默认) | off
on

记录到工作区的所有仿真数据以单个 Simulink.SimulationOutput 对象形式返回。默认情况下，存储 SimulationOutput 对象的变量的名称是 out。要使用不同变量名称，请在文本框中指定有效的 MATLAB® 变量名称。

以编程方式仿真模型时，您在文本框中指定的名称不能确定存储 SimulationOutput 对象的变量的名称。SimulationOutput 对象存储在您为其赋予返回参量的变量中。例如，对于此仿真，SimulationOutput 对象变量名称为 simOut。

simOut = sim(simIn);

off

记录的仿真结果以一个或多个变量形式返回，具体取决于模型中配置的记录选项。

当您使用返回多个输出参量的 sim 函数的语法仿真模型时，sim 函数不会返回记录变量。在仿真完成后，记录变量在工作区中可用。不推荐使用返回多个参量的 sim 函数的语法。

即使禁用单一仿真输出，仿真模型也会在上述任何情况下创建一个或多个 Simulink.SimulationOutput 对象：

  • 您可以使用多个仿真窗格运行一组仿真。

  • 您可以使用一个或多个 Simulink.SimulationInput 对象以编程方式对模型进行仿真。

    使用 sim、parsim 和 batchsim 函数运行仿真时，您可以使用 SimulationInput 对象配置仿真。

  • 使用 sim 函数语法仿真模型，该语法将结果以单个仿真输出形式返回。

    有关详细信息，请参阅 sim。

提示

  • 使用 To File 模块记录数据时，数据会记录到指定的文件中，而不会出现在单个 Simulink.SimulationOutput 对象中。

  • 当您选择将数据集数据记录到文件时，记录到 MAT 文件的数据不会包含在单个 Simulink.SimulationOutput 对象中。

  • 启用快速重启会启用单一仿真输出参数。

  • 对 Simulink.SimulationOutput 对象使用 who 函数可以查看该对象中变量的列表。

  • 要使用记录间隔参数，您必须选择单一仿真输出。

推荐的设置

此表根据与代码生成相关的注意事项总结此参数的建议值。

应用场景设置
调试无影响
可追溯性无影响
效率

无建议

安全预警

无建议

编程用法

参数：ReturnWorkspaceOutputs
值：'on' | 'off'
默认值：'on'
参数：ReturnWorkspaceOutputsName
类型：字符串 | 字符向量
值：有效的 MATLAB 变量名称
默认值：'out'

版本历史记录

在 R2009b 中推出

另请参阅

对象

函数

主题