Main Content

set_param

设置 Simulink 参数值

全页折叠

语法

set_param(object,parameter1,value1,...,parameterN,valueN)

说明

示例

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 并设置名为 Mu 的 Gain 模块的增益参数值。

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

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

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

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

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

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

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

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

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

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

打开 vdp，对于名为 Mu 的 Gain 模块，在模块的顶部设置模块名称。

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 之前推出

另请参阅

函数

工具

模块

主题