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

Dashboard Scope

仿真期间跟踪示波器显示画面上的信号

• 

×

库:
Simulink / Dashboard

描述

Dashboard Scope 模块在波形视图上绘制仿真过程中的连接信号。您可以将 Dashboard Scope 模块与其他 Dashboard 模块结合使用，为您的模型构建包含各种控件和指示器的交互式控制板。连接到 Dashboard Scope 模块的信号记录到仿真数据检查器，以便在仿真期间或仿真后进行分析。Dashboard Scope 模块可以显示 Simulink^® 支持的任何数据类型的信号，包括枚举数据类型，以及来自数组或总线的多达 8 个信号。

连接 Dashboard 模块

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

提示

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

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

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

提示

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

分析信号数据

您可以使用 Dashboard Scope 模块的子图菜单或上下文菜单来执行以下操作：

• 显示或隐藏数据游标。

• 按固定量缩小。

• 配置鼠标交互，以进行平移和选择，或在时间轴方向、在 y 轴方向或同时在时间轴和 y 轴方向进行缩放。

• 在时间轴方向、在 y 轴方向或同时在时间轴和 y 轴方向执行适应视图操作。

要访问子图菜单，请选择 Dashboard Scope 模块，然后点击在绘图区域上暂停时出现的三个点。

配置信号线的线型和颜色

您可以使用“模块参数”对话框中的连接表或属性检查器来修改连接到 Dashboard Scope 模块的信号的颜色和线型。要修改连接信号的外观，请执行以下操作：

1. 在连接表的线型列中点击信号外观的预览。

   

2. 从标准调色板中选择一种颜色，或选择自定义选项卡，使用 0 和 255 之间的 RGB 值指定自定义颜色。

3. 从线型列中的实线、点虚线、虚线和点线选项中选择线型。

4. 点击设置。

当您将连接到 Dashboard Scope 模块的信号标记为信号记录时，您也可以使用插桩属性对话框配置信号颜色和线型。在 Dashboard Scope 模块的信号颜色和线型菜单中，默认情况下覆盖线型和颜色选项处于选中状态，并指定您使用连接表为 Dashboard Scope 模块选择的信号外观选项是否覆盖在所连接信号的插桩属性中配置的信号外观选项。

当您使用“模块参数”对话框将信号连接到 Dashboard Scope 模块时，连接表会显示您连接的每个信号的默认信号颜色和线型。当您选择要连接的信号时，连接表会更新未选择的信号的线型和颜色，以指示您连接的下一个信号的线型和颜色。

配置复信号格式

将复信号连接到 Dashboard Scope 模块时，可以通过指定信号的复信号格式属性来配置信号的显示方式：

1. 标记要进行信号记录的复信号。

2. 右键点击复信号的记录标记，然后选择属性。

3. 指定复信号格式。

4. 点击确定。

当您将复信号格式指定为实部-虚部或幅值-相位时，Dashboard Scope 模块将显示信号的两个分量。实部（即幅值）分量使用连接表中指示的颜色显示。虚部（即相位）分量是使用在连接表中所指示颜色的另一种深度显示。

示例

容错燃油控制系统建模

此示例说明如何结合使用 Stateflow® 和 Simulink® 来高效地进行混合系统建模。这种类型的建模对于具有基于离散事件的多种可能运行模式的系统特别有用。传统的信号流在 Simulink 中处理，而控制配置的更改在 Stateflow 中实现。下面所述的模型表示汽油引擎的燃油控制系统。该系统具有很强的稳健性，因为它可以检测到单个传感器的故障，并且可以动态重新配置控制系统以实现不间断运行。

打开模型

Control Merging Signals with the Push Button Block

Use the Push Button block to control signal that passes to output in the model mergedemo.

打开模型

Interactively Simulate a Thermal Model of a House

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

打开模型

Tune the Relative Slip for an Anti-Lock Braking System

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

打开模型

Control the Duty Cycle of a PWM Signal Using Dashboard Blocks

Control the generation of a PWM signal from a dashboard of controls and displays.

打开模型

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 模块连接到已注释掉的模块。使用连接模式将 Dashboard 模块连接到带注释的模块时，Dashboard 模块在您取消注释模块之前不会显示连接的值。

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

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

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

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

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

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

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

参数

连接表

使用连接表选择一个或多个要显示的信号，并配置线型和颜色。

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

信号连接选项

通过选择模型中的信号来填充连接表。要连接信号，请选中您要连接的信号旁边的复选框，然后点击应用。

提示

