grpdelay

Group delay response of discrete-time filter System object

Syntax

[gd,w] = grpdelay(sysobj)
[gd,w] = grpdelay(sysobj,n)
[gd,w] = grpdelay(sysobj,'Arithmetic',arithType)
grpdelay(sysobj)

Description

[gd,w] = grpdelay(sysobj) returns the group delay gd of the filter System object™, sysobj, based on the current filter coefficients. The vector w contains the frequencies (in radians) at which the group delay is evaluated. The group delay is defined as:

ddw(angle(w))

The group delay is evaluated at 8192 points equally spaced around the upper half of the unit circle.

[gd,w] = grpdelay(sysobj,n) returns the group delay of the filter System object and the corresponding frequencies at n points equally spaced around the upper half of the unit circle.

[gd,w] = grpdelay(sysobj,'Arithmetic',arithType) computes the group delay of the filter System object, based on the arithmetic specified in arithType, using either of the previous syntaxes.

example

grpdelay(sysobj) plots the group delay of the filter System object in the fvtool.

For more input options, see grpdelay.

Examples

collapse all

CICComp = dsp.CICCompensationDecimator;

grpdelay computes the group delay of the filter and displays it using fvtool.

grpdelay(CICComp);

Input Arguments

collapse all

Number of samples, specified as a positive integer. For an FIR filter where n is a power of two, the computation is done faster using FFTs.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Specify the arithmetic used during analysis. When the arithmetic input is not specified and the filter System object is unlocked, the analysis tool assumes a double-precision filter. The 'Arithmetic' property set to 'Fixed' applies only to filter System objects with fixed-point properties.

Output Arguments

collapse all

Group delay vector of length n. If n is not specified, the function uses a default value of 8192.

Data Types: double

Frequency vector of length n, in radians/sample. w consists of n points equally spaced around the upper half of the unit circle (from 0 to π radians/sample). If n is not specified, the function uses a default value of 8192.

Data Types: double

Introduced in R2011a