dsp。ArrayPlot

显示向量或数组

展开全部页面

描述

显示向量或数组，其中数据沿x设在。

阵列绘图对象窗口

创建

语法

Scope = dsp。ArrayPlot

scope = dsp.ArrayPlot(Name=Value)

描述

例子

Scope = dsp。ArrayPlot创建一个Array Plot对象，范围．

scope = dsp.ArrayPlot(Name=Value)使用一个或多个名称-值对设置属性。例如,scope = dsp.ArrayPlot(NumInputPorts=3)

属性

全部展开

中的大多数属性都可以更改dsp。ArrayPlotUI。

情节的配置

`NumInputPorts`- - - - - -输入端口数量
`1`(默认)|在[1,96]之间的整数

输入端口数，指定为正整数。每个通过单独输入的信号都成为作用域中的单独通道。必须使用与此属性值相同数量的输入调用作用域。

`XDataMode`- - - - - -来源x拼间距
`“样本增量和x偏移量”`(默认)|`“自定义”`

属性指定是否使用SampleIncrement而且XOffset属性值来确定间距，或指定自己的自定义间距。如果你指定“自定义”时，还必须指定CustomXData属性值。

只能在创建对象时设置此属性。

作用域窗口使用

打开情节选项卡上,单击设置，并设置x数据模式．

数据类型:字符|字符串

`CustomXData`- - - - - -x数据值
空向量(默认)|向量

指定所需的x-data值作为长度等于单个输入帧长度的行或列向量。如果使用默认(空向量)值，则x-data均匀间隔，设置为(0:l1),l是帧长。

只能在创建对象时设置此属性。

例子:scope = dsp.ArrayPlot(XDataMode="Custom"，CustomXData=logspace(0,log10(44100/2)，1024))

作用域窗口使用

打开情节选项卡上,单击设置，并设置x数据模式来自定义并指定自定义x数据．

依赖

要使用此属性，请设置XDataMode来“自定义”．

`SampleIncrement`- - - - - -输入的样本增量
`1`(默认)|有限数值标量

指定样品之间的间距沿x-axis作为有限数值标量。输入信号为y设在数据。x的参数自动设置XOffset而且SampleIncrement属性。

例子:当XOffset是0而且SampleIncrement是1,x-轴的值设置为0,1,2,3,4，…．

例子:当XOffset是－1而且SampleIncrement是０．２５,x-轴的值设置为-1， -0.75， -0.5， -0.25, 0，…．

作用域窗口使用

打开情节选项卡上,单击设置，并设置样本增量．

依赖

要使用此属性，请设置XDataMode来'样本增量和x偏移量'．

`XOffset`- - - - - -显示x轴偏移量
`0`(默认)|标量

显示偏移量x-axis，指定为数值标量。x的参数自动设置SampleIncrement而且XOffset值。的第一个值x设在。

例子:当XOffset是0并且SampleIncrement是1x-轴的值设置为0,1,2,3,4，... .

例子:当XOffset是-1和SampleIncrement等于0.25x设在值设置为1,-0.75,-0.5,-0.25,0,……。

作用域窗口使用

打开情节选项卡上,单击设置，并设置x．

依赖

要使用此属性，请设置XDataMode来“样本增量和x偏移量”．

`XScale`- - - - - -x轴刻度
`“线性”`(默认)|`“日志”`

的规模是否x设在是“线性”或“日志”．如果XOffset是否为负值，您不能将此属性设置为“日志”．

作用域窗口使用

打开情节选项卡上,单击设置，并设置XScale．

数据类型:字符|字符串

`YScale`- - - - - -的规模y设在
`“线性”`(默认)|`“日志”`

的规模是否y设在是“线性”或“日志”．

作用域窗口使用

打开情节选项卡上,单击设置，并设置YScale．

数据类型:字符|字符串

`PlotType`- - - - - -地块控制类型
`“干细胞”`(默认)|`“行”`|`“楼梯”`

指定用于范围窗口中显示的所有输入信号的绘图类型:

