TimeScopeConfiguration

控制 Scope 模块的外观和行为

说明

Scope 配置属性控制 Scope 模块的外观和行为。使用 get_param 创建一个示波器配置对象，然后使用该对象和圆点表示法更改属性值。

创建对象

myScopeConfiguration = get_param(gcbh,'ScopeConfiguration') 为所选 Scope 模块创建一个示波器配置对象。

属性

Name — 示波器窗口上的标题

模块名称 (默认) | 字符向量 | 字符串标量

示波器窗口上的标题，指定为字符向量或字符串标量。

Position — 示波器的大小和位置

[left bottom width height]

示波器窗口的大小和位置，指定为由左侧、底边、宽度和高度位置组成的四元素向量（以像素为单位）。

默认情况下，示波器窗口出现在屏幕中央，宽度为 560 像素、高度为 420 像素。

Visible — 示波器窗口的可见性

true (default) | false

将此属性设置为 true 可使示波器窗口可见。

OpenAtSimulationStart — 开始仿真时打开示波器

true（Time Scope 的默认值） | false（Scope 的默认值）

将此属性设置为 true 可在仿真开始时打开示波器。

DisplayFullPath — 显示完整路径

false (默认) | true

将此属性设置为 true 可在示波器窗口顶部显示示波器相对于模型的完整路径。如果将此属性设置为 false，则只有 Scope 模块的名称出现在示波器窗口的顶部。

PreserveColorsForCopyToClipboard — 保留复制到剪贴板的颜色

false (默认) | true

将此属性设置为 true 可在将示波器复制到剪贴板时保持示波器的背景颜色和信号颜色。当您将此示波器粘贴到文档或打印此示波器时，上述颜色会保留。如果将此属性设置为 false 并将此示波器复制到剪贴板，则在粘贴或打印此示波器时，上述颜色会更改为环保版本。

NumInputPorts — 输入端口数目

'1'（默认值） | 字符向量

Scope 模块上的输入端口数，指定为字符向量或字符串标量。输入端口的最大数量为 96。

LayoutDimensions — 示波器画面的行数和列数

[1 1]（默认值） | [numberOfRows numberOfColumns]

示波器画面的行数和列数，指定为二元素向量。最大布局维度为 16×16。

• 如果画面数等于端口数，每个端口的信号将单独显示。

• 如果画面数小于端口数，多出的端口信号将显示在最后一个 y 轴上。

SampleTime — 时间间隔

'-1' (默认) | 字符向量 | 字符串标量

在仿真期间 Scope 模块更新的时间间隔，指定为字符向量或字符串标量。此属性不适用于浮动示波器和波形查看器。

FrameBasedProcessing — 基于帧的信号处理

false（Time Scope 模块的默认值） | true（Scope 模块的默认值）

将此属性设置为 true 可按基于帧的方式处理信号。

• false - 按照各时间间隔处理通道中的信号值（基于样本）。

• true - 将通道中的信号值作为一组不同时间间隔的值进行处理（基于帧）。基于帧的处理方式仅对离散输入信号可用。

MaximizeAxes — 将信号图尺寸最大化

'Auto'（默认值） | 'On' | 'Off'

指定是否将信号图尺寸最大化：

• 'Auto' - 如果未指定 Title 和 YLabel，则最大化所有图。

• 'On' - 将所有图最大化。Title 和 YLabel 中的值隐藏。

• 'Off' - 不将图最大化。

每个图都会撑满整个画面。将信号图尺寸最大化将删除图周围的背景区域。

MinimizeControls — 隐藏菜单和工具栏

false（默认值） | true

将此属性设置为 true 可隐藏菜单和工具栏。

如果您停靠示波器，则此属性处于非活动状态。

AxesScaling — 如何缩放 y 轴

'Manual'（默认值） | 'Auto' | 'Updates'

如何缩放 y 轴，指定为下列值之一：

• 'Manual' - 用缩放 Y 轴范围按钮手动缩放 y 轴。

• 'Auto' - 在仿真过程中和仿真后缩放 y 轴。

• 'Updates' - 在模块更新指定次数（时间间隔）后缩放 y 轴。

依存关系

如果此属性设置为 'Updates'，则还要指定属性 AxesScalingNumUpdates

AxesScalingNumUpdates — 缩放 y 轴之前的更新次数

'10'（默认值） | 字符向量 | 字符串标量

缩放 y 轴之前的更新次数，指定为字符向量或字符串标量。

依存关系

通过将 AxesScaling 设置为 'Updates' 来激活此属性。

