La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

filterAnalysisOptions

Filter analysis options

Desde R2024a

Descripción

filterAnalysisOptions specifies analysis options for filters displayed in Filter Analyzer.

Creación

Sintaxis

opts = filterAnalysisOptions

opts = filterAnalysisOptions(analysis)

opts = filterAnalysisOptions(analysis,overlay)

opts = filterAnalysisOptions(___,Name=Value)

Description

opts = filterAnalysisOptions returns an object containing magnitude-response analysis options. Use opts to specify analysis options for the Filter Analyzer app.

opts = filterAnalysisOptions(analysis) returns filter analysis options for the specified analysis type. analysis sets the Analysis property.

opts = filterAnalysisOptions(analysis,overlay) returns filter analysis options for the specified analysis and overlay analysis types. overlay sets the OverlayAnalysis property.

opts = filterAnalysisOptions(___,Name=Value) specifies Properties using one or more name-value arguments, in addition to any combination of input arguments from previous syntaxes.

Input Arguments

analysis — Analysis type

"magnitude" (predeterminado) | "phase" | "groupdelay" | "phasedelay" | "magestimate" | "noisepsd" | "impulse" | "step" | "polezero" | "info" | "coefficients"

Analysis type, specified as one of these options:

• Frequency-domain analyses:

  • "magnitude" — Magnitude response

  • "phase" — Phase response

  • "groupdelay" — Group delay response

  • "phasedelay" — Phase delay response

  • "magestimate" — Magnitude response estimate

  • "noisepsd" — Noise power spectral density (PSD)

• Time-domain analyses:

  • "impulse" — Impulse response

  • "step" — Step response

• Other analyses:

  • "polezero" — Pole-zero plot

  • "info" — Filter information

  • "coefficients" — Filter coefficients

You can also specify analysis as a name-value argument: filterAnalysisOptions(Analysis=analysis) is equivalent to filterAnalysisOptions(analysis).

For more information, see Analysis.

overlay — Overlaid analysis

string

Overlaid analysis, specified as a string.

• If you set analysis to a frequency-domain analysis, then overlay must be also a frequency-domain analysis.

• If you set analysis to a time-domain analysis, then overlay must be also a time-domain analysis.

• analysis and overlay must be set to different values.

• This argument is not supported if you set analysis to "polezero", "info", or "coefficients".

You can also specify overlay as a name-value argument: filterAnalysisOptions(Analysis=analysis,OverlayAnalysis=overlay) is equivalent to filterAnalysisOptions(analysis,overlay)

Propiedades

Analysis Type

Analysis — Analysis type

"magnitude" (predeterminado) | "phase" | "groupdelay" | "phasedelay" | "magestimate" | "noisepsd" | "impulse" | "step" | "polezero" | "info" | "coefficients"

Analysis type, specified as one of these options:

• Frequency-domain analyses:

  • "magnitude" — Magnitude response

  • "phase" — Phase response

  • "groupdelay" — Group delay response

  • "phasedelay" — Phase delay response

  • "magestimate" — Magnitude response estimate

  • "noisepsd" — Noise power spectral density (PSD)

• Time-domain analyses:

  • "impulse" — Impulse response

  • "step" — Step response

• Other analyses:

  • "polezero" — Pole-zero plot

  • "info" — Filter information

  • "coefficients" — Filter coefficients

For more information, see Analysis on the Filter Analyzer page.

OverlayAnalysis — Overlaid analysis

string scalar | character vector

Overlaid analysis, specified as a string scalar or character vector.

• If you set Analysis to a frequency-domain analysis, then OverlayAnalysis must be also a frequency-domain analysis.

• If you set Analysis to a time-domain analysis, then OverlayAnalysis must be also a time-domain analysis.

• Analysis and OverlayAnalysis must be set to different values.

• This argument is not supported if you set Analysis to "polezero", "info", or "coefficients".

For more information, see Analysis on the Filter Analyzer page.

Frequency Normalization and Sample Rate

FrequencyNormalizationMode — Frequency normalization mode

"auto" (predeterminado) | "normalized" | "unnormalized"

Frequency normalization mode, specified as one of these options:

• "normalized" — The app normalizes the response of each input filter with respect to its sample rate and computes responses using normalized frequencies expressed in rad/sample.

