Knob

R2026b

用刻度盘调节参数值

库:
Simulink / Dashboard

描述

在仿真过程中，Knob 模块调整连接的模块参数的值。例如，您可以将 Knob 模块连接到模型中的 Gain 模块，并在仿真过程中调整其值。您可以修改 Knob 模块的刻度范围以适合您的数据。将 Knob 模块与其他 Dashboard 模块结合使用，可以创建交互式仪表板来控制您的模型。

连接 Dashboard 模块

此模块是控制模块 - 即连接到参数并调节其值的模块。您可以连接到具有标量值的参数，或连接到矩阵的元素。

Dashboard 模块不使用端口来连接到模型元素。请改用连接模式。要在未连接的模块上进入连接模式，请将鼠标在要连接的模块上暂停并点击连接按钮。要在已连接的模块上进入连接模式，请选择该模块，在显示的省略号 (…) 上暂停，然后在展开的操作菜单中点击连接按钮。

在连接模式中，选择要连接到其参数的模块。从出现的列表中，选择要连接的参数。然后，请在 Dashboard 模块上悬停并点击完成连接按钮。

在更新模型图之前，控制模块无法连接到其值为变量的参数。要在仿真未运行时连接到其值为变量的参数或修改作为所连接的参数值的变量值，请按 Ctrl+D 更新模型图。

您可以连接到具有标量值的参数，或连接到矩阵或结构体的元素。有关详细信息，请参阅Connect Dashboard Blocks to Simulink Model。

您还可以将 Dashboard 模块连接到 Stateflow^® 图。有关详细信息，请参阅将 Dashboard 模块连接到 Stateflow (Stateflow)。

此动画说明如何将 Knob 模块连接到您的模型。

An unconnected Knob block connects to the Gain parameter of a Gain block.

参数记录

连接到 Dashboard 模块的可调参数数据会记录到仿真数据检查器，您可以在其中查看参数值以及记录的信号数据。您可以通过使用 UI 或 Simulink.sdi.exportRun 函数从仿真数据检查器导出参数数据来访问 MATLAB^® 工作区中记录的参数数据。有关使用仿真数据检查器 UI 导出数据的详细信息，请参阅Export Data From Simulation Data Inspector to Workspace or File。参数数据存储在 Simulink.SimulationData.Parameter 对象中，可作为导出的 Simulink.SimulationData.Dataset 中的元素来访问。

示例

全部展开

使用 Knob 模块更改增益值

打开实时脚本

在仿真期间，可以使用 Knob 模块将一个参数的值设置为几个值之一。例如，在模型 knobGain 中，Knob 模块连接到 Gain 模块的增益参数。Knob 模块配置为您可以在 0 和 20 之间选择增益值。

The Block Parameter dialog box for the Knob block

对模型进行仿真。要在仿真期间更改增益值，请旋转 Knob 模块。

Animation of the knobGain model during simulation

扩展示例

Interactively Simulate Thermal Model of House

Use Dashboard blocks to configure and then interactively simulate a thermal model of a house.

打开实时脚本

Interactively Simulate Vehicle Climate Control System

Use a dashboard of controls and indicators to interact with the simulation of an automobile climate control system.

打开模型

限制

除了 Dashboard Scope 模块和 Display 模块之外，Dashboard 模块只能连接到实数标量信号。
您不能在“模块参数”对话框中使用连接表将 Dashboard 模块连接到已注释掉的模块。使用连接模式将 Dashboard 模块连接到带注释的模块时，Dashboard 模块在您取消注释模块之前不会显示连接的值。
Dashboard 模块无法连接到引用模型中的模型元素。
在仿真模型层次结构时，引用模型内的 Dashboard 模块不会更新。
Dashboard 模块不支持快速加速仿真。

当您在仿真期间将 Dashboard 模块连接到变量或参数时，该变量或参数的数据不会记录到仿真数据检查器中。要将变量和参数数据记录到仿真数据检查器，请在仿真之前将 Dashboard 模块连接到该变量或参数。
当您将默认参数行为设置为内联并在外部模式下对模型进行仿真时，Dashboard 模块看起来像是更改了参数和变量值。但是，更改不会传播到仿真。例如，Gain 模块显示使用 Dashboard 模块对增益参数进行的更改，但仿真中使用的增益值不变。

参数

全部展开

连接到 — 要连接的模块参数值
参数值连接选项

此模块是控制模块 - 即连接到参数并调节其值的模块。您可以连接到具有标量值的参数，或连接到矩阵的元素。Dashboard 模块不使用端口来连接到模型元素。请改用连接模式、Simulink^® 工具条或“模块参数”对话框中的连接表。有关信息，请参阅Connect Dashboard Blocks to Simulink Model。

要使用连接表将控制模块连接到具有标量值的参数，请执行以下操作：

选择模块。
在属性检查器中，在参数选项卡上，点击连接或更改。
选择要连接其参数值的模块。
在出现的表中，选择该参数。
点击应用。

