Main Content

fvtool

Visualize filter bank

Description

example

fvtool(obj) visualizes the filters in the filter bank using the Filter Visualization Tool (FVTool).

example

fvtool(obj,ind) visualizes the filters corresponding to the elements in the vector ind.

example

fvtool(___,Name,Value) specifies options using one or more Name,Value pair arguments.

Examples

collapse all

Create an octaveFilterBank object. Call fvtool to visualize the filter bank.

octFiltBank = octaveFilterBank;
fvtool(octFiltBank)

{"String":"Figure Figure 1: Magnitude Response (dB) contains an axes object. The axes object with title Magnitude Response (dB) contains 10 objects of type line.","Tex":"Magnitude Response (dB)","LaTex":[]}

ans = 
  Figure (filtervisualizationtool) with properties:

      Number: []
        Name: 'Figure 1: Magnitude Response (dB)'
       Color: [0.9400 0.9400 0.9400]
    Position: [348 480 583 437]
       Units: 'pixels'

  Use get to show all properties

To visualize a subset of filters in the filter bank, specify the second argument as a row vector of indices between one and the number of filters in the filter bank. If not specified, fvtool visualizes 1 to N filters of the filter bank, where N is the smallest of octFiltBank.NumFilters and 64. Visualize the ninth filter.

fvtool(octFiltBank,9)

{"String":"Figure Figure 2: Magnitude Response (dB) contains an axes object. The axes object with title Magnitude Response (dB) contains an object of type line.","Tex":"Magnitude Response (dB)","LaTex":[]}

ans = 
  Figure (filtervisualizationtool) with properties:

      Number: []
        Name: 'Figure 2: Magnitude Response (dB)'
       Color: [0.9400 0.9400 0.9400]
    Position: [348 480 583 437]
       Units: 'pixels'

  Use get to show all properties

To specify the number of FFT points used to compute the frequency response, use the NFFT name-value pair. Specify that the frequency response is calculated using a 8192-point FFT.

fvtool(octFiltBank,'NFFT',8192)

{"String":"Figure Figure 3: Magnitude Response (dB) contains an axes object. The axes object with title Magnitude Response (dB) contains 10 objects of type line.","Tex":"Magnitude Response (dB)","LaTex":[]}

ans = 
  Figure (filtervisualizationtool) with properties:

      Number: []
        Name: 'Figure 3: Magnitude Response (dB)'
       Color: [0.9400 0.9400 0.9400]
    Position: [348 480 583 437]
       Units: 'pixels'

  Use get to show all properties

Create a gammatoneFilterBank object. Call fvtool to visualize the filter bank.

gammaFiltBank = gammatoneFilterBank;
fvtool(gammaFiltBank);

{"String":"Figure Figure 1: Magnitude Response (dB) contains an axes object. The axes object with title Magnitude Response (dB) contains 32 objects of type line.","Tex":"Magnitude Response (dB)","LaTex":[]}

To visualize a subset of filters in the filter bank, specify the second argument as a row vector of indices between one and the number of filters in the filter bank. If not specified, fvtool visualizes 1 to N filters of the filter bank, where N is the smallest of gammaFiltBank.NumFilters and 64. Visualize the ninth filter.

fvtool(gammaFiltBank,9);

{"String":"Figure Figure 2: Magnitude Response (dB) contains an axes object. The axes object with title Magnitude Response (dB) contains an object of type line.","Tex":"Magnitude Response (dB)","LaTex":[]}

To specify the number of FFT points used to compute the frequency response, use the NFFT name-value pair. Specify that the frequency response is calculated using a 8192-point FFT.

fvtool(gammaFiltBank,'NFFT',8192);

{"String":"Figure Figure 3: Magnitude Response (dB) contains an axes object. The axes object with title Magnitude Response (dB) contains 32 objects of type line.","Tex":"Magnitude Response (dB)","LaTex":[]}

Input Arguments

collapse all

Object to get filter frequency responses from, specified as an object of gammatoneFilterBank or octaveFilterBank.

Indices of filters to calculate frequency responses from, specified as a row vector of integers with values in the range [1, N]. N is the total number of filters designed by obj.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'NFFT',2048

Number of DFT bins, specified as a positive integer.

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

Version History

Introduced in R2019a