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

显示

在仿真期间显示信号值

• 

×

库:
Simulink / Dashboard

描述

Display 模块连接到模型中的信号，并在仿真期间显示信号值。您可以配置 Display 模块的外观和格式，以直观显示数据值。您可以在仿真过程中编辑 Display 模块的参数。Display 模块可以显示复信号、向量信号和二维矩阵信号。将 Display 模块与其他 Dashboard 模块结合使用，为您的模型构建包含各种控件和指示器的交互式控制板。

连接 Dashboard 模块

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

提示

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

要进入连接模式，请在画布中选择要连接的 Dashboard 模块。在 Simulink^® 工具条上，会出现以所选模块的类型命名的选项卡。在模块选项卡上，点击连接。在连接模式下，当您选择一个或多个信号或模块时，会出现可用于连接的信号的列表。从列表中选择信号以连接到所选 Dashboard 模块。要连接另一个 Dashboard 模块，请在要连接的模块上悬停并点击其上方的连接按钮。然后，在模型中选择一个或多个信号和模块，并选择要连接的信号。

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

提示

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

示例

Interactively Simulate Vehicle Climate Control System

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

打开模型

Interactively Simulate a Thermal Model of a House

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

打开模型

限制

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

• 工具条不支持已在面板中的 Dashboard 模块。

• Dashboard 模块不能连接位于引用模型内部的信号。

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

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

• 在仿真期间，无法将 Dashboard 模块连接到 Stateflow^® 中的状态活动或图数据。

• 无法以编程方式将 Dashboard 模块连接到 Stateflow 中的状态活动或图数据。

• 由于加速模式仿真的模块简化或优化，一些信号在仿真期间没有可用的数据。要使用 Dashboard 模块查看此类信号，请标记信号以进行记录。

参数

连接

连接 — 要连接和显示的信号

信号连接选项

使用连接表选择要连接到模块的信号。要将模块连接到信号，请执行下列步骤：

1. 在包含一个或多个信号的模型中进行选择。

2. 在表中，选择要连接的信号。

3. 点击应用。

提示

在仿真期间，可以将 Dashboard 模块连接到模型中的信号。

编程用法

模块参数：Binding

类型：Simulink.HMI.SignalSpecification

默认值：[]

常设

格式 — 用于显示信号值的格式

short (默认) | long | shortE | longE | ...

用于显示信号值的格式，指定为下列值之一：

• short - 小数点后具有 4 位数的定标固定十进制格式

• long - 定标固定十进制格式，double 值的小数点后具有 15 位数，single 值的小数点后具有 7 位数

• shortE - 具有 4 位数的科学记数法格式

• longE - 科学记数法格式，double 值的小数点后具有 15 位数，single 值的小数点后具有 7 位数

• shortG - 取固定十进制和科学记数法中较紧凑的格式，共有 5 位数

• longG - 取固定十进制和科学记数法中较紧凑的格式，double 值共有 15 位数，single 值共有 7 位数

• shortEng - 工程记数法，其中指数为 3 的倍数，小数点后具有 4 位数

• longEng - 工程记数法，其中指数为 3 的倍数，有效位数为 15 位

• + - 正/负格式。对正值、负值和零值分别显示 +、- 和空白字符

• bank - 货币格式，小数点后具有 2 位数

• hex - 十六进制表示

• rat - 比率

• Custom - 自定义字符串格式。数据以您使用格式化字符串参数指定的自定义字符串形式显示。

• Integer - 数据舍入到最邻近的整数。

编程用法

模块参数：Format

类型：字符数组 | 字符串

值：'short' | 'long' | 'shortE' | 'longE' | 'shortG' | 'longG' | 'shortEng' | 'longEng' | 'bank' | '+' | 'hex' | 'rat' | 'Custom' | 'Integer'

默认值：'short'

格式字符串 — 用于格式化数据的自定义字符串

'%d' (默认) | 字符串

