sim
R2026bSimulink 模型的运行和脚本化编程仿真
语法
描述
Simulink.SimulationInput 对象语法
out = sim(simin)Simulink.SimulationInput 对象上定义的属性，运行 Simulink® 模型的一个或多个仿真。
如果
simin是标量Simulink.SimulationInput对象，则out是标量Simulink.SimulationOutput对象。如果
simin是由Simulink.SimulationInput对象组成的向量、矩阵或数组，则out是与simin具有相同维数的由Simulink.SimulationOutput对象组成的向量、矩阵或数组。
您可以使用 Simulink.SimulationInput 对象来配置仿真的选项和输入，包括：
要仿真的模型
外部输入数据的源变量或文件
用于仿真的模块参数值
用于仿真的模型配置参数值
当 Simulink.SimulationInput 对象的属性修改模型或模块参数值时，该值将在仿真期间修改，并在仿真结束时还原。
当您使用 Simulink.SimulationInput 对象配置程序化仿真时，您可以从使用 sim 函数转换为使用其他函数，如 parsim 和 batchsim。
有关详细信息，请参阅以编程方式运行仿真。
out = sim(simin,Name=Value)
有关 Simulink.SimulationInput 语法支持的名称-值参量列表，请参阅Simulink.SimulationInput 对象语法。
模型语法
out = sim(mdl)mdl 进行仿真。
如果模型启用了单一仿真输出参数或快速重启，则
out是一个Simulink.SimulationOutput对象。如果模型未启用单一仿真输出或快速重启，则
out是包含仿真时间的向量。有关详细信息，请参阅不推荐使用返回多个输出参量的语法。
out = sim(mdl,Name=Value)
当您通过向 sim 函数提供输入来修改模型配置参数时，这些更改将在仿真期间应用，并在仿真结束时还原。
有关模型语法支持的名称-值参量列表，请参阅模型语法。
示例
假设您有名为 IntegrateSine 的模型，该模型对 Sine Wave 模块的输出进行积分，并使用 Outport 模块记录结果。Scope 模块显示正弦波输入和积分输出。您打开模型并希望使用在模型中保存的参数值对该模型进行仿真。
通过将模型名称指定为 sim 函数的输入对该模型进行仿真。
out = sim(mdl);
仿真使用在模型中指定的当前模型配置参数和模块参数运行。在本例中，模型停止时间为 10 秒，Sine Wave 模块的振幅为 1。
要在不弄脏模型的情况下修改模型中的参数以进行仿真，请使用 Simulink.SimulationInput 对象来配置仿真。当您使用 Simulink.SimulationInput 对象配置仿真时，您可以配置模型配置参数、模块参数和变量值。sim 函数在仿真期间应用在 Simulink.SimulationInput 对象上指定的配置，并在仿真完成时还原对模型的更改。
假设您要针对正弦波输入的不同振幅对在使用当前参数值运行仿真中所述的模型 IntegrateSine 进行仿真。
要对模型进行参数化，请将 Sine Wave 模块的振幅参数的值指定为变量。打开模型。然后，在基础工作区中定义该变量，并将模型中模块参数的值指定为该变量。
mdl = "IntegrateSine"; open_system(mdl) a = 1; set_param(mdl + "/Sine Wave",Amplitude="a")
创建一个 Simulink.SimulationInput 对象来存储仿真配置。在 Simulink.SimulationInput 对象上指定参数和变量值以配置仿真，该仿真：
使用求解器
ode45运行至 20 秒处的停止时间
将仿真的正弦波输入的振幅设置为 2
mdl = "IntegrateSine"; simin = Simulink.SimulationInput(mdl); simin = setModelParameter(simin,Solver="ode45",StopTime="20"); simin = setVariable(simin,"a",2);
通过将 Simulink.SimulationInput 对象指定为 sim 函数的输入对该模型进行仿真。
out = sim(simin);
该模型使用求解器 ode45 和正弦波振幅 2 运行仿真 20 秒。
在仿真完成后，工作区中的变量、求解器参数和停止时间参数还原为其原始值。
快速重启通过在第一个仿真的执行阶段之前仅编译一次模型来加速参数扫描。每次后续仿真都会使用指定的参数值重新初始化模型而无需重新编译模型，这可以显著减少运行参数扫描所需的总时间。要为使用单次调用 sim 函数运行的参数扫描启用快速重启，请将 UseFastRestart 名称-值参量指定为 "on"。
假设您要针对正弦波输入的不同振幅对在使用当前参数值运行仿真中所述的模型 IntegrateSine 进行仿真。
要对模型进行参数化，请将 Sine Wave 模块的振幅参数的值指定为变量。打开模型。然后，在基础工作区中定义该变量，并将模型中模块参数的值指定为该变量。
mdl = "IntegrateSine"; open_system(mdl) a = 1; set_param(mdl + "/Sine Wave",Amplitude="a")
创建一个您要进行仿真的参数值向量。然后，创建一个 Simulink.SimulationInput 对象数组，表示参数扫描中每个仿真的配置。在 for 循环中，为每个 Simulink.SimulationInput 对象指定定义参数的变量的值。
mdl = "IntegrateSine"; amps = [1 2 3 4 5 6]; n = length(amps); simin(1:n) = Simulink.SimulationInput(mdl); for k = n:-1:1 simin(k) = setVariable(simin(k),"a",amps(k)); end
使用对 sim 函数的单次调用来运行参数扫描，并将 UseFastRestart 名称-值参量指定为 "on" 来启用快速重启。
out = sim(simin,UseFastRestart="on");[14-Apr-2026 17:31:23] Running simulations... [14-Apr-2026 17:31:24] Completed 1 of 6 simulation runs [14-Apr-2026 17:31:25] Completed 2 of 6 simulation runs [14-Apr-2026 17:31:25] Completed 3 of 6 simulation runs [14-Apr-2026 17:31:25] Completed 4 of 6 simulation runs [14-Apr-2026 17:31:26] Completed 5 of 6 simulation runs [14-Apr-2026 17:31:26] Completed 6 of 6 simulation runs
sim 函数将仿真结果以 Simulink.SimulationOutput 对象数组形式返回。数组中的每个 Simulink.SimulationOutput 对象都包含使用输入数组中相同索引的 Simulink.SimulationInput 对象配置的仿真的结果。例如，输出数组中索引 1 处的 Simulink.SimulationOutput 对象包含使用输入数组中索引 1 处的 Simulink.SimulationInput 对象运行的仿真的结果。
访问在第一个仿真中记录的输出数据，该仿真使用的振幅为 1。
yout1 = out(1).yout
yout1 =
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.
要隐藏进度消息，请将 ShowProgress 名称-值参量指定为 "off"。要使用仿真管理器监控进度，请将 ShowSimulationManager 名称-值参量指定为 "on"。有关详细信息，请参阅仿真管理器。
要在不弄脏模型的情况下配置仿真，您可以指定一个或多个名称-值参量。sim 函数在仿真期间修改参数，并在仿真完成时还原对模型的更改。名称-值参量只能指定模型配置参数。要配置其他参数，例如变量和模块参数值，请改用 Simulink.SimulationInput 对象。
假设您要使用求解器 ode45 对使用当前参数值运行仿真中所述的模型 IntegrateSine 运行仿真 20 秒。
对模型进行仿真。使用名称-值参量为仿真指定停止时间和求解器参数。
mdl = "IntegrateSine"; out = sim(mdl,StopTime="20",Solver="ode45");
要查看仿真中使用的参数值，请检查与仿真结果一起返回的仿真元数据。
slvr = out.SimulationMetadata.ModelInfo.SolverInfo.Solver
slvr =
'ode45'tstop = out.SimulationMetadata.ModelInfo.StopTime
tstop =
20要在不弄脏模型的情况下配置仿真，您可以指定一个结构体来定义您要修改的每个参数的名称和值。sim 函数在仿真期间修改指定的参数，并在仿真完成时还原对模型的更改。该结构体只能指定模型配置参数。要配置其他参数，例如变量和模块参数值，请改用 Simulink.SimulationInput 对象。
假设您要使用求解器 ode45 对使用当前参数值运行仿真中所述的模型 IntegrateSine 运行仿真 20 秒。
创建一个包含 Solver 和 StopTime 字段的结构体。
simconfig.Solver = "ode45"; simconfig.StopTime = "20";
使用在结构体中指定的参数值对模型进行仿真。
mdl = "IntegrateSine";
out = sim(mdl,simconfig);要查看仿真中使用的参数值，请检查与仿真结果一起返回的仿真元数据。
slvr = out.SimulationMetadata.ModelInfo.SolverInfo.Solver
slvr =
'ode45'tstop = out.SimulationMetadata.ModelInfo.StopTime
tstop =
20要将配置集应用于仿真而不弄脏模型，请使用 Simulink.ConfigSet 对象配置仿真。sim 函数在仿真期间将配置集应用于模型，并在仿真完成时还原更改。配置集仅指定模型配置参数值。要指定其他值，例如变量和模块参数值，请改用 Simulink.SimulationInput 对象。
假设您要使用求解器 ode45 对使用当前参数值运行仿真中所述的模型 IntegrateSine 运行仿真 20 秒。
要指定仿真中要使用的参数值，请创建并配置 Simulink.ConfigSet 对象。打开模型并获取当前配置集。然后，创建该配置集的一个副本，并对该副本指定停止时间和求解器。
mdl = "IntegrateSine"; open_system(mdl) mdlconfig = getActiveConfigSet(mdl); simconfig = copy(mdlconfig); set_param(simconfig,StopTime="20"); set_param(simconfig,Solver="ode45");
使用配置集 simconfig 对模型进行仿真。
out = sim(mdl,simconfig);
要查看仿真中使用的参数值，请检查与仿真结果一起返回的仿真元数据。
slvr = out.SimulationMetadata.ModelInfo.SolverInfo.Solver
slvr =
'ode45'tstop = out.SimulationMetadata.ModelInfo.StopTime
tstop =
20输入参数
名称-值参数
输出参量
提示
要以相同格式为每个语法返回结果，请在启用单一仿真输出参数的情况下保存模型。以单个对象形式返回所有仿真数据和元数据有助于分析多个仿真的结果。
要控制脚本化仿真期间的执行并调节参数值，请使用
Simulation对象。 (自 R2024a 起)有关详细信息，请参阅以编程方式运行仿真。要同时使用 MATLAB 命令行窗口和 Simulink 编辑器与仿真交互，请使用
set_param函数发出仿真命令。有关详细信息，请参阅以编程方式运行仿真。使用
sim函数运行仿真时，仿真会一直运行，直到出现错误或仿真到达指定的停止时间。当您仿真停止时间为无限长的模型时，通过按 Ctrl+C 键从 MATLAB 命令行窗口停止仿真。仿真停止，仿真结果不会保存在 MATLAB 工作区中。
当
StopFcn模型回调执行时，编程仿真的结果不可用。要处理仿真结果，请改用Simulink.SimulationInput对象的PostSimFcn回调。使用“配置参数”对话框配置时间、状态和输出的记录。在建模选项卡上的设置下，点击模型设置。然后，在“配置参数”对话框中，选择数据导入/导出。
要记录整个模型中的信号，请使用信号记录或记录模块，如 To Workspace 模块或 Record 模块。有关详细信息，请参阅 使用信号记录保存信号数据。
