Dashboard Scope

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

库:
Simulink / Dashboard

描述

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

连接 Dashboard 模块

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

要将显示模块连接到模型中的信号或更改显示模块的连接，请进入连接模式。选择要连接的信号线。从出现的列表中，选择您要连接的信号。然后，请在 Dashboard 模块上悬停并点击完成连接按钮。要查看 Dashboard 模块显示连接模块的值，请运行仿真。

有关连接 Dashboard 模块的详细信息，请参阅Connect Dashboard Blocks to Simulink Model。

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

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

An unconnected Dashboard Scope block connects three signals.

分析信号数据

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

显示或隐藏数据游标。
按固定量缩小。
配置鼠标交互，以进行平移和选择，或在时间轴方向、在 y 轴方向或同时在时间轴和 y 轴方向进行缩放。
在时间轴方向、在 y 轴方向或同时在时间轴和 y 轴方向执行适应视图操作。

注意

要使用键盘快捷方式来分析数据，请在 Dashboard Scope 模块中选择一个信号或轴。

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

A selected Dashboard Scope block with two cursors displayed and the subplot menu visible.

配置信号线的线型和颜色

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

在连接表的线型列中点击信号外观的预览。
从标准调色板中选择一种颜色，或选择自定义选项卡，使用 0 和 255 之间的 RGB 值指定自定义颜色。
从线型列中的实线、点虚线、虚线和点线选项中选择线型。
点击设置。

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

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

Connection table for a Dashboard Scope block with several options of signals to connect and two signals selected.

配置复信号格式

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

标记要进行信号记录的复信号。
右键点击复信号的记录标记，然后点击“属性”按钮。
指定复信号格式。
点击确定。

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

示例

全部展开

使用 Dashboard Scope 模块在仿真期间绘制信号

打开实时脚本

您可以使用 Dashboard Scope 模块在仿真期间绘制连接的信号。例如，模型 dashScope 包含一个 Dashboard Scope 模块，该模块连接到三个信号：constSig、rampSig 和 sineSig。

The Block Parameters dialog box for the Dashboard Scope block

对模型进行仿真。在仿真期间，constSig、rampSig 和 sineSig 信号流式传输至 Dashboard Scope 模块。

Animation of the dashScope model during simulation

扩展示例

容错燃油控制系统建模

此示例说明如何结合使用 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 Thermal Model of 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 模块的详细信息，请参阅Connect Dashboard Blocks to Simulink Model。

提示

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

编程用法

您可以通过编程方式将 Dashboard Scope 模块连接到一个或多个信号。定义一个 Simulink.HMI.SignalSpecification 对象元胞数组，其中每个对象表示一个信号。然后，将 Binding 参数的值设置为该元胞数组。要设置 Binding 参数的值，请使用 set_param 函数。

例如，假设名为 vdp 的模型包含名为 myScope 的 Dashboard Scope 模块和名为 x1 和 x2 的信号。要将此模块连接到这两个信号，请使用以下代码。

blockPath = "vdp/myScope";
signalPath1 = "vdp/x1";
signalPath2 = "vdp/x2";

myObj1 = Simulink.HMI.SignalSpecification;
myObj1.BlockPath = Simulink.BlockPath(signalPath1);
myObj2 = Simulink.HMI.SignalSpecification;
myObj2.BlockPath = Simulink.BlockPath(signalPath2);

myObjArray = {myObj1 myObj2};

set_param(blockPath,Binding=myObjArray)

参数:	`Binding`
值:	cell array `Simulink.HMI.SignalSpecification` objects

示例: set_param(gcb,Binding=myObjArray)

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

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

编程用法

您可以通过编程方式配置 Dashboard Scope 显示的信号的线型和颜色。定义一个结构体数组，其中每个结构体指定一个信号的样式覆盖设置、线型和线条颜色。然后，将 Color 参数的值设置为该元胞数组。要设置 Binding 参数的值，请使用 set_param 函数。使用 Colors 参数指定的设置将应用于 Binding 参数值中相同索引处的信号。

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

Auto - 样式覆盖设置由以下各项指定：
- 'on' - 线型和颜色由软件自动设置
- 'off' - 由 Color 和 LineStyle 指定的线型和颜色
Color - 1×3 [r g b] 向量，其值在 0 到 1 之间。
LineStyle - 字符向量，用于指定下列线型选项之一：
- 实线：'-'
- 虚线：'––'
- 点线：':'
- 点划线：'-.'

例如，假设一个 Dashboard Scope 模块连接到两个信号。要指定 Dashboard Scope 模块显示的信号的线型，请使用以下代码。