用于格式化所显示信号数据的自定义字符串，指定为字符串。格式字符串由文本和格式化操作符组成，以 % 符号开头，以转换字符结尾。您可在字符串中希望显示信号数据的位置使用格式化操作符。有关支持的格式化操作符的详细信息，请参阅 compose 函数的 formatSpec 输入。

示例: The value of pi is %.2f 在一个句子中显示连接的信号的值。

示例: $%.2f 用美元符号和两位小数显示连接的信号的值。

依存关系

要启用此参数，请将格式参数设置为 Custom。

编程用法

模块参数：FormatString

类型：字符数组 | 字符串

默认值：'%d'

对齐方式 — 模块中的文本对齐方式

Center (默认) | Left | Right

Display 模块中的文本对齐。

编程用法

模块参数：Alignment

类型：字符数组

值：'Left' | 'Center' | 'Right'

默认值：'Center'

标签 — 模块标签位置

Hide (默认) | Bottom | Top

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

编程用法

模块参数：LabelPosition

类型：字符向量

值：'Hide' | 'Bottom' | 'Top'

默认值：'Hide'

布局 — 如何排列非标量数据的元素

Preserve dimensions (默认) | Fill available space

如何排列非标量数据的元素，指定为以下选项之一：

• Preserve dimensions - 按照与信号维度匹配的排列方式显示元素。

• Fill available space - 在可用空间内显示尽可能多的元素。

编程用法

模块参数：Layout

类型：字符数组 | 字符串

值：'Preserve dimensions' | 'Fill available space'

默认值：'Preserve dimensions'

格式

显示非标量信号的网格 — 是否显示网格

on (默认) | off

当模块显示非标量数据时，是否在模块上显示网格。使用网格颜色参数指定网格的颜色。

编程用法

模块参数：ShowGrid

类型：字符数组 | 字符串

值： 'on' | 'off'

默认值：'on'

不透明度 — 模块背景不透明度

1 (默认) | 标量

模块背景不透明度，指定为 0 到 1 之间的标量值。

示例: 0.5

编程用法

模块参数：Opacity

类型：标量

默认值： 1

前景颜色 — 模块前景颜色

[r g b] 向量

模块前景颜色，包括文本。您可以从标准颜色调色板中选择一种颜色，也可以指定自定义颜色。

编程用法

将模块的 ForegroundColor 参数指定为字符串或字符向量，该向量定义 1×3 [r g b] 向量，其值介于 0 和 1 之间。

模块参数：ForegroundColor

类型：字符向量 | 字符串

值：[r g b] 向量

背景颜色 — 模块的背景色。

[r g b] 向量

模块的背景色。您可以从标准颜色调色板中选择一种颜色，也可以指定自定义颜色。

编程用法

将模块的 BackgroundColor 参数指定为字符串或字符向量，该向量定义 1×3 [r g b] 向量，其值介于 0 和 1 之间。

模块参数：BackgroundColor

类型：字符向量 | 字符串

值：[r g b] 向量

网格颜色 — 模块网格颜色

[r g b] 向量

模块网格颜色。网格显示模块何时显示非标量数据。您可以从标准颜色调色板中选择一种颜色，也可以指定自定义颜色。

编程用法

将模块的 GridColor 参数指定为 1×3 [r g b] 向量，其值介于 0 到 1 之间。

模块参数：GridColor

类型：[r g b] 向量

默认值：[0.502 0.502 0.502]

模块特性

数据类型	Boolean | double | enumerated | fixed point | half | integer | single | string
直接馈通	否
多维信号	是
可变大小信号	否
过零检测	否

扩展功能

C/C++ 代码生成

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

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

版本历史记录

在 R2017b 中推出

另请参阅

Dashboard Scope | Gauge | Lamp | MultiStateImage

主题

• 使用 Dashboard 模块对模型进行调优和可视化
• 决定如何可视化仿真数据