本页对应的英文页面已更新，但尚未翻译。若要查看最新内容，请点击此处访问英文页面。

parsim

以并行或串行方式进行多次动态系统仿真

全页折叠

语法

simOut = parsim(in)

simOut = parsim(in,'ShowSimulationManager','on')

simOut = parsim(in,Name,Value,...NameN,ValueN)

说明

simOut = parsim(in) 使用 SimulationInput 对象 in 中指定的输入对模型进行仿真。parsim 命令使用 SimulationInput 对象的数组来运行多个仿真。

simOut = parsim(in,'ShowSimulationManager','on') 使用 SimulationInput 对象中指定的输入对模型进行并行仿真，并打开 Simulation Manager UI。有关详细信息，请参阅 Simulation Manager。

simOut = parsim(in,Name,Value,...NameN,ValueN) 使用 SimulationInput 对象中指定的输入和指定为 Name,Value 对组的选项对模型进行并行仿真。

parsim 命令使用 Parallel Computing Toolbox™ 许可证以并行方式运行仿真。如果无法创建并行池，或者未使用 Parallel Computing Toolbox，则 parsim 以串行方式运行仿真。

示例

全部折叠

使用 parsim 以并行方式仿真模型

打开脚本

通过扫描变量以并行方式仿真模型 CSTR。执行扫描时，使用了 SimulationInput 对象的数组。

指定扫描值。

FeedTempSweep = 250:10:300;

创建 SimulationInput 对象的数组。

for i = length(FeedTempSweep):-1:1;
in(i) = Simulink.SimulationInput('CSTR');
in(i) = in(i).setVariable('FeedTemp0',FeedTempSweep(i));
end

以并行方式仿真模型。

out = parsim(in, 'ShowProgress', 'on')

[08-Jan-2018 14:10:43] Checking for availability of parallel pool...
Starting parallel pool (parpool) using the 'local' profile ...
connected to 6 workers.
[08-Jan-2018 14:11:12] Loading Simulink on parallel workers...
[08-Jan-2018 14:11:40] Configuring simulation cache folder on parallel workers...
[08-Jan-2018 14:11:40] Loading model on parallel workers...
[08-Jan-2018 14:11:48] Running simulations...
[08-Jan-2018 14:12:04] Completed 1 of 6 simulation runs
[08-Jan-2018 14:12:04] Completed 2 of 6 simulation runs
[08-Jan-2018 14:12:04] Completed 3 of 6 simulation runs
[08-Jan-2018 14:12:08] Completed 4 of 6 simulation runs
[08-Jan-2018 14:12:09] Completed 5 of 6 simulation runs
[08-Jan-2018 14:12:09] Completed 6 of 6 simulation runs
[08-Jan-2018 14:12:09] Cleaning up parallel workers...

out = 

1x6 Simulink.SimulationOutput array

在 Rapid Accelerator 模式下使用 `parsim`

在 Rapid Accelerator 模式下仿真模型 vdp。

加载模型。

model = 'vdp';
load_system(model)

此步骤构建 Rapid Accelerator 目标

Simulink.BlockDiagram.buildRapidAcceleratorTarget(model);

创建 SimulationInput 对象并使用 setModelParameter 方法将 RapidAcceleratorUpToDateCheck 设置为 'off'。

in = in.setModelParameter('SimulationMode', 'rapid-accelerator');
in = in.setModelParameter('RapidAcceleratorUpToDateCheck', 'off');

对模型进行仿真。

out = parsim(in)

输入参数

全部折叠

`in` - 用于对模型进行仿真的 `Simulink.SimulationInput` 对象
对象、数组

用于在仿真中指定对模型所作更改的 Simulink.SimulationInput 对象或 Simulink.SimulationInput 对象的数组。

示例： in = Simulink.SimulationInput('vdp')

名称-值对组参数

示例： 'ShowProgress', 'on'

注意

传递给 parsim 命令的所有参数与 sim 命令使用的参数无关。向 parsim 命令传递下列输入参数列表。

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称，Value 为对应的值。Name 和 Value 必须显示在单引号 (' ') 内。您可采用任意顺序指定多个名称-值对组参数，如 Name1,Value1,...,NameN,ValueN。

