Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

TimeScopeConfiguration

控制 Scope 模块的外观和行为

说明

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

创建对象

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

属性

全部展开

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

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

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

依存关系

设置此属性可选择画面并激活其 ShowGridShowLegendTitlePlotAsMagnitudePhaseYLabelYLimits 属性的设置。

如何缩放 y 轴,指定为下列值之一:

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

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

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

依存关系

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

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

依存关系

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

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

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

依存关系

如果此属性设置为 true,则还必须指定属性 DataLoggingVariableNameDataLoggingSaveFormat

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

依存关系

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

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

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

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

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

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

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

依存关系

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

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

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

依存关系

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

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

依存关系

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

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

依存关系

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

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

依存关系

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

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

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

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

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

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

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

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

  • 'Auto' - 如果未指定 TitleYLabel,则最大化所有图。

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

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

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

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

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

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

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

  • false - 显示信号图。

    如果信号是复信号,则基于同一 y 轴(画面)绘制实部和虚部。

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

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

依存关系

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

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

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

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

依存关系

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

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

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

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

依存关系

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

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

依存关系

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

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

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

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

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

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

依存关系

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

依存关系

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

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

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

依存关系

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

如果 PlotAsMagnitudePhasetrue,则隐藏 YLabel 的值,并且绘图带有 MagnitudePhase 标签。

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

依存关系

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

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

示例

全部折叠

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

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

版本历史记录

在 R2013a 中推出

另请参阅

| | (DSP System Toolbox)