Documentation

# freqz

Frequency response of filter

## Syntax

``````[h,w] = freqz(sysobj)``````
``````[h,w] = freqz(sysobj,n)``````
``````[h,w] = freqz(sysobj,'Arithmetic',arithType)``````
``freqz(sysobj)``

## Description

``````[h,w] = freqz(sysobj)``` returns the complex frequency response `h` of the filter System object™, `sysobj`. The vector `w` contains the frequencies (in radians/sample) at which the function evaluates the frequency response. The frequency response is evaluated at 8192 points equally spaced around the upper half of the unit circle.```
``````[h,w] = freqz(sysobj,n)``` returns the complex frequency response of the filter System object and the corresponding frequencies at `n` points equally spaced around the upper half of the unit circle.`freqz` uses the transfer function associated with the filter to calculate the frequency response of the filter with the current coefficient values.```
``````[h,w] = freqz(sysobj,'Arithmetic',arithType)``` analyzes the filter System object, based on the arithmetic specified in `arithType`, using either of the previous syntaxes.```

example

````freqz(sysobj)` uses `fvtool` to plot the magnitude and unwrapped phase of the frequency response of the filter System object `sysobj`.For more input options, see `freqz`.```

## Examples

collapse all

This examples plot the frequency response of the lowpass FIR filter using `freqz`.

```b = fir1(80,0.5,kaiser(81,8)); firFilt = dsp.FIRFilter('Numerator',b); freqz(firFilt);```

## Input Arguments

collapse all

Number of points over which the frequency response is computed. 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

Complex `n`-element frequency response vector. If `n` is not specified, the function uses a default value of 8192. The frequency response is evaluated at `n` points equally spaced around the upper half of the unit circle.

Data Types: `double`
Complex Number Support: Yes

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`

## Tips

There are several ways of analyzing the frequency response of filters. `freqz` accounts for quantization effects in the filter coefficients, but does not account for quantization effects in filtering arithmetic. To account for the quantization effects in filtering arithmetic, refer to function `noisepsd`.

## Algorithms

`freqz` calculates the frequency response for a filter from the filter transfer function Hq(z). The complex-valued frequency response is calculated by evaluating Hq(ejω) at discrete values of w specified by the syntax you use. The integer input argument `n` determines the number of equally-spaced points around the upper half of the unit circle at which `freqz` evaluates the frequency response. The frequency ranges from 0 to π radians per sample when you do not supply a sampling frequency as an input argument. When you supply the scalar sampling frequency `fs` as an input argument to `freqz`, the frequency ranges from 0 to `fs`/2 Hz.