filterAnalysisOptions

滤波器分析选项

自 R2024a 起

全页展开

说明

filterAnalysisOptions 指定滤波器分析器中显示的滤波器的分析选项。

创建对象

语法

opts = filterAnalysisOptions
opts = filterAnalysisOptions(analysis)
opts = filterAnalysisOptions(analysis,overlay)
opts = filterAnalysisOptions(___,PropertyName=Value)

描述

opts = filterAnalysisOptions 返回包含幅值响应分析选项的对象。使用 opts 为滤波器分析器指定分析选项。

opts = filterAnalysisOptions(analysis) 返回用于指定的分析类型的滤波器分析选项。analysis 设置 Analysis 属性。

示例

opts = filterAnalysisOptions(analysis,overlay) 返回用于指定的分析和叠加分析类型的滤波器分析选项。overlay 设置 OverlayAnalysis 属性。

opts = filterAnalysisOptions(___,PropertyName=Value) 支持上述语法中的任何输入参量组合，且可使用一个或多个名称-值参量指定属性。

输入参量

全部展开

分析类型，指定为以下选项之一：

  • 频域分析：

    • "magnitude" - 幅值响应

    • "phase" - 相位响应

    • "groupdelay" - 群延迟响应

    • "phasedelay" - 相位延迟响应

    • "magestimate" - 幅值响应估计

    • "noisepsd" - 噪声功率谱密度 (PSD)

  • 时域分析：

    • "impulse" - 冲激响应

    • "step" - 阶跃响应

  • 其他分析：

    • "polezero" - 零极点图

    • "info" - 滤波器信息

    • "coefficients" -滤波器系数

您还可以将 analysis 指定为名称-值参量：filterAnalysisOptions(Analysis=analysis) 等效于 filterAnalysisOptions(analysis)。

有关详细信息，请参阅 Analysis。

叠加分析，指定为字符串。

  • 如果将 analysis 设置为频域分析，则 overlay 也必须为频域分析。

  • 如果将 analysis 设置为时域分析，则 overlay 也必须为时域分析。

  • analysis 和 overlay 必须设置为不同值。

  • 如果将 analysis 设置为 "polezero"、"info" 或 "coefficients"，则不支持此参量。

您还可以将 overlay 指定为名称-值参量：filterAnalysisOptions(Analysis=analysis,OverlayAnalysis=overlay) 等效于 filterAnalysisOptions(analysis,overlay)。

属性

全部展开

分析类型

分析类型，指定为以下选项之一：

  • 频域分析：

    • "magnitude" - 幅值响应

    • "phase" - 相位响应

    • "groupdelay" - 群延迟响应

    • "phasedelay" - 相位延迟响应

    • "magestimate" - 幅值响应估计

    • "noisepsd" - 噪声功率谱密度 (PSD)

  • 时域分析：

    • "impulse" - 冲激响应

    • "step" - 阶跃响应

  • 其他分析：

    • "polezero" - 零极点图

    • "info" - 滤波器信息

    • "coefficients" -滤波器系数

有关详细信息，请参阅滤波器分析器页上的分析。

叠加分析，指定为字符串标量或字符向量。

  • 如果将 Analysis 设置为频域分析，则 OverlayAnalysis 也必须为频域分析。

  • 如果将 Analysis 设置为时域分析，则 OverlayAnalysis 也必须为时域分析。

  • Analysis 和 OverlayAnalysis 必须设置为不同值。

  • 如果将 Analysis 设置为 "polezero"、"info" 或 "coefficients"，则不支持此参量。

有关详细信息，请参阅滤波器分析器页上的分析。

数据类型: char | string

频率归一化和采样率

频率归一化模式，指定为以下选项之一：

  • "normalized" - App 根据每个输入滤波器的采样率对其响应进行归一化，并使用以弧度/采样点表示的归一化频率计算响应。

  • "unnormalized" - App 计算以赫兹表示的周期性频率中的响应。对于没有采样率的滤波器，App 假设采样率为 1 Hz。

  • "auto" - 如果正在分析的所有滤波器都具有指定的采样率，则 App 使用 "unnormalized" 模式，否则使用 "normalized" 模式。

数据类型: char | string

参考采样率选择模式，指定为以下选项之一：

  • "max" - App 使用显示画面中所有正在分析的滤波器的最大采样率。

  • "specify" - 使用 ReferenceSampleRate 属性指定采样率值。

如果将 FrequencyNormalizationMode 设置为 "normalized"，则此属性不适用。

数据类型: char | string

参考采样率，指定为正标量。该 App 使用指定的参考采样率来对滤波器响应进行归一化，并定义分析滤波器的总体奈奎斯特范围。仅当您将 ReferenceSampleRateMode 设置为 "specify" 时，此属性才适用。

示例: 44.1e3

数据类型: double

频域分析

分析频率范围，指定为以下选项之一：

  • "onesided" - App 在使用归一化频率时计算范围 [0, π) 内的响应，在使用非归一化频率时计算范围 [0, referenceSampleRate/2) 内的响应。

  • "twosided" - App 在使用归一化频率时计算范围 [0, 2π) 内的响应，在使用非归一化频率时计算范围 [0, referenceSampleRate) 内的响应。

  • "centered" - App 在使用归一化频率时计算范围 [–π, π) 内的响应，在使用非归一化频率时计算范围 [–referenceSampleRate/2, referenceSampleRate/2) 内的响应。当您将 FrequencyScale 设置为 "log" 时，此选项不适用。

  • "freqvector" - App 计算使用 FrequencyVector 指定的频率点处的响应。

  • "auto" - 如果显示画面中所有正在分析的滤波器都具有实数值系数，App 将计算单边响应；如果有至少一个滤波器具有复数值系数，App 将计算双边响应。

