Display

显示输入的值

全页展开

库:
Simulink / Sinks
HDL Coder / Sinks

描述

Display 模块显示输入数据的值。您可以指定显示的频率。对于数值输入数据，您还可以指定显示的格式。

如果模块输入是数组，则您可以纵向或横向调整模块大小以显示更多元素，而不是只显示第一个元素。如果模块输入是向量，则模块从左到右、从上到下依次添加显示字段。模块会显示尽可能多的值。实心三角形表示模块并未显示所有的输入数组元素。

Display 模块显示向量信号的前 200 个元素，显示矩阵信号的前 20 行和前 10 列。

注意

如果您指定的数值显示格式不够大，无法显示值的所有位数，则显示的值可能会损失精度。结果取决于您的计算机硬件和操作系统。

显示缩写词

Display 模块上显示下列缩写词，以帮助您确定值的格式。

当您看到...	显示的值为...
`(SI)`	存储的整数值注意当信号是整数数据类型时，不显示 `(SI)`。
`hex`	十六进制格式
`bin`	二进制格式
`oct`	八进制格式

显示字符串

使用字符串时，Display 模块显示：

带双引号的字符串。
将特殊字符显示为转义序列，例如换行符显示为 '\n'。
将不可显示的字符显示为转义八进制数，例如 '\201'。

如果输入信号是字符串类型，则数值显示格式参数的选择不影响字符串的显示。

示例

全部展开

Sum 模块对输入重新排序

打开模型

此示例说明 Sum 模块如何对输入进行重新排序。如果您使用 - 符号作为第一项运算，模块将对输入进行重新排序（如果可能），以使用 + 运算。例如，在表达式 output = -a-b+c 中，Sum 模块对输入进行重新排序，使得 output = c-a-b。为了初始化累加器，Sum 模块使用第一个 + 输入端口。

该模块避免对第一个操作数 a 执行一元减法运算，因为这样做会更改定点数据类型的 a 的值。在这种情况下，输出值不同于 a、b 和 c 的值的累加结果。

两个常量输入都使用 int8 数据类型。Sum 模块还将 int8 用于累加器和输出数据类型，并启用对整数溢出进行饱和处理。Sum 模块对输入进行重新排序，以得到 127 的理想结果。

将输入从 (-Input1 + Input2) 重新排序为 (Input2 - Input1)。
使用第一个 + 输入端口初始化累加器。Accumulator = int8(-1) = -1
继续累加值。Accumulator = Accumulator - int8(-128) = 127
计算模块输出。Output = int8(127) = 127

如果 Sum 模块没有对输入进行重新排序，则您将得到 126 的非理想结果。

使用第一个输入端口初始化累加器。Accumulator = int8(-(-128)) = 127
由于饱和是打开的，累加器的初始值在 127 处饱和并且不绕回。
继续累加值。Accumulator = Accumulator + int8(-1) = 126
计算模块输出。Output = int8(126) = 126

要为 output = -a-b+c 显式指定一元减法运算，可以使用 Math Operations 库中的 Unary Minus 模块。

Coulomb and Viscous Friction 模块的标量扩展

打开模型

此示例说明具有库仑和粘性摩擦模块标量输入的模型，该模型使用标量扩展来输出向量。

双击摩擦模块查看参数。粘性摩擦系数(增益) 是标量值 2，但库仑摩擦值(偏移)是向量值 [1 3 2 0]。因此，该模块使用按元素标量扩展来计算输出。

每个输出均使用此公式计算。

$y = sign(x) .* (Gain .* abs(x) + Offset)$

例如，第一个偏移量 1 计算如下。

$y = - * ((2 * 5) + 1)$

$y = -11$

如果输入和 Offset 的维度相同，则无需展开。

扩展示例

自动气候控制系统仿真

此示例说明如何使用 Simulink® 和 Stateflow® 对汽车中自动气候控制系统进行仿真。

打开模型

端口

输入

全部展开

Port_1 — 输入数据
标量 | 向量

要显示的输入数据。

参数

全部展开

数值显示格式 — 数值输入数据的显示格式
short (默认) | long | short_e | long_e | 货币格式 | 十六进制(存储整数) | 二进制(存储整数) | 十进制(存储整数) | 八进制(存储整数)

指定数值数据的显示格式。

如果您选择...	模块显示...
`short`	具有固定十进制小数点的 5 位数定标值
`long`	具有固定十进制小数点的 15 位数定标值
`short_e`	具有浮动小数点的 5 位数值
`long_e`	具有浮动小数点的 16 位数值
`bank`	具有固定美元和美分格式的值（但没有 $ 或逗号）
`hex (Stored Integer)`	以十六进制格式存储的定点输入整数值
`binary (Stored Integer)`	以二进制格式存储的定点输入整数值
`decimal (Stored Integer)`	以十进制格式存储的定点输入整数值
`octal (Stored Integer)`	以八进制格式存储的定点输入整数值

如果 Display 模块的数值输入具有 single、double 或 half 数据类型，并且显示格式是存储整数，则输出使用 long 格式显示。

如果 Display 模块的数值输入具有枚举数据类型（请参阅Simulink 枚举和定义 Simulink 枚举）：

模块将显示枚举值，而非基础整数值。
将数值显示格式设置为任一 Stored Integer 设置将导致错误。

如果输入信号是字符串类型，则数值显示格式参数的选择不影响字符串的显示。

编程用法

模块参数：Format

类型：字符向量

默认值：'short'

抽取 — 显示速率
`1` (默认) | `integer`

指定显示数据的频率。

显示的数据量和显示数据的时间步取决于抽取模块参数和 SampleTime 属性。

抽取参数允许您显示间隔为 n 的每个样本数据，其中 n 是抽取因子。默认抽取因子 1 在每个时间步显示数据。
注意
Display 模块在初始时间更新显示，即使抽取值大于一也是如此。
SampleTime 属性（可以使用 set_param 来设置）允许您指定显示点的采样间隔。使用时间步间隔不同的变步长求解器时，此属性很有用。默认采样时间 -1 导致模块在确定要显示的点时忽略采样间隔。

注意
如果模块继承采样时间 Inf，抽取参数将被忽略。

编程用法

模块参数：Decimation

类型：字符向量

值：'1' | 整数

默认值：'1'

浮动显示 — 浮动显示
`off` (默认) | `on`

要使用此模块作为浮动显示，请选中浮动显示复选框。模块输入端口消失，模块显示选定信号线上的信号值。

如果您选择浮动显示：

关闭模型的信号存储重用。有关详细信息，请参阅信号存储重用 (Simulink Coder)。
不要将多维信号连接到浮动显示。

编程用法

模块参数：Floating

类型：字符向量

值：'on' | 'off'

默认值：'on'

模块特性

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

扩展功能

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

在代码生成中将被忽略。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

HDL 架构

架构	描述
无 HDL	不为此模块生成 HDL 代码。

HDL 模块属性

PreserveUpstreamLogic

控制是否删除未连接的逻辑。默认值为 off，这意味着未连接的逻辑不会保留在 HDL 代码中。有关详细信息，请参阅PreserveUpstreamLogic (HDL Coder)。

Display