• "unnormalized" — The app computes responses in cyclical frequencies expressed in hertz. For filters with no sample rate, the app assumes a rate of 1 Hz.

• "auto" — The app uses the "unnormalized" mode if all filters under analysis have a specified sample rate and the "normalized" mode otherwise.

Tipos de datos: char | string

ReferenceSampleRateMode — Reference sample rate selection mode

"max" (predeterminado) | "specify"

Reference sample rate selection mode, specified as one of these options:

• "max" — The app uses the maximum sample rate of all the filters under analysis in a display.

• "specify" — Specify a sample rate value using the ReferenceSampleRate property.

This property does not apply if you set FrequencyNormalizationMode to "normalized".

Tipos de datos: char | string

ReferenceSampleRate — Reference sample rate

positive scalar

Reference sample rate, specified as a positive scalar. The app uses the specified reference sample rate to normalize filter responses and to define the overall Nyquist range over which to analyze the filters. This property applies only if you set ReferenceSampleRateMode to "specify".

Ejemplo: 44.1e3

Tipos de datos: double

Frequency-Domain Analysis

FrequencyRange — Analysis frequency range

"auto" (predeterminado) | "onesided" | "twosided" | "centered" | "freqvector"

Analysis frequency range, specified as one of these options:

• "onesided" — The app computes responses over the range [0, π) when using normalized frequencies and over the range [0, referenceSampleRate/2) when using unnormalized frequencies.

• "twosided" — The app computes responses over the range [0, 2π) when using normalized frequencies and over the range [0, referenceSampleRate) when using unnormalized frequencies.

• "centered" — The app computes responses over the range [–π, π) when using normalized frequencies and over the range [–referenceSampleRate/2, referenceSampleRate/2) when using unnormalized frequencies. This option does not apply when you set FrequencyScale to "log".

• "freqvector" — The app computes responses at the frequency points specified using FrequencyVector.

• "auto" — The app computes one-sided responses if all filters under analysis in a display have real-valued coefficients and two-sided responses if at least one filter has complex-valued coefficients.

Tipos de datos: char | string

NFFT — Number of discrete Fourier transform points

8192 (predeterminado) | positive integer

Number of discrete Fourier transform points used to compute filter responses, specified as a positive integer. This property does not apply when you set FrequencyRange to "freqvector".

Ejemplo: 1024

Tipos de datos: double

FrequencyScale — Frequency scale for visualizing filter responses

"linear" (predeterminado) | "log"

Frequency scale for visualizing filter responses, specified as "linear" for a linear frequency scale or "log" for a logarithmic frequency scale. The "log" option does not apply if you set FrequencyRange to "centered".

Tipos de datos: char | string

FrequencyVector — Frequency vector

vector of finite real values

Frequency vector over which to compute filters, specified as a vector of finite real values. If you set FrequencyVectorUnits to "normalized", the analyzer assumes the vector is in units of rad/sample. Otherwise, it assumes the vector in the selected units.

This property applies only when you set FrequencyRange to "freqvector". This property is not supported when you set either Analysis or OverlayAnalysis to "magestimate" or "noisepsd".

Ejemplo: [-pi/3 0 pi/6 pi/2] and [-200 0 100 300] are equivalent when the sample rate is 600 Hz.

Tipos de datos: double

FrequencyVectorUnits — Units for frequency vector values

"normalized" (predeterminado) | "Hz" | "kHz" | "MHz" | "GHz"

Units for frequency vector values, specified as "normalized", "Hz", "kHz", "MHz", or "GHz". If you set this property to "normalized", the analyzer assumes the frequency vector is normalized in units of rad/sample. Otherwise, it assumes the vector is in the selected units.

This property applies only when you set FrequencyRange to "freqvector". This property is not supported when you set either Analysis or OverlayAnalysis to "magestimate" or "noisepsd".

Tipos de datos: char | string

Magnitude Response and Magnitude Estimate

MagnitudeMode — Magnitude response mode

"db" (predeterminado) | "linear" | "squared" | "zerophase"

Magnitude response mode, specified as one of these options:

• "linear" — The app computes the filter response as the absolute value of the frequency response.

• "squared" — The app computes the filter response as the magnitude squared of the frequency response.

• "db" — The app computes the filter response as the magnitude, in decibel scale, of the frequency response.