在仿真期间，您可以将信号连接到 Dashboard Scope 模块。

编程用法

要以编程方式指定一个或多个信号连接到 Dashboard Scope 模块，请使用 Simulink.HMI.SignalSpecification 对象的元胞数组。

模块参数：Binding

类型：Simulink.HMI.SignalSpecification 对象的元胞数组

默认值：[]

线型 — 连接的信号的线型和颜色

线型和颜色选项

您可以使用连接表为连接到 Dashboard Scope 模块的信号配置线型和颜色。要更改信号的线型或颜色，请在与信号行对应的样式列中，点击信号外观的预览。当覆盖线型和颜色处于清除状态时，样式列显示文字 auto，而不是线型的预览。有关详细信息，请参阅 配置信号线的线型和颜色。

编程用法

要以编程方式为连接的信号配置线型和颜色，请使用 Colors 参数。将 Colors 参数的值指定为结构体数组，其中每个结构体指定一个信号的样式覆盖设置、线型和线条颜色。使用 Colors 参数指定的设置将应用于 Binding 参数值中相同索引处的信号。

将每个信号的线型和颜色指定为具有下列字段的结构体：

• Auto - 样式覆盖设置由以下各项指定：

  • "on" - 线型和颜色由软件自动设置

  • "off" - 由 Color 和 LineStyle 指定的线型和颜色

• Color - 1×3 [r g b] 向量，其值在 0 到 1 之间。

• LineStyle - 字符向量，用于指定下列线型选项之一：

  • 实线：'-'

  • 虚线：'––'

  • 点线：':'

  • 点划线：'-.'

sigColors1.Color = '';
sigColors1.LineStyle = '';
sigColors1.Auto = "on";
sigColors2.Color = [0 0 1];
sigColors2.LineStyle = '--';
sigColors2.Auto = "off";
sigColors = [sigColors1 sigColors2];

set_param(blockPath,'Colors',sigColors);

模块参数：Colors

类型：结构体数组

常设

时间跨度 — 时间轴跨度

auto (默认) | 标量

有限双精度实数标量值，用于设置绘图的时间范围。

当时间跨度设置为 auto 时，模块将其时间范围设置为仿真停止时间。

提示

当您将时间跨度设置为小于仿真持续时间的值时，请使用更新模式参数来控制当仿真时间超过指定的时间跨度时，显示画面是换行还是滚动。

编程用法

模块参数：TimeSpan

类型：字符串 | 字符数组

值：'auto' 或数值

默认值：'auto'

更新模式 — 显示更新行为

Wrap (默认) | Scroll

显示画面在仿真期间的更新方式，指定为绕回或滚动。

• Wrap - 在仿真时间到达时间跨度结束值后，显示画面通过换行来显示传入的数据。

• Scroll - 在仿真时间到达时间跨度结束值后，显示画面通过滚动来显示传入的数据。

编程用法

模块参数：UpdateMode

类型：字符串 | 字符数组

值：'Wrap' | 'Scroll'

默认值：'Wrap'

最小 — 垂直轴最小值

-3 (默认) | 标量

有限双精度实数标量值，用于设置垂直轴的最小值。

提示

要在仿真停止后保持由 Min 和 Max 设置的最小和最大垂直轴范围，请清除停止时缩放坐标区范围。

编程用法

要以编程方式为 Dashboard Scope 模块指定 Min 参数，请创建一个 1×2 向量，该向量依次包含最小 y 轴值和最大 y 轴值。

模块参数：YLimits

类型：1x2 向量

默认值：[-3 3]

最大 — 垂直轴最大值

3 (默认) | 标量

有限双精度实数标量值，用于设置垂直轴的最大值。

提示

要在仿真停止后保持由 Min 和 Max 设置的最小和最大垂直轴范围，请清除停止时缩放坐标区范围。

编程用法

要以编程方式为 Dashboard Scope 模块指定 Max 参数，请创建一个 1×2 向量，该向量依次包含最小 y 轴值和最大 y 轴值。

模块参数：YLimits

类型：1x2 向量

默认值：[-3 3]

归一化 y 轴范围 — 归一化 y 轴的选项

off (默认) | on

当启用时，连接的信号数据将归一化，以在 [0,1] 的y 轴范围内显示。

编程用法

模块参数：NormalizeYAxis

类型：字符串 | 字符向量

值： 'on' | 'off'

默认值：'off'

停止时缩放坐标区范围 — 仿真停止时执行适应视图的选项

on (默认) | off

当启用时，在仿真停止时会对绘图中显示的数据执行适应视图大小操作。