TimeSpan — 要显示的 x 轴范围的长度

'0'（默认值） | 字符向量 | 字符串标量 | 'Auto'

要显示的 x 轴范围的长度，指定为下列值之一：

• 正实数 - 小于总仿真时间的任何值，指定为字符向量或字符串标量。

• 'Auto' - 仿真开始时间与停止时间之间的时间差。

此模块使用 TimeDisplayOffset 和 TimeSpan 属性来计算 x 轴范围的开始时间和结束时间。例如，如果您将 TimeDisplay 设置为 10 并将 TimeSpan 设置为 20，则示波器将 x 轴范围设置为从 10 到 30。

TimeSpanOverrunAction — 数据的显示方式

'Wrap'（默认值） | 'Scroll'

如何显示超出可见 x 轴范围的数据，指定为下列值之一：

• 'Wrap' - 从左到右全屏绘制数据，之后擦除屏幕，然后再重新开始绘制数据。

• 'Scroll' - 在右侧绘制新数据时，旧数据向左移动。此模式由于有密集的图形操作，可能会影响运行时性能。

只有在由于模型较大或者步长较小而导致绘图速度缓慢时，才能看到此操作的效果。

TimeUnits — 在 x 轴上显示的单位

'Metric'（Time Scope 模块的默认值） | 'None'（Scope 模块的默认值） | 'Seconds'

在 x 轴上显示的单位，指定为下列值之一：

• 'Metric' - 基于 TimeSpan 属性的长度显示时间单位。

• 'None' - 在 x 轴上显示时间。

• 'Seconds' - 在 x 轴上显示时间(秒)。

TimeDisplayOffset — x 轴范围偏移

'0'（默认值） | 字符向量 | 字符串标量

x 轴范围偏移量，指定为字符向量或字符串标量。对于具有多个通道的输入信号，请输入偏移标量或向量。

• 标量 - 按相同的值偏移输入信号的所有通道。

• 向量 - 分别偏移每个通道。

TimeAxisLabels — x 轴标签的显示方式

'All'（Time Scope 模块的默认值） | 'Bottom'（Scope 模块的默认值） | 'None'

x 轴标签的显示方式，指定为下列值之一：

• 'All' - 在所有画面上显示 x 轴标签。

• 'Bottom' - 仅在底部画面上显示 x 轴标签。

• 'None' - 不显示标签并反激活 ShowTimeAxisLabel 属性。

依存关系

在指定此属性之前，需要设置 ActiveDisplay 属性。

将 ShowTimeAxisLabel 设置为 true 并将 Maximize axes 设置为 'Off'。

ShowTimeAxisLabel — 显示或隐藏 x 轴标签

true（Time Scope 模块的默认值） | false（Scope 模块的默认值）

将此属性设置为 true 可显示 x 轴标签。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

如果此属性设置为 true，还要设置 TimeAxisLabels。如果 TimeAxisLabels 设置为 'None'，则此属性处于非活动状态。

ActiveDisplay — 要设置其特定属性的示波器画面

'1' (默认) | 字符向量

要设置其特定属性的示波器画面，指定为字符向量或字符串。视图的编号对应于视图的列位置索引。对于多列布局，显示画面按照先从上至下、再从左至右的顺序进行编号。

依存关系

设置此属性可选择画面并激活其 ShowGrid、ShowLegend、Title、PlotAsMagnitudePhase、YLabel 和 YLimits 属性的设置。

Title — 示波器画面的标题

'%<SignalLabel>'（默认值） | 字符向量 | 字符串标量

显示屏的标题，指定为字符向量或字符串标量。默认值 %<SignalLabel> 使用输入信号名称作为标题。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

ShowLegend — 信号图例

false（默认值） | true

将此属性设置为 true 可显示图例。

图例中列出的名称是来自模型的信号名称。对于有多个通道的信号，信号名称后面会附加一个通道索引。要查看示例，请参阅 Scope 模块参考。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

ShowGrid — 垂直和水平网格线

true（默认值） | false

将此属性设置为 true 可显示垂直和水平网格线。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

PlotAsMagnitudePhase — 幅值图和相位图

false（默认值） | true

指定是否显示幅值图和相位图：

• false - 显示信号图。

  如果信号是复信号，则基于同一 y 轴（画面）绘制实部和虚部。

• true - 显示幅值图和相位图。

  如果信号是实信号，则绘制信号的绝对值作为幅值。正值的相位为 0 度，负值的相位为 180 度。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

