本页翻译不是最新的。点击此处可查看最新英文版本。

用滑动标尺调整参数值

库: Simulink / Dashboard

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

Dashboard 模块不使用端口来连接到模型元素。要将 Dashboard 模块连接到变量和模块参数，请使用连接模式。连接模式有助于在模型中连接 Dashboard 模块，尤其是需要一次连接多个模块时。要连接单个 Dashboard 模块，还可以使用模块对话框中的连接表。

提示

您可以在普通和加速模式下的仿真期间修改模型中的 Dashboard 模块连接。

注意

在更新模型图之前，Dashboard 模块无法连接到变量。当打开模型后，若要在运行仿真前将 Dashboard 模块连接到变量或修改变量值，请使用 Ctrl+D 更新模型图。

要进入连接模式，请在画布中选择要连接的 Dashboard 模块。在 Simulink® 工具条上，会出现以所选模块的类型命名的选项卡。在模块选项卡上，点击连接。在连接模式下，当您选择一个或多个模块时，会出现可用于连接的参数和变量的列表。从列表中选择变量或参数，以连接到所选 Dashboard 模块。

当所选变量或模块参数的值是非标量时，请使用连接表底部的文本框来指定要连接到 Dashboard 模块的元素。要连接到向量、矩阵或数组的元素，请指定元素索引，例如 3 或 (1,3)。要连接到总线或结构体中的元素，请在总线或结构体层次结构的上下文中指定元素，方法是使用点来指示层次结构中的不同级别并省略顶层。例如，指定 a.b 以连接到嵌套在所选复合变量或参数内的结构体或总线 a 的标量元素 b。

要连接另一个 Dashboard 模块，请在这另一个模块上悬停并点击其上方的连接按钮。然后，在模型中选择信号和模块，并选择要连接的模型元素。

完成模型中 Dashboard 模块的连接后，在模块选项卡上，点击完成连接。

提示

您可以使用具有 ShowInitialText 模块参数的 set_param 函数隐藏在未连接的模块上显示的消息。当您连接模块时，消息也会消失。

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

Tune the relative slip in a model of an anti-lock braking system using Dashboard blocks.

除了 Dashboard Scope 模块和 Display 模块之外，Dashboard 模块只能连接到实数标量信号。

工具条不支持面板内的模块。

您不能在模块对话框中使用连接表将 Dashboard 模块连接到已注释掉的模块。使用连接模式将 Dashboard 模块连接到带注释的模块时，Dashboard 模块在您取消注释模块之前不会显示连接的值。

Dashboard 模块无法连接到引用模型中的模型元素。

在仿真模型层次结构时，引用模型内的 Dashboard 模块不会更新。

Dashboard 模块不支持快速加速仿真。

当您在仿真期间将 Dashboard 模块连接到变量或参数时，该变量或参数的数据不会记录到仿真数据检查器中。要将变量和参数数据记录到仿真数据检查器，请在仿真之前将 Dashboard 模块连接到该变量或参数。

当您将默认参数行为设置为内联并在外部模式下对模型进行仿真时，Dashboard 模块看起来像是更改了参数和变量值。但是，更改不会传播到仿真。例如，Gain 模块显示使用 Dashboard 模块对增益参数进行的更改，但仿真中使用的增益值不变。

全部展开

选择要使用连接表进行控制的变量或模块参数。要将模块连接到信号，请执行下列步骤：

在包含一个或多个模块的模型中进行选择。

选择要连接的变量或参数。

当所选变量或模块参数的值是非标量时，请使用连接表底部的文本框来指定要连接到 Dashboard 模块的元素。要连接到向量、矩阵或数组的元素，请指定元素索引，例如 3 或 (1,3)。要连接到总线或结构体中的元素，请在总线或结构体层次结构的上下文中指定元素，方法是使用点来指示层次结构中的不同级别并省略顶层。例如，指定 a.b 以连接到嵌套在所选复合变量或参数内的结构体或总线 a 的标量元素 b。

点击应用。

为了便于理解和调试您的模型，您可以在仿真期间将 Dashboard 模块连接到模型中的变量和参数。

注意

要查看连接表中的工作区变量，请使用 Ctrl+D 更新模型图。

要以编程方式将 Dashboard 模块连接到可调参数或变量，请使用 Simulink.HMI.ParamSourceInfo 对象。Simulink.HMI.ParamSourceInfo 对象包含四个属性。有些属性适用于将 Dashboard 模块连接到参数，有些属性适用于将 Dashboard 模块连接到变量。并非所有字段都有与连接对应的值，因为一个给定的 Dashboard 模块只能连接到参数或变量之一。

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

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

要以编程方式设置 Minimum 参数，请使用 1×3 向量，其中依次包含 Minimum、Tick Interval 和 Maximum 参数的值。要使 Tick Interval 的值为 auto，请将向量中的 Tick Interval 位置留空，或指定 -1。

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

要以编程方式设置 Maximum 参数，请使用 1×3 向量，其中依次包含 Minimum、Tick Interval 和 Maximum 参数的值。要使 Tick Interval 的值为 auto，请将向量中的 Tick Interval 位置留空，或指定 -1。

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

要以编程方式设置 Tick Interval 参数，请使用 1×3 向量，其中依次包含 Minimum、Tick Interval 和 Maximum 参数的值。要使 Tick Interval 的值为 auto，请将向量中的 Tick Interval 位置留空，或指定 -1。

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

数据类型

double | half | integer | single

直接馈通

否

多维信号

否

可变大小信号

否

过零检测

否

Dashboard 模块在代码生成中会被忽略。

全部展开

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

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

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

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

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

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

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

您可以添加空面板。

您可以重命名所选面板。

您可以隐藏所选面板。

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

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

点击面板或面板中的模块。

按 Ctrl+Z 撤消更改，或按 Ctrl+Y 重做更改。

注意

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

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

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

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

管理模型中面板的可见性。

调整所有未隐藏的面板以适应当前视图。

折叠所选面板。

自定义面板的大小和内容。

为所选面板设置自定义背景图像。

向所选面板添加新选项卡。

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

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

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

Knob | Rotary Switch