`'AttachedFiles'` - 要附加到并行池的文件
元胞数组

指定为要附加到并行池的其他文件的元胞数组。

`'ShowProgress'` - 显示仿真的进度
'on'（默认值） | 'off'

设置为 'on'，以在命令行窗口中查看仿真的进度。当设置为 'off' 时，进度将隐藏。

注意

当显示进度时，可能会在最后几次仿真完成之前显示 'Cleaning up parallel workers..' 消息。此消息出现与否并不取决于仿真是否完成。只有当仿真从 future 获取到输出结果时，仿真才真正完成。有关详细信息，请参阅 Simulink.Simulation.Future。

`'RunInBackground'` - 在后台运行仿真
'off' （默认） | 'on'

设置为 'on' 将以异步方式运行仿真，从而保持 MATLAB^® 命令提示符可用。

`'SetupFcn'` - 对每个工作进程运行一次的函数句柄
函数句柄

在开始仿真之前，将 function handle 指定为 'SetupFcn' 以对每个工作进程运行一次。

示例： 'SetupFcn',@()simulinkproject('OCRAex/OCRA_example.prj')

注意

当在 SetupFcn 中使用 buildRapidAcceleratorTarget 并且对模型指定了外部输入时，请将 'LoadExternalInput' 设置为 'off' 或确保指定的外部输入在工作进程上可用，以防出现编译错误。

`'CleanupFcn'` - 运行仿真后对每个工作进程运行一次的函数句柄
函数句柄

将 function handle 指定为 'CleanupFcn' 以在仿真完成后对每个工作进程运行一次。

`'ManageDependencies'` - 管理模型依存关系
'on' （默认） | 'off'

当 ManageDependencies 设置为 on 时，会在需要时自动向并行工作进程发送模型依存关系。如果将 ManageDependencies 设置为 off，则将模型依存关系显式附加到并行池。

`'UseFastRestart'` - 使用快速重启
'off' （默认） | 'on'

当 UseFastRestart 设置为 true 时，仿真使用快速重新启动在工作进程上运行。

注意

使用 parsim 时，请使用 UseFastRestart 选项，而不使用 FastRestart 选项。有关详细信息，请参阅Get Started with Fast Restart。

`'TransferBaseWorkspaceVariables'` - 将变量传递给并行工作进程
'off' （默认） | 'on'

当 TransferBaseWorkspaceVariables 设置为 true 时，在模型中使用并在基础工作区中定义的变量将传输给并行工作进程。

注意

使用 TransferBaseWorkspaceVariables 需要模型编译。

`'ShowSimulationManager'` - 启动 Simulation Manager App
'off' （默认） | 'on'

当 'ShowSimulationManager' 设置为 'on' 时，可以使用 Simulation Manager App 来监视仿真。

`'StopOnError'` - 启动 Simulation Manager App
'off' （默认） | 'on'

如果将 'StopOnError' 设置为 'on'，则在遇到错误时将停止执行仿真。

输出参数

全部折叠

`simOut` - 包含记录的仿真结果的仿真对象
对象

包含所有记录的仿真结果的 Simulink.SimulationOutput 对象的数组。数组的大小等于 Simulink.SimulationInput 对象的数组的大小。

在单个 Simulink.SimulationOutput 对象中返回所有仿真输出（记录的时间、状态和信号）。您使用 Model Configuration Parameters 对话框的 Data Import/Export 窗格来定义所记录的模型时间、状态和输出。您可以使用 To Workspace 和 Scope 等模块记录信号。Signal & Scope Manager 可以直接记录信号。

扩展功能

自动并行支持
通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。

如果安装了 Parallel Computing Toolbox，则在您使用 parsim 时，MATLAB 会自动在本地计算机上打开工作进程的并行池。MATLAB 在可用的工作进程上运行仿真。使用并行预设项控制并行行为，包括扩展到群集。

有关详细信息，请参阅运行多个仿真。

另请参阅

parsim

语法

说明

示例

使用 parsim 以并行方式仿真模型

在 Rapid Accelerator 模式下使用 `parsim`

输入参数

