showFilters

在滤波器分析器中显示或隐藏滤波器

自 R2024a 起

全页折叠

语法

showFilters(fa,showit)
showFilters(___,Name=Value)
dispnum = showFilters(___)

说明

showFilters(fa,showit) 根据 showit 分别是 true 还是 false 在滤波器分析器 fa 的活动画面上显示或隐藏所有滤波器。如果 showit 是 true 并且没有显示画面，App 会添加一个显示画面并在其上绘制滤波器。如果您只想显示部分滤波器，请使用 FilterNames 来指定要显示哪些滤波器。

示例

除了上述语法中的输入参量之外，showFilters(___,Name=Value) 还使用名称-值参量指定选项。您可以选择要显示或隐藏的滤波器，以及您要在其中显示或隐藏滤波器的显示画面。

示例

dispnum = showFilters(___) 返回新显示画面的标识号（如果 showFilters 添加了一个显示画面）。

示例

全部折叠

打开实时脚本

设计两个低通滤波器，并在滤波器分析器中显示其幅值响应。

d1 = designfilt("lowpassiir", ...
    PassbandFrequency=0.45,StopbandFrequency=0.55);
d2 = designfilt("lowpassiir", ...
    PassbandFrequency=0.25,StopbandFrequency=0.35);
fa = filterAnalyzer(d1,d2,FilterNames=["LP1" "LP2"]);

添加一个显示画面来分析相位响应。将 NFFT 点数设置为 1024。显示滤波器。

phaseDispNum = addDisplays(fa,Analysis="phase",NFFT=1024);
showFilters(fa,true, ...
    FilterNames=["LP1" "LP2"],DisplayNums=phaseDispNum)

从相位响应显示画面中删除滤波器绘图。

showFilters(fa,false,DisplayNums=phaseDispNum)

输入参数

全部折叠

滤波器分析器句柄，指定为 filterAnalyzer 对象。

显示画面选项，指定为逻辑值 0 (false) 或 1 (true)。

数据类型: logical

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

示例: FilterNames=["LP" "HP"],SampleRates=[150 3e3]

要在其上绘制滤波器的显示画面，指定为显示画面编号的向量。如果不指定此参量，滤波器分析器将使用活动画面。使用其他滤波器分析器函数时，使用显示画面标识号来定位显示。标识号出现在 App 绘图区域的上方，在对应于不同显示画面的选项卡上。

示例: [1 4]

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

滤波器名称，指定为字符串向量。滤波器名称是在 App 的滤波器表中用于标识不同滤波器的名称。使用此参量指定要在选定显示画面中显示的滤波器。

示例: ["LPbutter" "LPelliptic"]

数据类型: char | string

输出参量

全部折叠

显示标识号，以整数或整数向量形式返回。如果 showFilters 添加一个以上的显示画面，则 dispnum 是向量。使用其他滤波器分析器函数时，使用显示画面标识号来定位显示。标识号出现在 App 绘图区域的上方，在对应于不同显示画面的选项卡上。

版本历史记录

在 R2024a 中推出

另请参阅

App

对象

函数