YLimits — y 轴的最小值和最大值

[-10 10]（默认值） | [ymin ymax]

y 轴的最小值和最大值，指定为二元素数值向量。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

当 PlotAsMagnitudePhase 为 true 时，此属性指定幅值图的 y 轴范围。相位图的 y 轴范围始终为 [-180 180]。

YLabel — Y 轴标签

''（默认值） | 字符向量 | 字符串标量

当前画面的 y 轴标签，指定为字符向量或字符串标量。

依存关系

在设置此属性之前，需要设置 ActiveDisplay 属性。

如果 PlotAsMagnitudePhase 为 true，则隐藏 YLabel 的值，并且绘图带有 Magnitude 和 Phase 标签。

DataLogging — 保存示波器数据

false（默认值） | true

将此属性设置为 true 可将示波器数据保存到 MATLAB^® 工作区中的一个变量。

此属性不适用于浮动示波器和波形查看器。

依存关系

如果此属性设置为 true，则还必须指定属性 DataLoggingVariableName 和 DataLoggingSaveFormat。

DataLoggingVariableName — 用于保存示波器数据的变量名称

'ScopeData'（默认值） | 字符向量 | 字符串标量

指定一个用于在 MATLAB 工作区中保存波形数据的变量名称，指定为字符向量或字符串标量。此属性不适用于浮动示波器和波形查看器。

依存关系

通过将 DataLogging 设置为 true 来激活此属性。

DataLoggingLimitDataPoints — 限制缓冲的数据

false（默认值） | true

设置为 true 以在绘制和保存数据之前限制缓冲的数据。

对于停止时间设置为 inf 的仿真，始终将此参数设置为 true。

依存关系

如果此属性设置为 true，则还要使用属性 DataLoggingMaxPoints 指定要绘制并保存的数据值的个数。

DataLoggingMaxPoints — 数据值的最大个数

'5000'（默认值） | 字符向量 | 字符串标量

要绘制和保存的数据值的最大个数，指定为字符向量或字符串标量。绘制和保存的数据值来自仿真结束时的数据。例如，将此属性设置为 100 可保存最近的 100 个数据点。

依存关系

通过将 DataLoggingLimitDataPoints 设置为 true 来激活此属性。指定此属性可以限制示波器绘制的数据值，还可以限制在 DataLoggingVariableName 中指定的 MATLAB 变量中保存的数据值。

DataLoggingDecimateData — 减少示波器数据

false（默认值） | true

将此属性设置为 true 可在绘制和保存之前减少示波器数据。

依存关系

如果此属性设置为 true，则还必须指定 DataLoggingDecimation 属性。

DataLoggingDecimation — 抽取因子

'1'（默认值） | 字符向量 | 字符串标量

在绘制和保存之前应用于信号数据的抽取因子，指定为字符向量或字符串标量。示波器将缓冲每第 N 个数据点，其中 N 是您指定的抽取因子。值为 1 将缓冲所有数据值。

依存关系

通过将 DataLoggingDecimateData 设置为 true 来激活此属性。

DataLoggingSaveFormat — 用于保存示波器数据的变量格式

'Dataset'（默认值） | 'Structure With Time' | 'Structure' | 'Array'

用于将示波器数据保存到 MATLAB 工作区的变量格式，指定为下列值之一：

• 'Dataset' - 将数据保存为数据集对象。此格式不支持可变大小数据、MAT 文件日志或外部模式存档。请参阅 Simulink.SimulationData.Dataset。

• 'StructureWithTime' - 将数据保存为带有关联时间信息的结构体。此格式不支持单端口或多端口基于帧的数据，也不支持多速率数据。

• 'Structure' - 将数据保存为结构体。此格式不支持多速率数据。

• 'Array' - 将数据保存为具有关联的时间信息的数组。此格式不支持多端口基于采样的数据、单端口或多端口基于帧的数据、可变大小数据或多速率数据。

此属性不适用于浮动示波器和波形查看器。

依存关系

通过将 DataLogging 设置为 true 来激活此属性。

示例

创建示波器配置对象

此示例使用对 van der Pol 方程建模的 'vdp' 模型创建示波器配置对象。

open_system('vdp')
myScopeConfiguration = get_param('vdp/Scope','ScopeConfiguration');
myScopeConfiguration.NumInputPorts = '2';

版本历史记录

在 R2013a 中推出

另请参阅

Scope | Floating Scope | Time Scope (DSP System Toolbox)

主题

• Control Scope Blocks Programmatically