`in` - 用于对模型进行仿真的 `Simulink.SimulationInput` 对象
对象、数组

名称-值对组参数

注意

`'AttachedFiles'` - 要附加到并行池的文件
元胞数组

`'ShowProgress'` - 显示仿真的进度
'on'（默认值） | 'off'

注意

`'RunInBackground'` - 在后台运行仿真
'off' （默认） | 'on'

`'SetupFcn'` - 对每个工作进程运行一次的函数句柄
函数句柄

注意

`'CleanupFcn'` - 运行仿真后对每个工作进程运行一次的函数句柄
函数句柄

`'ManageDependencies'` - 管理模型依存关系
'on' （默认） | 'off'

`'UseFastRestart'` - 使用快速重启
'off' （默认） | 'on'

注意

`'TransferBaseWorkspaceVariables'` - 将变量传递给并行工作进程
'off' （默认） | 'on'

注意

`'ShowSimulationManager'` - 启动 Simulation Manager App
'off' （默认） | 'on'

`'StopOnError'` - 启动 Simulation Manager App
'off' （默认） | 'on'

输出参数

`simOut` - 包含记录的仿真结果的仿真对象
对象

扩展功能

自动并行支持
通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。

另请参阅

主题

在 R2017a 中推出

Simulink 文档

支持

Free Ebook: Managing Model-Based Design

parsim

语法

说明

示例

使用 parsim 以并行方式仿真模型

在 Rapid Accelerator 模式下使用 parsim

输入参数

in - 用于对模型进行仿真的 Simulink.SimulationInput 对象 对象、数组

名称-值对组参数

注意

'AttachedFiles' - 要附加到并行池的文件 元胞数组

'ShowProgress' - 显示仿真的进度 'on'（默认值） | 'off'

注意

'RunInBackground' - 在后台运行仿真 'off' （默认） | 'on'

'SetupFcn' - 对每个工作进程运行一次的函数句柄 函数句柄

注意

'CleanupFcn' - 运行仿真后对每个工作进程运行一次的函数句柄 函数句柄

'ManageDependencies' - 管理模型依存关系 'on' （默认） | 'off'

'UseFastRestart' - 使用快速重启 'off' （默认） | 'on'

注意

'TransferBaseWorkspaceVariables' - 将变量传递给并行工作进程 'off' （默认） | 'on'

注意

'ShowSimulationManager' - 启动 Simulation Manager App 'off' （默认） | 'on'

'StopOnError' - 启动 Simulation Manager App 'off' （默认） | 'on'

输出参数

simOut - 包含记录的仿真结果的仿真对象 对象

扩展功能

自动并行支持 通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。

另请参阅

主题

在 R2017a 中推出

Select a Web Site

How to Get Best Site Performance

Americas

Europe

Asia Pacific

Simulink 文档

支持

Free Ebook: Managing Model-Based Design

WeChat

在 Rapid Accelerator 模式下使用 `parsim`

`in` - 用于对模型进行仿真的 `Simulink.SimulationInput` 对象
对象、数组

`'AttachedFiles'` - 要附加到并行池的文件
元胞数组

`'ShowProgress'` - 显示仿真的进度
'on'（默认值） | 'off'

`'RunInBackground'` - 在后台运行仿真
'off' （默认） | 'on'

`'SetupFcn'` - 对每个工作进程运行一次的函数句柄
函数句柄

`'CleanupFcn'` - 运行仿真后对每个工作进程运行一次的函数句柄
函数句柄

`'ManageDependencies'` - 管理模型依存关系
'on' （默认） | 'off'

`'UseFastRestart'` - 使用快速重启
'off' （默认） | 'on'

`'TransferBaseWorkspaceVariables'` - 将变量传递给并行工作进程
'off' （默认） | 'on'

`'ShowSimulationManager'` - 启动 Simulation Manager App
'off' （默认） | 'on'

`'StopOnError'` - 启动 Simulation Manager App
'off' （默认） | 'on'

`simOut` - 包含记录的仿真结果的仿真对象
对象

自动并行支持
通过使用 Parallel Computing Toolbox™ 自动运行并行计算来加快代码执行。