myStyle1.Color = '';
myStyle1.LineStyle = '';
myStyle1.Auto = 'on';
myStyle2.Color = [0 0 1];
myStyle2.LineStyle = '--';
myStyle2.Auto = 'off';

myStyles = [myStyle1 myStyle2];

set_param(gcb,Colors=myStyles)

参数:	`Colors`
值:	cell array structs with the fields `Auto`, `Color`, and `LineStyle`

示例: set_param(gcb,Colors=myStyles)

常设

时间跨度 — 时间轴跨度
`auto` (默认) | 标量

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

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

提示

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

编程用法

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

参数:	`TimeSpan`
值:	`'auto'` (默认) \| scalar formatted as a string or character vector

示例: set_param(gcb,TimeSpan="45")

更新模式 — 显示更新行为
`Wrap` (默认) | `Scroll`

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

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

编程用法

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

参数:	`UpdateMode`
值:	`'Wrap'` (默认) \| `"Wrap"` \| `"Scroll"`

示例: set_param(gcb,UpdateMode="Scroll")

最小值 — 垂直轴最小值
`-3` (默认) | 标量

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

提示

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

编程用法

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

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

min 是最小 y 轴值。
max 是最大 y 轴值。

参数:	`YLimits`
值:	`[-3 3]` (默认) \| `[min,max]`

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

最大值 — 垂直轴最大值
`3` (默认) | 标量

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

提示

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

编程用法

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

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

min 是最小 y 轴值。
max 是最大 y 轴值。

参数:	`YLimits`
值:	`[-3 3]` (默认) \| `[min,max]`

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

归一化 y 轴范围 — 归一化 y 轴的选项
`off` (默认) | `on`

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

编程用法

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

参数:	`NormalizeYAxis`
值:	`'off'` (默认) \| `"on"` \| `"off"`

示例: set_param(gcb,NormalizeYAxis="off")

停止时缩放坐标区范围 — 仿真停止时执行适应视图的选项
`on` (默认) | `off`

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

编程用法

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

参数:	`ScaleAtStop`
值:	`'on'` (默认) \| `"on"` \| `"off"`

示例: set_param(gcb,ScaleAtStop="off")

显示 "双击以连接" 消息 — 连接说明可见性
`on` (默认) | `off`

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

编程用法

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

参数:	`ShowInitialText`
值:	`'on'` (默认) \| `"on"` \| `"off"`

示例: set_param(gcb,ShowInitialText="off")

显示

刻度 — 坐标轴刻度位置
外部 (默认) | 内部 | 无

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

外部 - 刻度绘制在 x 和 y 坐标轴的外侧。
内部 - 刻度绘制在 x 和 y 坐标轴的内侧。
无 - 在 x 或 y 坐标轴上不显示刻度。

编程用法

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

参数:	`TicksPosition`
值:	`'Outside'` (默认) \| `"Outside"` \| `"Inside"` \| `"None"`

示例: set_param(gcb,TicksPosition="Inside")

刻度标签 — 刻度标签可见性
全部 (默认) | T 轴 | Y 轴 | 无

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

全部 - x 和 y 轴上均显示刻度标签。
T 轴 - 仅 x 轴上显示刻度标签。
Y 轴 - 仅 y 轴上显示刻度标签。
无 - x 和 y 轴上均不显示刻度标签。

编程用法

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

参数:	`TickLabels`
值:	`'All'` (默认) \| `"All"` \| `"T-Axis"` \| `"Y-Axis"` \| `"None"`

示例: set_param(gcb,TickLabels="Y-Axis")

图例 — 图例位置
顶端 (默认) | 右侧 | 内部顶端 | 内部右侧 | 隐藏

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

编程用法

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

参数:	`LegendPosition`
值:	`'Top'` (默认) \| `"Top"` \| `"Right"` \| `"InsideTop"` \| `"InsideRight"` \| `"Hide"`

示例: set_param(gcb,LegendPosition="InsideTop")

水平 — 水平网格线可见性
on (默认) | off

水平网格线的可见性。

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

编程用法

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

参数:	`Grid`
值:	`'All'` (默认) \| `"All"` \| `"Horizontal"` \| `"Vertical"` \| `"None"`

示例: set_param(gcb,Grid="None")

垂直 — 垂直网格线可见性
on (默认) | off

垂直网格线的可见性。

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

编程用法

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

参数:	`Grid`
值:	`'All'` (默认) \| `"All"` \| `"Horizontal"` \| `"Vertical"` \| `"None"`

示例: set_param(gcb,Grid="None")

边框 — 绘图边框可见性
on (默认) | off

绘图边框可见性。

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

编程用法

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

参数:	`Border`
值:	`'on'` (默认) \| `"on"` \| `"off"`

示例: set_param(gcb,Border="off")