“干细胞”-瞄准镜将输入信号显示为带有垂直直线的圆，向下延伸到x-轴在每个采样值处。
“行”-示波器将输入信号显示为连接每个采样值的线。
“楼梯”-示波器将输入信号显示为阶梯图。阶梯图只由水平线和垂直线组成。每条水平线表示一个离散采样周期的信号值，并连接到两条垂直线。每条垂直线代表一个样本值的变化。阶梯图用于绘制数字采样数据的时间历史图。

作用域窗口使用

打开设置并设置情节类型．

`AxesScaling`- - - - - -坐标轴缩放模式
`“OnceAtStop”`(默认)|`“汽车”`|`“手动”`|`“更新”`

指定作用域何时缩放坐标轴。有效值为:

“汽车”-范围根据需要缩放轴以适应数据，无论是在模拟过程中还是在模拟之后。
“手动”-瞄准镜不会自动缩放坐标轴。
“OnceAtStop”-当模拟停止时，瞄准镜缩放坐标轴。
“更新”-在一组视觉更新后，范围缩放轴一次。的值决定更新的次数AxesScalingNumUpdates财产。

只能在创建对象时设置此属性。

作用域窗口使用

将鼠标悬停在数组绘图上以查看缩放,潘，和自动缩放按钮。您还可以使用鼠标缩放和平移。

数据类型:字符|字符串

`AxesScalingNumUpdates`- - - - - -伸缩前的更新数量
One hundred.(默认)|实正整数

将缩放前的更新数量指定为一个真实的正标量整数。

依赖

若要启用此属性，请设置AxesScaling来“更新”．

数据类型:双

测量

`MeasurementChannel`- - - - - -要获取测量值的通道
`1`(默认)|正整数

要获取测量值的通道，指定为范围[1]内的正整数N),N是输入通道的数量。

作用域窗口使用

单击测量选项卡上的“阵列图”工具条。在通道部分，选择通道．

数据类型:双

`CursorMeasurements`- - - - - -光标测量
`CursorMeasurementsConfiguration`对象

光标测量值用于显示屏幕或波形光标，指定为CursorMeasurementsConfiguration对象。

所有CursorMeasurementsConfiguration属性是可调的。

作用域窗口使用

单击测量选项卡上的“阵列图”工具条，并修改游标部分。

`PeakFinder`- - - - - -寻峰器测量
`PeakFinderConfiguration`对象

峰值查找器测量来计算和显示最大的计算峰值，指定为aPeakFinderConfiguration对象。

所有PeakFinderConfiguration属性是可调的。

作用域窗口使用

单击测量选项卡上的“阵列图”工具条，并修改峰值查找器测量值山峰部分。

`SignalStatistics`- - - - - -信号统计测量
`SignalStatisticsConfiguration`对象

信号统计测量，计算和显示信号统计，指定为SignalStatisticsConfiguration对象。

所有SignalStatisticsConfiguration属性是可调的。

作用域窗口使用

单击测量选项卡上的“阵列图”工具条，并修改统计数据部分。

可视化

`的名字`- - - - - -窗口名称
`“阵图”`(默认)|特征向量|字符串标量

指定作用域的名称。此名称作为作用域图形窗口的标题出现。要指定范围图的标题，请使用标题财产。

数据类型:字符|字符串

`位置`- - - - - -范围窗口的位置和大小(像素)
屏幕中心(默认)|`[左下宽高]`

指定范围窗口的大小和位置(以像素为单位)为窗体的四元素向量[左下宽高]．默认情况下，作用域窗口显示在屏幕的中央，宽度为800像素，高度为450像素。此属性的默认值可能会根据屏幕分辨率而变化。

`MaximizeAxes`- - - - - -最大化轴控制
`“汽车”`(默认)|`“上”`|`“关闭”`

指定是否以最大化轴模式显示作用域。在此模式下，轴将展开以适应整个显示。为了节省空间，标签不会出现在每个显示中。取而代之的是，标记值出现在绘制的数据上方。您可以选择以下选项之一:

“汽车”-只有当标题而且YLabel属性对于每个显示都是空的。如果在任何显示中为这些属性中的任何一个输入任何值，坐标轴都不会最大化。
“上”-轴在所有显示中显示为最大化。中输入的任何值标题而且YLabel属性是隐藏的。
“关闭”-没有一个轴出现最大化。

作用域窗口使用

