sim

您可以使用 Simulink.SimulationInput 对象来存储独立于仿真模型的仿真配置。Simulink.SimulationInput 对象中的配置将应用于仿真模型。仿真后，任何发生更改的模型设置都将还原为原始值。

打开模型 IntegrateSine。该模型使用 Integrator 模块对 Sine Wave 模块的输出进行积分。Integrator 模块的输出连接到 Outport 模块。

mdl = "IntegrateSine";
open_system(mdl)

创建一个 Simulink.SimulationInput 对象来存储模型 IntegrateSine 的仿真配置。

simIn = Simulink.SimulationInput(mdl);

使用 setModelParameter 函数将 SimulationInput 对象配置为使用 ode45 求解器并将仿真停止时间设为 20 秒。

simIn = setModelParameter(simIn,"Solver","ode45",...
    "StopTime","20");

使用 setBlockParameter 函数配置 SimulationInput 对象，将 Sine Wave 模块的振幅参数设置为 2。

blk = strcat(mdl,"/Sine Wave");
simIn = setBlockParameter(simIn,blk,"Amplitude","2");

使用存储在 Simulink.SimulationInput 对象 simIn 中的配置对模型进行仿真。

out = sim(simIn);

该模型对 Sine Wave 模块使用 ode45 求解器，以 2 为振幅仿真 20 秒。

当您使用 Simulink.SimulationInput 对象数组来配置一组仿真时，只需调用一次 sim 函数即可使用快速重启运行一组仿真。快速重启通过在各次仿真运行之间保持模型编译来节省仿真时间。

打开模型 IntegrateSine。该模型使用 Integrator 模块对 Sine Wave 模块的输出进行积分。Integrator 模块的输出连接到 Outport 模块。

mdl = "IntegrateSine";
open_system(mdl)

假设您要运行一组（包含六个）仿真，每个仿真对 Sine Wave 模块使用不同频率值。创建一个包含各个仿真的频率值的向量。

freqs = [0.5 1 1.5 2 2.5 3];

当您要调节模块参数时，可以使用变量定义参数值。然后，通过更改变量值来调节模块参数。

定义变量 freq，将其用作 Sine Wave 模块的频率参数的值。对于初始变量值，可以使用当前参数值。

blk = mdl + "/Sine Wave";
freq = str2double(get_param(blk,"Frequency"));

将 Sine Wave 模块的 Frequency 参数值设置为 freq。

set_param(blk,"Frequency","freq")

在 for 循环中，创建一个包含六个 Simulink.SimulationInput 对象的数组，并使用 setVariable 函数来配置每个对象以使用频率向量中的值。

for k = length(freqs):-1:1
    simIn(k) = Simulink.SimulationInput(mdl);
    simIn(k) = setVariable(simIn(k),"freq",freqs(k));
end

使用 sim 函数运行由 SimulationInput 对象 simIn 的数组定义的仿真。使用 UseFastRestart 名称-值参量启用快速重启。仅当第一个输入参量是 Simulink.SimulationInput 对象时，才支持 UseFastRestart 名称-值参量。要在第一个参量是模型名称时使用快速重启，请使用 FastRestart 名称-值参量。

out = sim(simIn,"UseFastRestart","on");

[12-Aug-2025 19:22:49] Running simulations...
[12-Aug-2025 19:22:51] Completed 1 of 6 simulation runs
[12-Aug-2025 19:22:51] Completed 2 of 6 simulation runs
[12-Aug-2025 19:22:52] Completed 3 of 6 simulation runs
[12-Aug-2025 19:22:53] Completed 4 of 6 simulation runs
[12-Aug-2025 19:22:53] Completed 5 of 6 simulation runs
[12-Aug-2025 19:22:53] Completed 6 of 6 simulation runs

要运行同一组仿真而不显示进度消息，请将 ShowProgress 名称-值参量指定为 off。

out = sim(simIn,"UseFastRestart","on","ShowProgress","off");

要使用仿真管理器监控仿真的进度，请将 ShowSimulationManager 名称-值参量指定为 on。有关仿真管理器的详细信息，请参阅Simulation Manager。

out = sim(simIn,"UseFastRestart","on",...
    "ShowProgress","off","ShowSimulationManager","on");

仿真输出 out 是包含每个仿真的元数据和结果的 Simulink.SimulationOutput 对象数组。输出数组中 SimulationOutput 对象的顺序与输入数组中 SimulationInput 对象的顺序匹配。例如，索引 1 处的 SimulationOutput 对象包含使用索引 1 处的 SimulationInput 对象配置的仿真的结果。

访问第一次仿真结果记录的输出信号，第一次仿真使用的频率值为 0.5。

youtPt5 = out(1).yout