• "zerophase" — The app computes the filter response as the zero-phase response. This option does not apply if you set either Analysis or OverlayAnalysis to "magestimate".

Tipos de datos: char | string

MagnitudeEstimateNumTrials — Number of trials to compute frequency response estimate

12 (predeterminado) | positive integer

Number of trials to compute the frequency response estimate, specified as a positive integer. This property applies only when you set either Analysis or OverlayAnalysis to "magestimate".

Ejemplo: 24

Tipos de datos: double

NormalizeMagnitude — Magnitude response normalization

false or 0 (predeterminado) | true or 1

Magnitude response normalization, specified as a logical 0 (false) or 1 (true). If you set this property to true, the analyzer normalizes the filter magnitude response to 1.

Tipos de datos: logical

Phase Response and Phase Delay Response

PhaseUnits — Units for phase response or phase delay response

"radians" (predeterminado) | "degrees"

Units for the phase response or phase delay response, specified as "radians" or "degrees".

Tipos de datos: char | string

ContinuousPhase — Option to use continuous phase when computing phase response

false or 0 (predeterminado) | true or 1

Option to use continuous phase when computing phase response, specified as a logical 0 (false) or 1 (true).

Tipos de datos: logical

Group Delay Response

GroupDelayUnits — Units for group delay response

"samples" (predeterminado) | "time"

Units for the group delay response, specified as "samples" or "time".

Tipos de datos: char | string

Noise PSD

NoisePSDNumTrials — Number of trials to compute noise PSD

12 (predeterminado) | positive integer

Number of trials to compute the noise power spectral density, specified as a positive integer.

Ejemplo: 10

Tipos de datos: double

Time-Domain Analysis

ResponseLengthMode — Response length mode

"auto" (predeterminado) | "specify"

Response length mode, specified as one of these options:

• "auto" — The app uses the impzlength function to estimate the response length.

• "specify" — You set the response length using the ResponseLength property.

Tipos de datos: char | string

ResponseLength — Length of time-domain response

positive integer

Length of the time-domain response, specified as a positive integer. This property applies only if you set ResponseLengthMode to "specify".

Ejemplo: 128

Tipos de datos: double

Coefficients

CoefficientsFormat — Format for filter coefficients

"decimal" (predeterminado) | "hex" | "binary"

Format for the filter coefficients, specified as "decimal", "hex", or "binary".

Tipos de datos: char | string

All Domains

ReferenceFilter — Double-precision reference filter display

false or 0 (predeterminado) | true or 1

Double-precision reference filter display, specified as a logical 0 (false) or 1 (true). If you set this property to true, Filter Analyzer displays the responses of quantized filters and their double-precision references.

Tipos de datos: logical

PolyphaseDecomposition — View of polyphase decomposition of polyphase filter

false or 0 (predeterminado) | true or 1

View of the polyphase decomposition of the polyphase filter, specified as a logical 0 (false) or 1 (true).

Tipos de datos: logical

CTFAnalysisMode — Cascaded transfer function computation mode

"complete" (predeterminado) | "individual" | "cumulative" | "specify"

Cascaded transfer function computation mode, specified as one of these options:

• "complete" — The app computes the overall response of the cascaded sections.

• "individual" — The app computes the response of each section.

• "cumulative" — The app computes cumulative responses.

• "specify" — You use the CTFAnalysisSections property to specify the combination of sections over which to compute responses.

Tipos de datos: char | string

CTFAnalysisSections — Section combinations for CTF response computation

cell array

Section combinations for cascaded transfer function (CTF) response computation, specified as a cell array. This property applies only when you set CTFAnalysisMode to "specify".

Ejemplo: {[1 2 3],[4 5 6]} directs the app to compute responses for a cascade of sections 1, 2, and 3 and a cascade of sections 4, 5, and 6.

Tipos de datos: cell

Ejemplos

Filter Analysis Options

Design a lowpass FIR filter and display its phase response in Filter Analyzer. Use 1024 NFFT points, and display the phase in degrees.

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)

Historial de versiones

Introducido en R2024a

Consulte también

Apps

• Filter Analyzer | Filter Designer

Objetos

• digitalFilter | filterAnalyzer

Funciones

• designfilt | freqz | impz | zplane