标记 — 显示信号数据标记的选项
off (默认) | on

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

编程用法

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

参数:	`Markers`
值:	`'off'` (默认) \| `"on"` \| `"off"`

示例: set_param(gcb,Markers="off")

样式

前景颜色 — 网格线颜色
`[r g b]` 向量

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

编程用法

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

参数:	`ForegroundColor`
值:	`[r g b]` vector with values between `0` and `1` formatted as a string or character vector

示例: set_param(gcb,ForegroundColor="[1 0 1]")

背景颜色 — 绘图区域颜色
`[r g b]` 向量

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

编程用法

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

参数:	`BackgroundColor`
值:	`[r g b]` vector with values between `0` and `1` formatted as a string or character vector

示例: set_param(gcb,BackgroundColor="[1 0 1]")

字体颜色 — 刻度和刻度标签颜色
`[r g b]` 向量

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

编程用法

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

参数:	`FontColor`
值:	`[r g b]` vector with values between `0` and `1`

示例: set_param(gcb,FontColor=[1 0 1])

模块特性

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

扩展功能

全部展开

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

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

版本历史记录

在 R2015a 中推出

全部展开

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

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

Dashboard Scope

描述

连接 Dashboard 模块

分析信号数据

配置信号线的线型和颜色

配置复信号格式

示例

使用 Dashboard Scope 模块在仿真期间绘制信号

扩展示例

容错燃油控制系统建模

Control Merging Signals with the Push Button Block

Interactively Simulate Thermal Model of House

Tune the Relative Slip for an Anti-Lock Braking System

Control the Duty Cycle of a PWM Signal Using Dashboard Blocks

Interactively Simulate Vehicle Climate Control System

限制

参数

连接表

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

提示

编程用法

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

编程用法

常设

时间跨度 — 时间轴跨度 auto (默认) | 标量

提示

编程用法

更新模式 — 显示更新行为 Wrap (默认) | Scroll

编程用法

最小值 — 垂直轴最小值 -3 (默认) | 标量

提示

编程用法

最大值 — 垂直轴最大值 3 (默认) | 标量

提示

编程用法

归一化 y 轴范围 — 归一化 y 轴的选项 off (默认) | on

编程用法

停止时缩放坐标区范围 — 仿真停止时执行适应视图的选项 on (默认) | off

编程用法

显示 "双击以连接" 消息 — 连接说明可见性 on (默认) | off

编程用法

显示

刻度 — 坐标轴刻度位置 外部 (默认) | 内部 | 无

编程用法

刻度标签 — 刻度标签可见性 全部 (默认) | T 轴 | Y 轴 | 无

编程用法

图例 — 图例位置 顶端 (默认) | 右侧 | 内部顶端 | 内部右侧 | 隐藏

编程用法

水平 — 水平网格线可见性 on (默认) | off

编程用法

垂直 — 垂直网格线可见性 on (默认) | off

编程用法

边框 — 绘图边框可见性 on (默认) | off

编程用法

标记 — 显示信号数据标记的选项 off (默认) | on

编程用法

样式

前景颜色 — 网格线颜色 [r g b] 向量

编程用法

背景颜色 — 绘图区域颜色 [r g b] 向量

编程用法

字体颜色 — 刻度和刻度标签颜色 [r g b] 向量

编程用法

模块特性

扩展功能

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

版本历史记录

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

另请参阅

主题

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

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

时间跨度 — 时间轴跨度
`auto` (默认) | 标量

更新模式 — 显示更新行为
`Wrap` (默认) | `Scroll`

最小值 — 垂直轴最小值
`-3` (默认) | 标量

最大值 — 垂直轴最大值
`3` (默认) | 标量

归一化 y 轴范围 — 归一化 y 轴的选项
`off` (默认) | `on`

停止时缩放坐标区范围 — 仿真停止时执行适应视图的选项
`on` (默认) | `off`

显示 "双击以连接" 消息 — 连接说明可见性
`on` (默认) | `off`

刻度 — 坐标轴刻度位置
外部 (默认) | 内部 | 无

刻度标签 — 刻度标签可见性
全部 (默认) | T 轴 | Y 轴 | 无

图例 — 图例位置
顶端 (默认) | 右侧 | 内部顶端 | 内部右侧 | 隐藏

水平 — 水平网格线可见性
on (默认) | off

垂直 — 垂直网格线可见性
on (默认) | off

边框 — 绘图边框可见性
on (默认) | off

标记 — 显示信号数据标记的选项
off (默认) | on

前景颜色 — 网格线颜色
`[r g b]` 向量

背景颜色 — 绘图区域颜色
`[r g b]` 向量

字体颜色 — 刻度和刻度标签颜色
`[r g b]` 向量

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