数据类型: char | string

用于计算滤波器响应的离散傅里叶变换点数，指定为正整数。当您将 FrequencyRange 设置为 "freqvector" 时，此属性不适用。

示例: 1024

数据类型: double

用于可视化滤波器响应的频率刻度，线性频率刻度指定为 "linear"，对数频率刻度指定为 "log"。如果将 FrequencyRange 设置为 "centered"，则 "log" 选项不适用。

数据类型: char | string

计算滤波器的频率向量，指定为有限实数值向量。如果您将 FrequencyVectorUnits 设置为 "normalized"，分析器会假设向量的单位为弧度/采样点。否则，它采用选定单位的向量。

仅当您将 FrequencyRange 设置为 "freqvector" 时，此属性才适用。当您将 Analysis 或 OverlayAnalysis 设置为 "magestimate" 或 "noisepsd" 时，此属性不受支持。

示例: 当采样率为 600 Hz 时，[-pi/3 0 pi/6 pi/2] 与 [-200 0 100 300] 等效。

数据类型: double

频率向量值的单位，指定为 "normalized"、"Hz"、"kHz"、"MHz" 或 "GHz"。如果将此属性设置为 "normalized"，则分析器假设频率向量以弧度/采样点为单位进行归一化。否则，它假设向量采用选定单位。

仅当您将 FrequencyRange 设置为 "freqvector" 时，此属性才适用。当您将 Analysis 或 OverlayAnalysis 设置为 "magestimate" 或 "noisepsd" 时，此属性不受支持。

数据类型: char | string

幅值响应和幅值估计

幅值响应模式，指定为以下选项之一：

  • "linear" - App 将滤波器响应计算为频率响应的绝对值。

  • "squared" - App 将滤波器响应计算为频率响应的幅值平方。

  • "db" - App 将滤波器响应计算为频率响应的幅值，单位为分贝。

  • "zerophase" - App 将滤波器响应计算为零相位响应。如果将 Analysis 或 OverlayAnalysis 设置为 "magestimate"，则此选项不适用。

数据类型: char | string

计算频率响应估计值的试验次数，指定为大于 1 的整数。仅当您将 Analysis 或 OverlayAnalysis 设置为 "magestimate" 时，此属性才适用。

示例: 24

数据类型: double

幅值响应归一化，指定为逻辑值 0 (false) 或 1 (true)。如果将此属性设置为 true，分析器会将滤波器幅值响应归一化为 1。

数据类型: logical

相位响应和相位延迟响应

相位响应或相位延迟响应的单位，指定为 "radians" 或 "degrees"。

数据类型: char | string

计算相位响应时使用连续相位的选项，指定为逻辑值 0 (false) 或 1 (true)。

数据类型: logical

群延迟响应

群延迟响应的单位，指定为 "samples" 或 "time"。

数据类型: char | string

噪声 PSD

计算噪声功率谱密度的试验次数，指定为大于 1 的整数。

示例: 10

数据类型: double

时域分析

响应长度模式，指定为以下选项之一：

  • "auto" - App 使用 impzlength 函数来估计响应长度。

  • "specify" - 使用 ResponseLength 属性设置响应长度。

数据类型: char | string

时域响应的长度，指定为正整数。仅当您将 ResponseLengthMode 设置为 "specify" 时，此属性才适用。

示例: 128

数据类型: double

系数

滤波器系数的格式，指定为 "decimal"、"hex" 或 "binary"。

数据类型: char | string

所有域

双精度参考滤波器显示画面，指定为逻辑值 0 (false) 或 1 (true)。如果您将此属性设置为 true，滤波器分析器会显示量化滤波器的响应及其双精度参考。

数据类型: logical

多相滤波器的多相分解视图，指定为逻辑值 0 (false) 或 1 (true)。

数据类型: logical

级联传递函数计算模式，指定为以下选项之一：

  • "complete" - App 计算级联节的整体响应。

  • "individual" - App 计算每个节的响应。

  • "cumulative" - App 计算累积响应。

  • "specify" - 使用 CTFAnalysisSections 属性指定要计算响应的节的组合。

数据类型: char | string

级联传递函数 (CTF) 响应计算的节组合，指定为元胞数组。仅当您将 CTFAnalysisMode 设置为 "specify" 时，此属性才适用。

示例: {[1 2 3],[4 5 6]} 指示 App 计算节 1、2 和 3 的级联的响应以及节 4、5 和 6 的级联的响应。

数据类型: cell

示例

全部折叠

打开实时脚本

设计低通 FIR 滤波器，并在滤波器分析器中显示其相位响应。使用 1024 个 NFFT 点，并以度为单位显示相位。

d = designfilt("lowpassfir", ...
    PassbandFrequency=0.45,StopbandFrequency=0.55, ...
    PassbandRipple=1,StopbandAttenuation=60);
opts = filterAnalysisOptions("phase")
opts = 
  filterAnalysisOptions with properties:

                      Analysis: "phase"
               OverlayAnalysis: "none"
    FrequencyNormalizationMode: "auto"
       ReferenceSampleRateMode: "max"
                FrequencyRange: "auto"
                          NFFT: 8192
                FrequencyScale: "linear"
                    PhaseUnits: "radians"
               ContinuousPhase: 0
               ReferenceFilter: 1
        PolyphaseDecomposition: 0
               CTFAnalysisMode: "complete"


opts.NFFT = 1024;
opts.PhaseUnits = "degrees";
filterAnalyzer(d,AnalysisOptions=opts)

版本历史记录

在 R2024a 中推出

另请参阅

App

对象

函数