将鼠标悬停在数组绘图上可以看到最大化轴按钮．

数据类型:字符|字符串

`标题`- - - - - -显示标题
`”`(默认)|特征向量|字符串标量

将显示标题指定为字符向量或字符串。

作用域窗口使用

打开情节选项卡上,单击设置，并设置标题．

数据类型:字符|字符串

`ShowLegend`- - - - - -显示的传说
`假`(默认)|`真正的`

若要显示带有输入名称的图例，请将此属性设置为真正的．

从图例中，您可以控制哪些信号可见。控件中的可见性更改风格对话框。在作用域图例中，单击一个信号名称以在作用域中隐藏该信号。要显示信号，请再次单击信号名称。若要只显示一个信号，请右键单击信号名称。显示所有信号，按Esc．

请注意

图例只显示前20个信号。任何附加信号都不能从图例中查看或控制。

作用域窗口使用

在情节选项卡上,单击传说．

数据类型:逻辑

`ChannelNames`- - - - - -通道名称
空单元(默认)|字符向量的单元格数组|字符串数组

将输入通道名称指定为字符向量的单元格数组或字符串数组。名字出现在图例中，设置,测量面板。如果不指定名称，则通道被标记为通道1，通道2等。

依赖

要查看通道名称，请设置ShowLegend来真正的．

数据类型:字符

`ShowGrid`- - - - - -显示网格
`真正的`(默认)|`假`

将此属性设置为真正的在图上显示网格线。

作用域窗口使用

打开情节选项卡上,单击设置，并选择网格．

`PlotAsMagnitudePhase`- - - - - -将信号绘制为幅值和相位
`假`(默认)|`真正的`

真正的-示波器将输入信号的幅度和相位绘制在同一活动显示器内的两个独立轴上。
假-示波器将输入信号的实部和虚部绘制在同一活动显示器内的两个独立轴上。

这个属性对于复值输入信号很有用。打开此属性将影响实值输入信号的相位。当输入信号的幅值为非负时，相位为0度。当输入信号的幅值为负时，相位为180度。

作用域窗口使用

在情节选项卡，选择级阶段按钮。

`包含`- - - - - -x设在标签
`＂＂`(默认)|特征向量|字符串标量

控件下面显示的范围的文本x设在。

作用域窗口使用

打开情节选项卡上,单击设置，并设置包含．

数据类型:字符|字符串

`YLabel`- - - - - -y设在标签
`“振幅”`(默认)|特征向量|字符串标量

属性左侧显示的范围的文本y设在。

依赖关系

此属性仅适用于PlotAsMagnitudePhase是假．当PlotAsMagnitudePhase是真正的，二y-axis标签是只读值“级”而且“阶段”，分别为幅值图和相位图。

作用域窗口使用

打开情节选项卡上,单击设置，并设置YLabel．

数据类型:字符|字符串

`YLimits`- - - - - -y设在限制
`(-10年,10)`(默认)|`[ymin, ymax]`

指定y-轴限制为两元数值向量，[ymin, ymax]．

如果PlotAsMagnitudePhase是假，默认为(-10年,10)．如果PlotAsMagnitudePhase是真正的，默认为[0, 10]．

依赖关系

当PlotAsMagnitudePhase是真正的，此属性指定y-轴限制仅为幅度图。的y相图的-轴极限总是[-180180]．

作用域窗口使用

打开情节选项卡上,单击设置，并设置轴的限制作为一个两元数值向量。

使用

语法

范围(信号)

范围(signalN signal1, signal2,…)

描述

例子

