Main Content

Dashboard Scope

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

  • 库:
  • Simulink / Dashboard

  • Dashboard Scope block

描述

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

连接 Dashboard 模块

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

提示

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

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

Connecting a Dashboard Scope block to signals in the model vdp using connect mode.

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

提示

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

分析信号数据

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

  • 显示或隐藏数据游标。

  • 按固定量缩小。

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

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

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

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

配置信号线的线型和颜色

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

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

    Line color and style selection menu for a signal connected to a Dashboard Scope block.

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

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

  4. 点击设置

当您将连接到 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 模块时,可以通过指定信号的复信号格式属性来配置信号的显示方式:

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

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

  3. 指定复信号格式

  4. 点击确定

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

限制

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

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

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

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

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

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

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

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

参数

全部展开

连接

使用连接表选择一个或多个要显示的信号。通过选择模型中的信号来填充连接表。要连接信号,请选中您要连接的信号旁边的复选框,然后点击应用

提示

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

  • 您可以使用连接表为连接到 Dashboard Scope 模块的信号配置线型和颜色。有关详细信息,请参阅 配置信号线的线型和颜色

编程用法

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

模块参数Binding
类型:Simulink.HMI.SignalSpecification 对象的元胞数组
默认值:[]

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

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

  • Color - 1×3 [r g b] 向量,其值在 01 之间。

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

    • 实线:'-'

    • 虚线:'––'

    • 点线:':'

    • 点划线:'-.'

sig1Colors.Color = [0 0 1];
sig1Colors.LineStyle = '--';
sig2Colors.Color = [1 0 1];
sig2Colors.LineStyle = '-';
sigColors = [sig1Colors sig2Colors];
模块参数Colors
类型:结构体数组

常设

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

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

提示

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

编程用法

模块参数TimeSpan
类型:字符串 | 字符数组
值:'auto' 或数值
默认值:'auto'

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

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

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

编程用法

模块参数UpdateMode
类型:字符串 | 字符数组
'Wrap' | 'Scroll'
默认值:'Wrap'

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

编程用法

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

模块参数:YLimits
类型:1x2 向量
默认值[-3 3]

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

编程用法

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

模块参数:YLimits
类型:1x2 向量
默认值[-3 3]

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

编程用法

模块参数NormalizeYAxis
类型:字符串 | 字符向量
值: 'on' | 'off'
默认值:'off'

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

编程用法

模块参数ScaleAtStop
类型:字符串 | 字符向量
值: 'on' | 'off'
默认值:'on'

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

编程用法

模块参数ShowInitialText
类型:字符串 | 字符向量
值: 'on' | 'off'
默认值:'on'

显示

坐标轴刻度位置,指定为“外部”、“内部”或“”。

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

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

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

编程用法

模块参数TicksPosition
类型:字符串 | 字符向量
'Outside' | 'Inside' | 'None'
默认值:'Outside'

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” - Dashboard Scope 上显示水平网格线。

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

编程用法

模块参数Grid
类型:字符串 | 字符向量
'All' | 'Horizontal' | 'Vertical' | 'None'
默认值'All'

垂直网格线的可见性。

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

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

编程用法

模块参数Grid
类型:字符串 | 字符向量
'All' | 'Horizontal' | 'Vertical' | 'None'
默认值'All'

绘图边框可见性。

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

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

编程用法

模块参数Border
类型:字符串 | 字符向量
值: 'on' | 'off'
默认值:'on'

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

编程用法

模块参数Markers
类型:字符串 | 字符向量
值: 'on' | 'off'
默认值:'off'

样式

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

编程用法

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

模块参数ForegroundColor
类型:字符串 | 字符向量
值:[r g b] 向量

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

编程用法

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

模块参数BackgroundColor
类型:字符串 | 字符向量
值:[r g b] 向量

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

编程用法

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

模块参数FontColor
类型:[r g b] 向量

模块特性

数据类型

Boolean | bus | double | enumerated | fixed point | half | integer | single | string

直接馈通

多维信号

可变大小信号

过零检测

扩展功能

版本历史记录

在 R2015a 中推出