要连接到其值指定为变量的参数或更改已连接变量的值，您必须先更新模型图。要更新模型图，请按 Ctrl+D。

您还可以将 Dashboard 模块连接到 Stateflow 图。有关详细信息，请参阅将 Dashboard 模块连接到 Stateflow (Stateflow)。

编程用法

您可以通过编程方式将控制模块连接到参数。定义一个表示该参数的 Simulink.HMI.ParamSourceInfo 对象。然后，将 Binding 参数的值设置为该对象。要设置 Binding 参数的值，请使用 set_param 函数。

例如，假设名为 vdp 的模型包含名为 myButton 的 Push Button 模块和名为 x1 的 Integrator 模块。要将 Push Button 模块连接到 Integrator 模块的 Initial Condition 参数，请使用以下代码。

blockPath1 = "vdp/myButton";
blockPath2 = "vdp/x1";

myObj = Simulink.HMI.ParamSourceInfo;
myObj.BlockPath = Simulink.BlockPath(blockPath2);
myObj.ParamName = 'InitialCondition';

set_param(blockPath1,Binding=myObj)

参数:	`Binding`
值:	`Simulink.HMI.ParamSourceInfo` object

示例: set_param(gcb,Binding=myObj)

刻度类型 — 刻度的类型
`Linear` (默认) | `Log`

模块上显示的刻度的类型。线性指定线性刻度，Log 指定对数刻度。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

参数:	`ScaleType`
值:	`'Linear'` (默认) \| `"Linear"` \| `"Log"`

示例: set_param(gcb,ScaleType="Log")

最小 — 最小刻度线值
`0` (默认) | 标量

有限双精度实数标量值，用于指定标度的最小刻度线值。最小值必须小于最大值参数的值。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

将 Limits 参数的值指定为 [min,int,max] 形式的向量。

min 是刻度的 Minimum 刻度线值。
int 是刻度的 Tick Interval。要使 Tick Interval 的值为 auto，请将向量中的 Tick Interval 位置留空，或指定 -1。
max 是刻度的 Maximum 刻度线值。

参数:	`Limits`
值:	`[0 -1 100]` (默认) \| `[min,int,max]`

示例: set_param(gcb,Limits=[-50 -1 100])

最大 — 最大刻度线值
`100` (默认) | 标量

有限双精度实数标量值，用于指定标度的最大刻度线值。最大值必须大于最小值参数的值。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

将 Limits 参数的值指定为 [min,int,max] 形式的向量。

min 是刻度的 Minimum 刻度线值。
int 是刻度的 Tick Interval。要使 Tick Interval 的值为 auto，请将向量中的 Tick Interval 位置留空，或指定 -1。
max 是刻度的 Maximum 刻度线值。

参数:	`Limits`
值:	`[0 -1 100]` (默认) \| `[min,int,max]`

示例: set_param(gcb,Limits=[0 -1 50])

刻度间隔 — 主刻度线之间的间隔
`auto` (默认) | 标量

有限实数正整数标量值，用于指定标度上主刻度线的间隔。当设置为 auto 时，模块会根据最大值和最小值参数的值自动调整刻度间隔。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

将 Limits 参数的值指定为 [min,int,max] 形式的向量。

min 是刻度的 Minimum 刻度线值。
int 是刻度的 Tick Interval。要使 Tick Interval 的值为 auto，请将向量中的 Tick Interval 位置留空，或指定 -1。
max 是刻度的 Maximum 刻度线值。

参数:	`Limits`
值:	`[0 -1 100]` (默认) \| `[min,int,max]`

示例: set_param(gcb,Limits=[0 5 100])

标签 — 模块标签位置
`Top` (默认) | `Bottom` | `Hide`

模块标签的位置。当模块连接到模型中的元素时，标签是所连接的元素的名称。

编程用法

要以编程方式设置模块参数值，请使用 set_param 函数。

参数:	`LabelPosition`
值:	`'Top'` (默认) \| `"Top"` \| `"Bottom"` \| `"Hide"`

示例: set_param(gcb,LabelPosition="Bottom")

模块特性

数据类型	`double` \| `half` \| `integer` \| `single`
直接馈通	`否`
多维信号	`否`
可变大小信号	`否`
过零检测	`否`

扩展功能

全部展开

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

代码生成会忽略 Dashboard 模块。

版本历史记录

在 R2015a 中推出

全部展开

R2026a: 用于连接 Dashboard 模块的“模块参数”对话框表将被删除

在以后的版本中，将不再支持使用“模块参数”对话框中的表连接来自 Dashboard 库或 Customizable Blocks 库的模块。请改用连接模式。有关连接模式的信息，请参阅Connect Dashboard Blocks to Simulink Model。

R2023b: 在新窗口中打开面板

从 R2023b 开始，您可以在新窗口中打开仪表板面板。要打开它，请先选择面板并将鼠标暂停在出现的省略号上。在展开的操作菜单中，点击在新窗口中打开按钮。