范围(信号）在阵列图中显示信号。

范围(signalN signal1, signal2,…)在阵列图中显示多个信号。信号可以有不同数量的通道和不同的帧长。

输入参数

全部展开

`信号`- - - - - -输入信号或信号可视化
标量|向量|矩阵

中指定要可视化的一个或多个输入信号dsp。ArrayPlot．信号可以有不同数量的通道和不同的帧长。

例子:范围(signal1 signal2)

用户界面定制

要自定义阵列图上信号的样式，请打开设置并使用底部一行选项选择信号并修改样式、宽度、颜色和标记类型。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|fi

对象的功能

要使用对象函数，请将对象指定为第一个输入参数。

`generateScript`	生成MATLAB脚本使用当前设置创建作用域
`隐藏`	隐藏范围窗口
`显示`	显示范围窗口
`isVisible`	确定范围的可见性
`一步`	运行系统对象算法
`释放`	释放资源并允许更改系统对象属性值和输入特征
`重置`	重置的内部状态系统对象

如果希望从头重新启动模拟，请调用重置清除范围窗口显示。不要打电话重置后调用释放．

例子

全部折叠

绘制高斯分布

打开实时脚本

创建一个新的Array Plot对象。

scope = dsp.ArrayPlot;

为高斯分布配置Array Plot对象的属性。

范围。YLimits = [0 1];范围。XOffset = -2.5;范围。SampleIncrement = 0.1;范围。标题=“正态分布”；范围。包含=“X”；范围。YLabel=“f (X)”；

调用Array Plot对象来绘制高斯分布。

(范围(exp() - -2.5: .1:2.5。* (-2.5:.1:2.5)))

你可以缩放y轴来显示对数刻度的图形。

发布范围(范围)。YScale =“日志”；(范围(exp() - -2.5: .1:2.5。* (-2.5:.1:2.5)))

改变滤波器权重图

打开脚本

查看阵列图上的最小均方(LMS)自适应滤波器权重。观察滤波器权重的变化，因为它们适应过滤一个有噪声的输入信号。

创建一个LMS自适应过滤器系统对象™。

lmsFilter = dsp。lMSFilter(40,Method=“归一化LMS”，.．.StepSize = 0.002);

创建和配置dsp。AudioFileReader对象从指定的音频文件中读取输入信号。

signalSource = dsp。AudioFileReader (“dspafxf_8000.wav”，.．.SamplesPerFrame = 40,.．.PlayCount =正无穷,.．.OutputDataType =“替身”）;

创建和配置dsp。FIRFilter系统对象过滤随机白噪声，创建彩色噪声。

firFilter = dsp.FIRFilter(分子=fir1(39,0.25));

创建和配置dsp。ArrayPlot对象显示自适应筛选器权重。

Scope = dsp。ArrayPlot (包含=“过滤阀”，.．.YLabel =“过滤”，.．.YLimits = (-0.05 - 0.2) ');

绘制LMS滤波器权重，因为它们适应所需的信号。从音频文件中读取，产生随机数据，并对随机数据进行过滤。更新过滤器权重并绘制过滤器权重。

Numplays = 0;而numplays < 3 [y, eof] = signalSource();噪声= rand(40,1);noisefilt = firFilter(噪音);Desired = y + noisefilt;[~， ~， wts] = lmsFilter(noise,desired);范围(wts);Numplays = Numplays + eof;结束

多路正弦信号的功率谱

打开脚本

计算多通道正弦信号的功率谱dsp。SpectrumEstimator系统对象™。方法可以得到估计频谱的频率向量getFrequencyVector函数。若要计算估计的分辨率带宽(RBW)，请使用getRBW函数。

生成一个采样频率为1khz的三通道正弦信号。指定100hz、200hz和300hz的正弦频率。第二个和第三个通道的相位与第一个通道相抵消 $\π/ 2美元$ 而且 $\π/ 4美元$ ,分别。

sinessignal = dsp。SineWave (“SamplesPerFrame”, 1000,“SampleRate”, 1000,.．.“频率”，[100 200 300]，“PhaseOffset”，[0 pi/2 pi/4]);

估计并绘制信号的单边频谱。使用dsp。SpectrumEstimator对象进行计算dsp。ArrayPlot为了绘图。

估计器= dsp。SpectrumEstimator (“FrequencyRange”，“单向的”）;绘图仪= dsp。ArrayPlot (“PlotType”，“行”，“YLimits”, 0.75 [0],.．.“YLabel”，功率谱(瓦特)，“包含”，的频率(赫兹)）;

逐步获取数据流，并显示三个通道的光谱。

y = sinessignal ();PXX =估计量(y);绘图仪(pxx)

方法获取频谱以Hz为单位估计的频率向量getFrequencyVector函数。

f = getFrequencyVector(estimator);

计算估计的分辨率带宽(RBW)getRBW函数。

rbw = getRBW(估计量)

RBW = 0.0015

信号功率谱的分辨率带宽为0.0015 Hz。这个频率是频谱上可以分辨的最小频率。

噪声正弦波的功率和最大保持谱

打开脚本

请注意:如果您正在使用R2016a或更早的版本，请将对对象的每个调用替换为等效的调用一步语法。例如,obj (x)就变成了步骤(obj, x)．

产生一个正弦波。

sineWave = dsp。SineWave (“频率”, 100,.．.“SampleRate”, 1000,.．.“SamplesPerFrame”, 1000);

使用频谱估计器计算正弦波的功率谱和最大保持谱。使用阵列图显示光谱。

SE = dsp。SpectrumEstimator (.．.“SampleRate”, sineWave。SampleRate,.．.“SpectrumType”，“权力”，“PowerUnits”，dBm的，.．.“FrequencyRange”，“中心”，.．.“OutputMaxHoldSpectrum”,真正的);绘图仪= dsp。ArrayPlot (“PlotType”，“行”，.．.“XOffset”, -500,.．.“YLimits”, 30 [-60],.．.“标题”，“100赫兹正弦波功率谱”，.．.“YLabel”，功率谱(dBm)，.．.“包含”，的频率(赫兹)）;

在正弦波中加入随机噪声。输入数据流，并绘制信号的功率谱。

为ii = 1:10 x =正弦波()+ 0.05*randn(1000,1);[Pxx,Pmax] = SE(x);绘图仪([Pxx Pmax])结束

提示

要关闭“阵列图”窗口并清除其相关数据，请使用MATLAB^®清晰的函数。
要隐藏或显示“数组绘图”窗口，请使用隐藏而且显示功能。

扩展功能

C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。

使用注意事项和限制:

金宝app通过将对对象的调用视为外部调用来支持MEX代码生成。不支持独立应用程序金宝app的代码生成。
看到系统对象在MATLAB代码生成(MATLAB编码器)．

版本历史

在R2013a中引入

全部展开

R2022b:通道名支持字符串数组金宝app

从R2022b开始，您可以指定ChannelNames的属性dsp。ArrayPlot对象作为字符串数组。

Ap = dsp。ArrayPlot (ChannelNames = (“输入”，“噪声输出”]);

另请参阅

对象

dsp。MatrixViewer|timescope|简介|dsp。logicAnalyzer|dsp。DynamicFilterVisualizer

块

数组的阴谋

dsp。ArrayPlot

描述

创建

语法

描述

属性

情节的配置

NumInputPorts- - - - - -输入端口数量1(默认)|在[1,96]之间的整数

XDataMode- - - - - -来源x拼间距“样本增量和x偏移量”(默认)|“自定义”

作用域窗口使用

CustomXData- - - - - -x数据值空向量(默认)|向量

作用域窗口使用

依赖

SampleIncrement- - - - - -输入的样本增量1(默认)|有限数值标量

作用域窗口使用

依赖

XOffset- - - - - -显示x轴偏移量0(默认)|标量

作用域窗口使用

依赖

XScale- - - - - -x轴刻度“线性”(默认)|“日志”

作用域窗口使用

YScale- - - - - -的规模y设在“线性”(默认)|“日志”

作用域窗口使用

PlotType- - - - - -地块控制类型“干细胞”(默认)|“行”|“楼梯”

作用域窗口使用

AxesScaling- - - - - -坐标轴缩放模式“OnceAtStop”(默认)|“汽车”|“手动”|“更新”

作用域窗口使用

AxesScalingNumUpdates- - - - - -伸缩前的更新数量One hundred.(默认)|实正整数

依赖

测量

MeasurementChannel- - - - - -要获取测量值的通道1(默认)|正整数

作用域窗口使用

CursorMeasurements- - - - - -光标测量CursorMeasurementsConfiguration对象

作用域窗口使用

PeakFinder- - - - - -寻峰器测量PeakFinderConfiguration对象

作用域窗口使用

SignalStatistics- - - - - -信号统计测量SignalStatisticsConfiguration对象

作用域窗口使用

可视化

的名字- - - - - -窗口名称“阵图”(默认)|特征向量|字符串标量

位置- - - - - -范围窗口的位置和大小(像素)屏幕中心(默认)|[左下宽高]

MaximizeAxes- - - - - -最大化轴控制“汽车”(默认)|“上”|“关闭”

作用域窗口使用

标题- - - - - -显示标题”(默认)|特征向量|字符串标量

作用域窗口使用

ShowLegend- - - - - -显示的传说假(默认)|真正的

作用域窗口使用

ChannelNames- - - - - -通道名称空单元(默认)|字符向量的单元格数组|字符串数组

依赖

ShowGrid- - - - - -显示网格真正的(默认)|假

作用域窗口使用

PlotAsMagnitudePhase- - - - - -将信号绘制为幅值和相位假(默认)|真正的

作用域窗口使用

包含- - - - - -x设在标签＂＂(默认)|特征向量|字符串标量

作用域窗口使用

YLabel- - - - - -y设在标签“振幅”(默认)|特征向量|字符串标量

依赖关系

作用域窗口使用

YLimits- - - - - -y设在限制(-10年,10)(默认)|[ymin, ymax]

依赖关系

作用域窗口使用

使用

语法

描述

输入参数

信号- - - - - -输入信号或信号可视化标量|向量|矩阵

用户界面定制

对象的功能

例子

绘制高斯分布

改变滤波器权重图

多路正弦信号的功率谱

噪声正弦波的功率和最大保持谱

提示

扩展功能

C/ c++代码生成使用MATLAB®Coder™生成C和c++代码。

版本历史

R2022b:通道名支持字符串数组金宝app

另请参阅

对象

`NumInputPorts`- - - - - -输入端口数量
`1`(默认)|在[1,96]之间的整数

`XDataMode`- - - - - -来源x拼间距
`“样本增量和x偏移量”`(默认)|`“自定义”`

`CustomXData`- - - - - -x数据值
空向量(默认)|向量

`SampleIncrement`- - - - - -输入的样本增量
`1`(默认)|有限数值标量

`XOffset`- - - - - -显示x轴偏移量
`0`(默认)|标量

`XScale`- - - - - -x轴刻度
`“线性”`(默认)|`“日志”`

`YScale`- - - - - -的规模y设在
`“线性”`(默认)|`“日志”`

`PlotType`- - - - - -地块控制类型
`“干细胞”`(默认)|`“行”`|`“楼梯”`

`AxesScaling`- - - - - -坐标轴缩放模式
`“OnceAtStop”`(默认)|`“汽车”`|`“手动”`|`“更新”`

`AxesScalingNumUpdates`- - - - - -伸缩前的更新数量
One hundred.(默认)|实正整数

`MeasurementChannel`- - - - - -要获取测量值的通道
`1`(默认)|正整数

`CursorMeasurements`- - - - - -光标测量
`CursorMeasurementsConfiguration`对象

`PeakFinder`- - - - - -寻峰器测量
`PeakFinderConfiguration`对象

`SignalStatistics`- - - - - -信号统计测量
`SignalStatisticsConfiguration`对象

`的名字`- - - - - -窗口名称
`“阵图”`(默认)|特征向量|字符串标量

`位置`- - - - - -范围窗口的位置和大小(像素)
屏幕中心(默认)|`[左下宽高]`

`MaximizeAxes`- - - - - -最大化轴控制
`“汽车”`(默认)|`“上”`|`“关闭”`

`标题`- - - - - -显示标题
`”`(默认)|特征向量|字符串标量

`ShowLegend`- - - - - -显示的传说
`假`(默认)|`真正的`

`ChannelNames`- - - - - -通道名称
空单元(默认)|字符向量的单元格数组|字符串数组

`ShowGrid`- - - - - -显示网格
`真正的`(默认)|`假`

`PlotAsMagnitudePhase`- - - - - -将信号绘制为幅值和相位
`假`(默认)|`真正的`

`包含`- - - - - -x设在标签
`＂＂`(默认)|特征向量|字符串标量

`YLabel`- - - - - -y设在标签
`“振幅”`(默认)|特征向量|字符串标量

`YLimits`- - - - - -y设在限制
`(-10年,10)`(默认)|`[ymin, ymax]`

`信号`- - - - - -输入信号或信号可视化
标量|向量|矩阵

C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。