Main Content

set_param

设置 Simulink 参数值

说明

示例

set_param(object,parameter1,value1,...,parameterN,valueN) 将指定的 Simulink® 参数 parameter 设置为由 object 指定的目标对象的指定值 value。目标对象可以是模型、子系统、库、模块、信号线、端口或总线元素端口元素。

要为目标对象设置多个参数值,请使用多个名称-值参量调用 set_param 函数一次,而不是为每个参数单独调用该函数。用一次函数调用设置多个参数的方法很高效,因为一次调用只计算一次参数。如果任何参数名称或值无效,则函数不会设置任何参数。

示例

全部折叠

打开 vdp 模型,并设置求解器StopTime 参数值。

vdp
set_param('vdp','Solver','ode15s','StopTime','3000')

打开一个模型并设置求解器StopTime 参数。使用 bdroot 函数获取当前顶层模型。

vdp
set_param(bdroot,'Solver','ode15s','StopTime','3000')

打开 vdp 并设置名为 MuGain 模块的增益参数值。

vdp
set_param('vdp/Mu','Gain','10')

打开 vdp 并设置名为 MuGain 的模块的位置。

vdp
set_param('vdp/Mu','Position',[50 100 110 120])

使用模块句柄设置名为 MuGain 模块在 vdp 模型中的位置。

要获取名为 MuGain 模块的句柄,请使用 getSimulinkBlockHandle 函数。要加载 vdp 模型,请指定 true

mublockhandle = getSimulinkBlockHandle('vdp/Mu',true);

如果对同一模块多次调用 set_param,请使用模块句柄,这比完整模块路径更高效。

您可以在对 get_paramset_param 的后续调用中使用该模块句柄。句柄包含双精度值。不要尝试手动输入句柄的数字(例如 5.007),因为通常需要指定的位数会多于 MATLAB® 显示的位数。而要将该句柄赋给变量,并使用该变量名称指定模块。

将模块句柄与 set_param 一起使用来设置位置。

set_param(mublockhandle,'Position',[50 100 110 120])

打开 vdp,对于名为 MuGain 模块,在模块的顶部设置模块名称。

vdp
set_param('vdp/Mu','NameLocation','top')

输入参数

全部折叠

对象的名称、路径或句柄,指定为字符向量、字符串标量或数值标量。

如何指定目标对象取决于其类型。

  • 模型 - 模型名称或句柄。

  • 子系统 - 系统名称或句柄。

  • 库 - 库名称或句柄。

  • 模块 - 模块路径或句柄。

  • 信号线 - 信号线句柄。

  • 端口 - 端口句柄。

  • 总线元素端口元素 - 具有元素标签的模型组件的模块路径。元素可以是端口的任何元素,例如顶层总线、嵌套总线、信号或消息。

示例: 'vdp/Mu'

示例: 'mymodel/Subsystem1/Out1.nonsinusoidal.saw'

提示

  • 如果对同一模块多次调用 set_param,请用数值句柄指定该模块。这种方法比对 set_param 使用完整模块路径更高效。使用 getSimulinkBlockHandle 获取模块句柄。

  • 不要尝试手动指定句柄的数字,例如 5.007,因为您通常需要指定的位数多于 MATLAB 显示的位数。要将句柄赋给变量并使用该变量名称。

数据类型: char | string | double

参数、属性或特性名称,指定为字符向量或字符串标量。有些名称区分大小写。

有关参数、属性或特性的信息,请参阅对应参考页上的编程使用信息。例如:

要获取目标对象的所有参数,请使用带 'ObjectParameters' 选项的 get_param 函数。某些返回的参数可能仅供内部使用。

示例: 'Solver'

示例: 'SimulationCommand'

示例: 'Position'

示例: 'NameLocation'

数据类型: char | string

参数值,指定为参数类型决定的格式。一些参数值区分大小写。值通常是字符向量或字符串标量,但也可以是数值标量、数组和其他类型。

许多模块参数值指定为字符向量或字符串标量。但 Position(它指定为向量)和 UserData(它可以是任何数据类型)是两个例外。

限制

如果您使用 matlab -nodisplay 启动会话,则不能使用 set_param 运行仿真。-nodisplay 模式不支持使用 set_param 进行仿真。改用 sim 函数。

提示

在 MATLAB 工作区中设置参数后,要查看模型中的变化,请更新图形。

set_param(model,'SimulationCommand','Update')

版本历史记录

在 R2006a 之前推出