您可以单独最小化和还原包含面板的新窗口，而不影响模型窗口。您可以通过面板窗口运行、暂停、停止和逐步运行仿真。在面板窗口中，您可以编辑面板及其中包含的模块。

要将面板返回到模型画布，请在面板窗口工具条中，点击在画布中打开 。

有关在新窗口中打开面板的详细信息，请参阅Open Panels in New Window。

R2023a: Simulink 工具条中的持久面板选项卡

向模型添加仪表板面板时，面板选项卡会出现在 Simulink 工具条中，并显示用于管理和编辑面板的选项。

在之前的版本中，面板选项卡仅在面板选中时可见。从 R2023a 开始，即使没有选择面板时，面板选项卡仍保持可见。

面板选项卡也包含以下新选项：

您可以添加空面板。
您可以重命名所选面板。
您可以隐藏所选面板。

R2022b: 面板中的可自定义 Dashboard 模块支持撤消和重做操作

从 R2022b 开始，您可以撤消和重做对面板中的可自定义 Dashboard 模块所做的更改。

要撤消或重做更改，请执行以下操作：

点击面板或面板中的模块。
按 Ctrl+Z 撤消更改，或按 Ctrl+Y 重做更改。

注意

键盘快捷方式基于 Windows^®。在 Mac 上，按 command (⌘) 代替 Ctrl。

R2022b: 对面板的工具条支持

从 R2022b 开始，您可以使用 Simulink 工具条来管理和编辑面板及其中包含的 Dashboard 模块。

点击面板中的 Dashboard 模块时，将显示该模块的工具条选项卡。例如，当您点击 Circular Gauge 模块时，仪表选项卡会出现在工具条中。

当您点击某个面板时，工具条中会出现面板选项卡。该选项卡提供以下选项：

管理模型中面板的可见性。
调整所有未隐藏的面板以适应当前视图。
折叠所选面板。
自定义面板的大小和内容。
为所选面板设置自定义背景图像。
向所选面板添加新选项卡。

R2021a: 使用 Dashboard 模块调节矩阵和结构体元素

从 R2021a 开始，您可以将 Dashboard 库中的模块连接到定义可调模块参数值的矩阵或结构体的标量元素。当您将 Dashboard 模块连接到可调参数时，首先选择一个或多个模块。然后，在对话框中选择要连接的参数。当选择具有非标量值的参数时，使用对话框中的文本框指定要调节的元素。

R2020b: Simulink 工具条对 Dashboard 模块的支持

从 R2020b 开始，当您从 Simulink 库中的 Dashboard 库中或从 Aerospace Blockset™ Flight Control Analysis 库中的 Flight Instruments 库中选择模型中的某个模块时，Simulink 工具条中的模块选项卡会变为特定于模块的选项卡。从工具条中，可以连接、断开连接和修改所选模块的连接。您可以跳转至连接到所选模块的模型元素，也可以将所选模块添加到面板中。

R2019a: 以编程方式添加和配置 Dashboard 模块

从 R2019a 开始，您可以使用 add_block 和 set_param 等函数从模型中的 Dashboard 库创建和配置模块。

另请参阅

Rotary Switch | Slider

Knob

描述

连接 Dashboard 模块

参数记录

示例

使用 Knob 模块更改增益值

扩展示例

Interactively Simulate Thermal Model of House

Interactively Simulate Vehicle Climate Control System

限制

参数

连接到 — 要连接的模块参数值 参数值连接选项

编程用法

刻度类型 — 刻度的类型 Linear (默认) | Log

编程用法

最小 — 最小刻度线值 0 (默认) | 标量

编程用法

最大 — 最大刻度线值 100 (默认) | 标量

编程用法

刻度间隔 — 主刻度线之间的间隔 auto (默认) | 标量

编程用法

标签 — 模块标签位置 Top (默认) | Bottom | Hide

编程用法

模块特性

扩展功能

C/C++ 代码生成 使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。

版本历史记录

R2026a: 用于连接 Dashboard 模块的“模块参数”对话框表将被删除

R2023b: 在新窗口中打开面板

R2023a: Simulink 工具条中的持久面板选项卡

R2022b: 面板中的可自定义 Dashboard 模块支持撤消和重做操作

R2022b: 对面板的工具条支持

R2021a: 使用 Dashboard 模块调节矩阵和结构体元素

R2020b: Simulink 工具条对 Dashboard 模块的支持

R2019a: 以编程方式添加和配置 Dashboard 模块

另请参阅

主题

连接到 — 要连接的模块参数值
参数值连接选项

刻度类型 — 刻度的类型
`Linear` (默认) | `Log`

最小 — 最小刻度线值
`0` (默认) | 标量

最大 — 最大刻度线值
`100` (默认) | 标量

刻度间隔 — 主刻度线之间的间隔
`auto` (默认) | 标量

标签 — 模块标签位置
`Top` (默认) | `Bottom` | `Hide`

C/C++ 代码生成
使用 Simulink® Coder™ 生成 C 代码和 C++ 代码。