Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

Dashboard Scope

在仿真过程中跟踪信号

  • 库:
  • Simulink / Dashboard

  • Dashboard Scope block

Description

Dashboard Scope 模块在波形视图上显示仿真过程中的连接信号。您可以将 Dashboard Scope 模块与其他 Dashboard 模块结合使用,为您的模型构建包含各种控件和指示器的交互式控制板。Dashboard Scope 模块提供仿真过程中信号行为的完整画面。使用 Dashboard Scope 模块显示 Simulink® 支持的任何数据类型(包括枚举数据类型)的信号。Dashboard Scope 模块最多可以显示来自数组或总线的八个信号。

连接 Dashboard 模块

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

提示

您可以在 Normal 和 Accelerator 模式仿真期间修改 Dashboard 模块连接。

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

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

提示

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

数据游标

您可以 Dashboard Scope 模块添加数据游标,以检查显示的信号。当选择 Dashboard Scope 模块时,会显示数据游标。选择 Dashboard Scope 模块后,您可以沿着显示的信号移动游标以查看与每个时间采样对应的数据值。当您显示两个游标时,沿时间轴上的两个游标之间的框显示这两个游标之间的时间差。

要添加数据游标,请右键点击 Dashboard Scope 模块。在 Data Cursors 菜单下,选择要添加的游标数。

缩放、平移和适应视图

您还可以使用缩放、平移和适应视图操作来检查您的信号。您可以限制缩放和适应视图操作,以仅更改 t 轴或 y 轴的图范围。要缩放、平移或适应视图,请右键点击 Dashboard Scope 模块并选择操作。

  • 平移

  • 放大

  • 放大时间

  • 放大 Y

  • 缩小

  • 适应视图

  • 基于时间适应视图

  • 基于 Y 适应视图

信号外观

您可以在模块对话框的 Connection 表中修改连接到 Dashboard Scope 模块的信号的颜色和线型。要修改连接信号的外观,请执行以下操作:

  1. 点击 Connection 表的 Style 列中信号的信号外观预览。

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

  3. 从信号外观对话框中的 Style 部分下的实线、点线、虚线和点划线选项中选择线型。

一个信号的信号颜色和线型在整个模型中保持一致。您可以通过所记录信号的 Instrumentation Properties 和连接到信号的 Dashboard Scope 模块的 Dashboard Scope 模块对话框来配置信号的线型和颜色。默认情况下 Override style and color 处于选中状态,它控制通过该 Dashboard Scope 模块对话框选择的信号外观选项是否覆盖在模型中其他位置配置的信号外观选项。清除 Override style and color 设置时,将不会应用使用该对话框对该 Dashboard Scope 模块所做的更改。

当您使用模块对话框将信号连接到 Dashboard Scope 模块时,连接表会显示您所连接信号的默认信号颜色和线型。当您选中要连接的信号时,Connection 表会更新其余选定信号的默认线型和颜色,以用于您要连接的下一个信号。

复信号

Dashboard Scope 模块根据其 Complex Format 显示复信号。您可以使用 Instrumentation Properties 对话框为信号配置 Complex Format(右键点击信号的记录标记并选择 Properties 即可访问该对话框)。

信号可以采用以下 Complex Format

  • Real-Imaginary

  • Magnitude-Phase

  • Magnitude

  • Phase

当您将 Complex Format 设置为 Real-ImaginaryMagnitude-Phase 时,Dashboard Scope 模块将显示信号的两个分量。实部(即幅值)分量以 Connection 表中指示的颜色显示。虚部(即相位)分量以 Connection 表中所指示颜色的另一种深度显示。

限制

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

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

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

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

  • Dashboard 模块不支持 Rapid Accelerator 仿真。

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

  • 一些信号被优化移除,在 Accelerator 模式仿真期间不可用。要使用 Dashboard 模块查看此类信号,请标记信号以进行记录。

参数

全部展开

Connection

使用 Connection 表选择一个或多个要连接的信号。通过选择模型中需要的信号,填充 Connection 表。选中您要显示的信号旁边的复选框。点击 Apply 以连接信号。为了便于理解和调试您的模型,您可以在仿真过程中将信号连接到 Dashboard Scope 模块。

您还可以使用 Connection 表为连接到 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
类型:结构体数组

Main

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

Time Span 设置为 auto 时,模块将其时间范围设置为模型的仿真停止时间。

提示

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

编程用法

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

显示画面在仿真期间的更新方式,指定为 “Wrap” 或 “Scroll”。

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

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

编程用法

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

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

依存关系

Min 值必须小于 Max 值。

编程用法

要以编程方式为 Dashboard Scope 模块指定 Min 参数,请使用 1×2 向量,其中依次包含 y 轴最小值和 y 轴最大值。

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

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

依存关系

Max 值必须大于 Min 值。

编程用法

要以编程方式为 Dashboard Scope 模块指定 Max 参数,请使用 1×2 向量,其中依次包含 y 轴最小值和 y 轴最大值。

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

当设置为 on 时,对连接的信号数据进行归一化,以在 [0,1] 范围的 y 轴上显示数据。

编程用法

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

值为 on 时,在仿真停止时会对绘图中显示的数据执行适应视图操作。

编程用法

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

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

编程用法

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

Display

坐标轴刻度位置,指定为 “Outside”、“Inside” 或 “None”。

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

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

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

编程用法

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

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

  • All” - x 和 y 轴上均显示刻度标签。

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

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

  • None” - 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'

信号数据标记可见性。

  • on” - 对在 Dashboard Scope 上绘制的信号显示数据标记。

  • off” - 对在 Dashboard Scope 上绘制的信号不显示数据标记。

编程用法

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

Style

网格线的颜色。您可以从标准颜色调色板中选择一种颜色,也可以指定自定义颜色。

编程用法

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

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

绘图区域的颜色。您可以从标准颜色调色板中选择一种颜色,也可以指定自定义颜色。

编程用法

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

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

刻度和刻度标签的颜色。您可以从标准颜色调色板中选择一种颜色,也可以指定自定义颜色。

编程用法

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

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

模块特性

数据类型

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

直接馈通

多维信号

可变大小信号

过零检测

扩展功能

在 R2015a 中推出