youtPt5 = 
Simulink.SimulationData.Dataset 'yout' with 1 element

                         Name    BlockPath             
                         ______  _____________________ 
    1  [1x1 Signal]      output  IntegrateSine/Outport

  - Use braces { } to access, modify, or add elements using index.

打开模型 IntegrateSine。该模型使用 Integrator 模块对 Sine Wave 模块的输出进行积分。Integrator 模块的输出连接到 Outport 模块。

mdl = "IntegrateSine";
open_system(mdl);

使用当前配置参数值仿真模型。

out = sim(mdl);

仿真运行 10 秒，对振幅为 1 的正弦波求积分。

您可以使用 set_param 函数修改模型中的模型配置参数值和模块参数值。

配置模型以使用 ode45 求解器并将仿真停止时间设为 20 秒。

set_param(mdl,"Solver","ode45","StopTime","20")

将 Sine Wave 模块的振幅参数设置为 2。

blk = strcat(mdl,"/Sine Wave");
set_param(blk,"Amplitude","2")

当您使用 set_param 函数修改配置参数值或模块参数值时，更改会应用于模块图并弄脏模型文件。当您再次调用 sim 函数时，即使您没有保存模型，仿真也会使用新参数值，这些参数值是当前模型配置的一部分。

out2 = sim(mdl);

仿真运行 20 秒，对振幅为 2 的正弦波求积分。

通过将仿真的配置参数指定为 sim 函数的名称-值参量，可以将模型的仿真配置为使用不同模型配置参数值。您指定的参数值将应用于仿真，并在仿真完成时还原。

您只能将模型配置参数值指定为 sim 函数的名称-值参量，而不能将模块参数值指定为参量。要在单一输入中指定仿真的模型配置参数值、模块参数值和变量值，请改用 Simulink.SimulationInput 对象。

打开模型 IntegrateSine。该模型使用 Integrator 模块对 Sine Wave 模块的输出进行积分。Integrator 模块的输出连接到 Outport 模块。

mdl = "IntegrateSine";
open_system(mdl);

假设您要使用 ode45 求解器和 20 秒的仿真停止时间对模型进行仿真。指定仿真的 Solver 和 StopTime 值作为 sim 函数的名称-值参量。

out = sim(mdl,"Solver","ode45","StopTime","20");

该模型使用求解器 ode45 进行仿真，直到到达仿真时间 20 秒处。

您可以使用由模型配置参数的名称和值组成的结构体来配置模型的仿真。将结构体中的配置参数值应用于模型进行仿真。仿真后，任何发生更改的模型设置都将还原为原始值。

结构体输入只能指定模型配置参数值，而无法指定要在仿真中使用的不同模块参数或变量值。要在单一输入中指定仿真的模型配置参数值、模块参数值和变量值，请改用 Simulink.SimulationInput 对象。

打开模型 IntegrateSine。该模型使用 Integrator 模块对 Sine Wave 模块的输出进行积分。Integrator 模块的输出连接到 Outport 模块。

mdl = "IntegrateSine";
open_system(mdl)

创建结构体 SimConfig，该结构体将仿真配置为使用 ode45 求解器且仿真停止时间为 20 秒。对于要在仿真中修改的每个配置参数，该结构体都包含一个对应的字段。每个字段的名称与对应的参数的编程名称匹配。每个字段的值指定仿真中使用的该参数的值。

simConfig.Solver = "ode45";
simConfig.StopTime = "20";

使用结构体中的模型配置参数值仿真模型。

out = sim(mdl,simConfig);

该模型使用 ode45 求解器进行仿真，仿真时间 20 秒。

Simulink.ConfigSet 对象存储一组模型配置参数值。您可以将 Simulink.ConfigSet 对象指定为 sim 函数的输入。该对象中的配置集将应用于要仿真的模型。在仿真后，模型中将还原原始配置集。

Simulink.Configset 对象仅存储模型配置参数值。要在单一输入中指定仿真的模型配置参数值、模块参数值和变量值，请改用 Simulink.SimulationInput 对象。

打开模型 IntegrateSine。该模型使用 Integrator 模块对 Sine Wave 模块的输出进行积分。Integrator 模块的输出连接到 Outport 模块。

mdl = "IntegrateSine";
open_system(mdl)

使用 getActiveConfigSet 函数获取当前模型配置的 Simulink.ConfigSet 对象。

mdlConfig = getActiveConfigSet(mdl);

使用 copy 函数创建要修改的 Simulink.ConfigSet 对象的副本。

simConfig = copy(mdlConfig);

修改 Simulink.ConfigSet 对象 simConfig 以使用 ode45 求解器并将仿真停止时间设为 20 秒。

set_param(simConfig,"Solver","ode45","StopTime","20");

使用 Simulink.Configset 对象 simConfig 中的配置参数仿真模型。

out = sim(mdl,simConfig);

该模型使用 ode45 求解器进行仿真，仿真时间 20 秒。