TimeScopeConfiguration

控制 Scope 模块的外观和行为

全页展开

说明

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

创建对象

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

属性

全部展开

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

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

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

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

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

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

波形查看器不支持此属性。

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

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

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

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

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

  • 如果显示画面的数量大于端口数量，示波器会创建空图块。

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

将此属性设置为 true 以将输入的每列作为独立通道处理（基于帧的处理）。基于帧的处理方式仅对离散输入信号可用。

将此属性设置为 false 以将输入的每个元素作为独立通道处理（基于采样的处理）。

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

  • 'Auto' - 如果未指定 Title 和 YLabel，则最大化所有图。如果其中一个绘图具有用户定义的标题或 y 轴标签，则 MaximizeAxes 属性将设置为 'Off'。

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

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

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

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

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

缩放 y 轴的方法，指定为下列值之一：

  • 'Manual' - 使用 YLimits 属性或示波器显示画面上的平移和缩放操作手动缩放 y 轴。

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

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

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

依赖关系

要启用此属性，请将 AxesScaling 设置为 'Updates'。

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

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

  • 'One frame period' - 使用输入信号的帧周期。此选项仅在 FrameBasedProcessing 属性设置为 true 时可用。

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

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

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

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

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

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

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

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

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

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

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

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

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

x 轴标签的显示位置，指定为以下选项之一：

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

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

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

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

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

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

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

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

特定于显示画面的属性包括 ShowGrid、ShowLegend、Title、PlotAsMagnitudePhase、YLabel 和 YLimits。

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

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

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

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

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

将此属性设置为 true 以在活动画面上显示垂直和水平网格线。

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

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

  • false - 显示信号图。

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

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

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

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

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

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

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

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

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

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

将此属性设置为 true 可将示波器数据保存到 MATLAB® 工作区中的一个变量。此属性不适用于浮动示波器和波形查看器。

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

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

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

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

依赖关系

要启用此属性，请将 DataLogging 设置为 true。

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

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

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

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

依赖关系

要启用此属性，请将 DataLoggingLimitDataPoints 设置为 true。指定此属性可以限制示波器绘制的数据值，还可以将其保存在 DataLoggingVariableName 中指定的 MATLAB 变量中。

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

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

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

依赖关系

要启用此属性，请将 DataLoggingDecimateData 设置为 true。

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

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

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

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

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

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

依赖关系

要启用此属性，请将 DataLogging 设置为 true。

示例

全部折叠

打开脚本

此示例使用对范德波尔方程建模的 'vdp' 模型创建示波器配置对象。

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

版本历史记录

在 R2013a 中推出

另请参阅

| | (DSP System Toolbox)

主题