showUserDefinedMask

在滤波器分析器中显示或隐藏用户定义的频谱模板

自 R2024a 起

全页折叠

语法

showUserDefinedMask(fa,showit,mask)
showUserDefinedMask(___,DisplayNums=dispnums)

说明

showUserDefinedMask(fa,showit,mask) 根据 showit 分别是 true 还是 false 在滤波器分析器 fa 中的活动画面上显示或隐藏用户定义的频谱模板 mask。

  • 要使 App 显示模板，您必须将 fa 的 Analysis 参量指定为 "magnitude" 或 "magestimate"。不能指定叠加分析。

示例

showUserDefinedMask(___,DisplayNums=dispnums) 支持上述语法中的参量，且可指定要在其上显示或隐藏模板的显示画面 dispnums。

示例

全部折叠

打开实时脚本

设计一个低通滤波器并在滤波器分析器中显示它。定义一个模板，该模板指定在 DC 和 0.45π 弧度/采样点处的值为 0 dB，在 0.55π 弧度/采样点和奈奎斯特频率时值为 -40 dB。

d1 = designfilt("lowpassfir", ...
    PassbandFrequency=0.45,StopbandFrequency=0.55);
fa = filterAnalyzer(d1);

mask = [[0 0.45 0.55 1]' [0 0 -40 -40]'];
showUserDefinedMask(fa,true,mask)

隐藏模板。

showUserDefinedMask(fa,false)

输入参数

全部折叠

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

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

数据类型: logical

用户定义的模板，指定为由有限数值组成的两列矩阵。

  • mask 的第一列包含归一化的频率值，单位为弧度/采样点。

  • mask 的第二列包含在第一列中指定频率下的幅值，单位为 dB。

如果 showit 是 false，则必须省略此参量。

示例: [[0 0.45 0.55 1]' [0 0 -40 -40]']

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

要在其上切换用户定义的模板的显示画面，指定为整数或整数向量。如果不指定此参量，则滤波器分析器会在活动画面中切换用户定义的模板。标识号出现在 App 绘图区域的上方，在对应于不同显示画面的选项卡上。

示例: [1 5]

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

版本历史记录

在 R2024a 中推出

另请参阅

App

对象

函数