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'
(默认值) | 字符向量 | 字符串标量
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
来激活此属性。
示例
版本历史记录
在 R2013a 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)