编程用法

模块参数：ScaleAtStop

类型：字符串 | 字符向量

值： 'on' | 'off'

默认值：'on'

显示 "双击以连接" 消息 — 连接说明可见性

on (默认) | off

当启用时，如果模块未连接，则显示说明文本。当模块未连接时，您可以将此参数指定为 off 以隐藏文本。

编程用法

模块参数：ShowInitialText

类型：字符串 | 字符向量

值： 'on' | 'off'

默认值：'on'

显示

刻度 — 坐标轴刻度位置

外部 (默认) | 内部 | 无

坐标轴刻度位置，指定为外部、内部或无。

• 外部 - 刻度绘制在 x 和 y 坐标轴的外侧。

• 内部 - 刻度绘制在 x 和 y 坐标轴的内侧。

• 无 - 在 x 或 y 坐标轴上不显示刻度。

编程用法

模块参数：TicksPosition

类型：字符串 | 字符向量

值：'Outside' | 'Inside' | 'None'

默认值：'Outside'

刻度标签 — 刻度标签可见性

全部 (默认) | T 轴 | Y 轴 | 无

x 和 y 轴上刻度标签的可见性。

• 全部 - x 和 y 轴上均显示刻度标签。

• T 轴 - 仅 x 轴上显示刻度标签。

• Y 轴 - 仅 y 轴上显示刻度标签。

• 无 - x 和 y 轴上均不显示刻度标签。

编程用法

模块参数：TickLabels

类型：字符串 | 字符向量

值：'All' | 'T-Axis' | 'Y-Axis' | 'None'

默认值：'All'

图例 — 图例位置

顶端 (默认) | 右侧 | 内部顶端 | 内部右侧 | 隐藏

您可以将图例放置在图的顶部（绘图区域的内侧或外侧均可）或图的右侧（绘图区域的内侧或外侧均可）。也可以隐藏图例。图例显示为信号名称旁边的每个连接信号选择的颜色。

编程用法

模块参数：LegendPosition

类型：字符串 | 字符向量

值： 'Top' | 'Right' | 'InsideTop' | 'InsideRight | 'Hide'

默认值：'Top'

水平 — 水平网格线可见性

on (默认) | off

水平网格线的可见性。

• on - Dashboard Scope 上显示水平网格线。

• off - Dashboard Scope 上不显示水平网格线。

编程用法

模块参数：Grid

类型：字符串 | 字符向量

值：'All' | 'Horizontal' | 'Vertical' | 'None'

默认值：'All'

垂直 — 垂直网格线可见性

on (默认) | off

垂直网格线的可见性。

• on - Dashboard Scope 上显示垂直网格线。

• off - Dashboard Scope 上不显示垂直网格线。

编程用法

模块参数：Grid

类型：字符串 | 字符向量

值：'All' | 'Horizontal' | 'Vertical' | 'None'

默认值：'All'

边框 — 绘图边框可见性

on (默认) | off

绘图边框可见性。

• on - Dashboard Scope 上显示绘图边框。

• off - Dashboard Scope 上不显示绘图边框。

编程用法

模块参数：Border

类型：字符串 | 字符向量

值： 'on' | 'off'

默认值：'on'

标记 — 显示信号数据标记的选项

off (默认) | on

当启用时，对在 Dashboard Scope 上绘制的信号显示数据标记。

编程用法

模块参数：Markers

类型：字符串 | 字符向量

值： 'on' | 'off'

默认值：'off'

样式

前景颜色 — 网格线颜色

[r g b] 向量

从标准颜色调色板中选择网格线的颜色，或使用 0 和 255 之间的 RGB 值指定自定义颜色。

编程用法

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

模块参数：ForegroundColor

类型：字符串 | 字符向量

值：[r g b] 向量

背景颜色 — 绘图区域颜色

[r g b] 向量

从标准颜色调色板中选择绘图区域的颜色，或使用 0 和 255 之间的 RGB 值指定自定义颜色。

编程用法

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

模块参数：BackgroundColor

类型：字符串 | 字符向量

值：[r g b] 向量

字体颜色 — 刻度和刻度标签颜色

[r g b] 向量

从标准颜色调色板中选择刻度和刻度标签的颜色，或使用 0 和 255 之间的 RGB 值指定自定义颜色。

编程用法

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

模块参数：FontColor

类型：[r g b] 向量

模块特性

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

扩展功能

C/C++ 代码生成

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

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

版本历史记录

在 R2015a 中推出

另请参阅

主题

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