Main Content

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

TimeScopeConfiguration

控制 Scope 模块的外观和行为

说明

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

创建对象

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

属性

全部展开

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

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

UI 使用

选择 File > Number of Input Ports

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Active display

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

  • 'Manual' - 用 Scale Y-axis Limits 按钮手动缩放 y 轴。

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

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Main 选项卡上,设置 Axes scaling

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Main 选项卡上,设置 Number of updates

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

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Log data to workspace

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Variable name

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

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

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

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

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

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Save format

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

对于 Stop time 设置为 inf 的仿真,始终将此参数设置为 true

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Limit data points to last

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Limit data points to last 右侧的文本框。

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Decimation

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Logging 选项卡上,设置 Decimation 右侧的文本框。

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

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

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

UI 使用

打开 Configuration Properties。在 Main 选项卡上,设置 Input processing

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

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

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

UI 使用

打开 Configuration Properties。在 Main 选项卡上,选择 Layout 按钮。

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

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

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

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

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

UI 使用

打开 Configuration Properties。在 Main 选项卡上,设置 Maximize Axes

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

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

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

UI 使用

选择 File > Open at Start of Simulation

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

  • false - 显示信号图。

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

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

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Plot signals as magnitude and phase

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

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

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Show grid

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

UI 使用

打开 Configuration Properties。在 Main 选项卡上,设置 Sample Time

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

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Show legend

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

依存关系

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

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

UI 使用

打开 Configuration Properties。在 Time 选项卡上,设置 Show time-axis label

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

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

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

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

依存关系

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

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

UI 使用

打开 Configuration Properties。在 Time 选项卡上,设置 Time-axis labels

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

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

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

UI 使用

打开 Configuration Properties。在 Time 选项卡上,设置 Time display offset

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

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

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

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

UI 使用

打开 Configuration Properties。在 Time 选项卡上,设置 Time span

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

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

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

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

UI 使用

打开 Configuration Properties。在 Time 选项卡上,设置 Time span overrun action

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

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

  • 'None' - 在 x 轴上显示 Time

  • 'Seconds' - 在 x 轴上显示 Time (seconds)

UI 使用

打开 Configuration Properties。在 Time 选项卡上,设置 Time units

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

依存关系

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Title

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

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

依存关系

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

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Y-label

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

依存关系

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

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

UI 使用

打开 Configuration Properties。在 Display 选项卡上,设置 Y-limits (Minimum)Y-limits (Maximum)

示例

创建示波器配置对象

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

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

另请参阅

| | (DSP System Toolbox)

在 R2013a 中推出