addDisplays

向滤波器分析器添加新分析显示画面

自 R2024a 起

全页折叠

语法

dispnum = addDisplays(fa)
dispnum = addDisplays(fa,addnum)
addDisplays(___,AnalysisOptions=opts)
addDisplays(___,Name=Value)
addDisplays(___,FilterNames=filtnames)

说明

dispnum = addDisplays(fa) 将新幅值响应分析显示画面添加到滤波器分析器 fa，并返回与新显示画面对应的标识号。

dispnum = addDisplays(fa,addnum) 将 addnum 新幅值响应分析显示画面添加到 fa，并返回其标识号。

addDisplays(___,AnalysisOptions=opts) 将新显示画面的分析选项设置为在 opts 中指定的值。使用 filterAnalysisOptions 创建 opts。

addDisplays(___,Name=Value) 使用名称-值参量设置新显示画面的分析选项。有关可用选项的列表，请参阅 filterAnalysisOptions。以这种方式指定的选项适用于所有新显示画面。您无法同时使用此语法和前一个语法。

addDisplays(___,FilterNames=filtnames) 添加新显示画面并使用在 filtnames 中指定的名称绘制滤波器。

示例

示例

全部折叠

打开实时脚本

启用具有两个滤波器的滤波器分析器。

d1 = designfilt("lowpassiir", ...
    PassbandFrequency=0.25,StopbandFrequency=0.35);
d2 = designfilt("lowpassfir", ...
    PassbandFrequency=0.45,StopbandFrequency=0.55,PassbandRipple=10);

fa = filterAnalyzer(d1,d2,FilterNames=["LP1" "LP2"]);
zoom(fa,"y",[-80 20])

添加一个群延迟显示画面。在新显示画面中绘制滤波器。

addDisplays(fa,Analysis="groupdelay",FilterNames=["LP1" "LP2"])

%addFilters(fa,d1,d2)

为了获得最佳结果，请直接在 MATLAB® 中运行此示例。

输入参数

全部折叠

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

要添加的显示画面的数量，指定为整数。

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

分析选项，指定为 filterAnalysisOptions 对象。如果添加多个显示画面：

  • 要指定应用于所有新显示画面的选项值，请将 opts 指定为 filterAnalysisOptions 对象。

  • 要为每个显示画面指定不同选项值，请将 opts 指定为包含 addnum 个元素的 filterAnalysisOptions 对象的元胞数组。

示例: filterAnalysisOptions("phase") 指定新显示画面显示滤波器相位响应。

示例: filterAnalysisOptions("magnitude",NFFT=2048,FrequencyRange="twosided") 指定新显示画面绘制跨整个单位圆的幅值响应，并使用 2048 个离散傅里叶变换点。

滤波器名称，指定为字符串向量或字符向量元胞数组。滤波器名称是在滤波器分析器的滤波器表中标识不同滤波器的名称。

示例: ["LP_a" "LP_b"]

数据类型: cell | string

输出参量

全部折叠

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

版本历史记录

在 R2024a 中推出

另请参阅

App

对象

函数