To apply a filter that has been saved with a form in the navigation area, click

Viewing Filter Specifications

The filter design specifications that you can set vary according to response type and design method. The display region illustrates filter specifications when you select > or when you click the Filter Specifications toolbar button.

You can also view the filter specifications on the Magnitude plot of a designed filter by selecting > .

Filter Order

You have two mutually exclusive options for determining the filter order when you design an equiripple filter:

• Specify order: You enter the filter order in a text box.

• Minimum order: The filter design method determines the minimum order filter.

Select the Minimum order radio button for this example.

Note that filter order specification options depend on the filter design method you choose. Some filter methods may not have both options available.

Options

The available options depend on the selected filter design method. Only the FIR Equiripple and FIR Window design methods have settable options. For FIR Equiripple, the option is a Density Factor. See firpm for more information. For FIR Window the options are Scale Passband, Window selection, and for the following windows, a settable parameter:

You can view the window in the Window Visualization Tool (WVTool) by clicking the View button.

For this example, set the Density factor to 16.

Bandpass Filter Frequency Specifications

For a bandpass filter, you can set

• Units of frequency:

  • Hz

  • kHz

  • MHz

  • GHz

  • Normalized (0 to 1)

• Sampling frequency

• Passband frequencies

• Stopband frequencies

You specify the passband with two frequencies. The first frequency determines the lower edge of the passband, and the second frequency determines the upper edge of the passband.

Similarly, you specify the stopband with two frequencies. The first frequency determines the upper edge of the first stopband, and the second frequency determines the lower edge of the second stopband.

For this example:

• Keep the units in Hz (default).

• Set the sampling frequency (Fs) to 2000 Hz.

• Set the end of the first stopband (Fstop1) to 200 Hz.

• Set the beginning of the passband (Fpass1) to 300 Hz.

• Set the end of the passband (Fpass2) to 700 Hz.

• Set the beginning of the second stopband (Fstop2) to 800 Hz.

  

Bandpass Filter Magnitude Specifications

For a bandpass filter, you can specify the following magnitude response characteristics:

• Units for the magnitude response (dB or linear)

• Passband ripple

• Stopband attenuation

For this example:

• Keep Units in dB (default).

• Set the passband ripple (Apass) to 0.1 dB.

• Set the stopband attenuation for both stopbands (Astop1, Astop2) to 75 dB.

  

Displaying Filter Responses

You can view the following filter response characteristics in the display region or in a separate window.

• Magnitude response

• Phase response

• Magnitude and Phase responses

• Group delay response

• Phase delay response

• Impulse response

• Step response

• Pole-zero plot

• Zero-phase response — available from the y-axis context menu in a Magnitude or Magnitude and Phase response plot.

• Magnitude Response Estimate

• Round-off Noise Power Spectrum

The and analyses use filter internals.

For descriptions of the above responses and their associated toolbar buttons and other filter designer toolbar buttons, see FVTool.

You can display two responses in the same plot by selecting > and selecting an available response. A second y-axis is added to the right side of the response plot. (Note that not all responses can be overlaid on each other.)

You can also display the filter coefficients and detailed filter information in this region.

For all the analysis methods, except zero-phase response, you can access them from the menu, the Analysis Parameters dialog box from the context menu, or by using the toolbar buttons. For zero-phase, right-click the y-axis of the plot and select from the context menu.

For example, to look at the filter's magnitude response, select the Magnitude Response button

You can also overlay the filter specifications on the Magnitude plot by selecting > .

Note

You can use specification masks in FVTool only if FVTool was launched from filter designer.

Using Data Tips

You can click the response to add plot data tips that display information about particular points on the response.

For information on using data tips, see Interactively Explore Plotted Data.

Drawing Spectral Masks

To add spectral masks or rejection area lines to your magnitude plot, click > .

The mask is defined by a frequency vector and a magnitude vector. These vectors must be the same length.

• Enable Mask — Select to turn on the mask display.

• Normalized Frequency — Select to normalize the frequency between 0 and 1 across the displayed frequency range.

• Frequency Vector — Enter a vector of x-axis frequency values.

• Magnitude Units — Select the desired magnitude units. These units should match the units used in the magnitude plot.

• Magnitude Vector — Enter a vector of y-axis magnitude values.

The magnitude response below shows a spectral mask.

Changing the Sampling Frequency

To change the sampling frequency of your filter, right-click any filter response plot and select from the context menu.

To change the filter name, type the new name in Filter name. (In FVTool, if you have multiple filters, select the desired filter and then enter the new name.)

To change the sampling frequency, select the desired unit from Units and enter the sampling frequency in Fs. (For each filter in fvtool, you can specify a different sampling frequency or you can apply the sampling frequency to all filters.)

To save the displayed parameters as the default values to use when filter designer or FVTool is opened, click Save as Default.

To restore the default values, click Restore Original Defaults.

Displaying the Response in FVTool

To display the filter response characteristics in a separate window, select > (available if any analysis, except the filter specifications, is in the display region) or click the Full View Analysis button:

This launches the Filter Visualization Tool (fvtool).

Note

If Filter Specifications are shown in the display region, clicking the Full View Analysis toolbar button launches a MATLAB figure window instead of FVTool. For details, see Add Annotations to Chart. The associated menu item is , which is enabled only if the filter specifications are displayed.

You can use this tool to annotate your design, view other filter characteristics, and print your filter response. You can link filter designer and fvtool so that changes made in filter designer are immediately reflected in fvtool. See FVTool for more information.

Displaying the Pole-Zero Plot

You can edit a designed or imported filter's coefficients by moving, deleting, or adding poles and/or zeros using the Pole/Zero Editor panel.

Note

You cannot generate MATLAB code ( > ) if your filter was designed or edited with the Pole/Zero Editor.

You cannot move quantized poles and zeros. You can only move the reference poles and zeros.

Click the Pole/Zero Editor button in the sidebar or select > to display this panel.

Poles are shown using x symbols and zeros are shown using o symbols.

Changing the Pole-Zero Plot

Plot mode buttons are located to the left of the pole/zero plot. Select one of the buttons to change the mode of the pole/zero plot. The Pole/Zero Editor has these buttons from left to right: move pole, add pole, add zero, and delete pole or zero.

The following plot parameters and controls are located to the left of the pole/zero plot and below the plot mode buttons.

• Gain — factor to compensate for the filter's pole(s) and zero(s) gains

• Coordinates — units (Polar or Rectangular) of the selected pole or zero

• Magnitude — if polar coordinates is selected, magnitude of the selected pole or zero

• Angle — if polar coordinates is selected, angle of selected pole(s) or zero(s)

• Real — if rectangular coordinates is selected, real component of selected pole(s) or zero(s)

• Imaginary — if rectangular coordinates is selected, imaginary component of selected pole or zero

• Section — for multisection filters, number of the current section

• Conjugate — creates a corresponding conjugate pole or zero or automatically selects the conjugate pole or zero if it already exists.

• Auto update — immediately updates the displayed magnitude response when poles or zeros are added, moved, or deleted.

The > has items for selecting multiple poles/zeros, for inverting and mirroring poles/zeros, and for deleting, scaling and rotating poles/zeros.

Moving one of the zeros on the vertical axis produces the following result:

• The selected zero pair is shown in green.

• When you select one of the zeros from a conjugate pair, the Conjugate check box and the conjugate are automatically selected.

• The Magnitude Response plot updates immediately because Auto update is active.

Converting to a New Structure

You can use > to convert the current filter to a new structure. All filters can be converted to the following representations:

• Direct-form I

• Direct-form II

• Direct-form I transposed

• Direct-form II transposed

• Lattice ARMA

Note

If you have DSP System Toolbox™ product installed, you will see additional structures in the Convert structure dialog box.

In addition, the following conversions are available for particular classes of filters:

• Minimum phase FIR filters can be converted to Lattice minimum phase

• Maximum phase FIR filters can be converted to Lattice maximum phase

• Allpass filters can be converted to Lattice allpass

• IIR filters can be converted to Lattice ARMA

Note

Converting from one filter structure to another may produce a result with different characteristics than the original. This is due to the computer's finite-precision arithmetic and the variations in the conversion's roundoff computations.

For example:

• Select > to open the Convert structure dialog box.

• Select Direct-form I in the list of filter structures.

  

Converting to Second-Order Sections

You can use > to store the converted filter structure as a collection of second-order sections rather than as a monolithic higher-order structure.

Note

The following options are also used for > , which you use to modify an SOS filter structure.

The following Scale options are available when converting a direct-form II structure only:

• None (default)

• L-2 (L2 norm)

• L-infinity (L∞ norm)

The Direction (Up or Down) determines the ordering of the second-order sections. The optimal ordering changes depending on the Scale option selected.

For example:

• Select > to open the Convert to SOS dialog box.

• Select L-infinity from the menu for L∞ norm scaling.

• Leave Up as the Direction option.

  Note

  To convert from second-order sections back to a single section, use > .

Exporting Coefficients or Objects to the Workspace

You can save the filter either as filter coefficients variables or as a filter System object™ variable. To save the filter to the MATLAB workspace:

1. Select > . The Export dialog box appears.

2. Select Workspace from the menu.

3. Select Coefficients from the menu to save the filter coefficients or select System Objects to save the filter in a filter System object.

4. For coefficients, assign variable names using the Numerator (for FIR filters) or Numerator and Denominator (for IIR filters), or SOS Matrix and Scale Values (for IIR filters in second-order section form) text boxes in the Variable Names region.

   For System objects, assign the variable name in the Discrete Filter (or Quantized Filter) text box. If you have variables with the same names in your workspace and you want to overwrite them, select the Overwrite Variables check box.

5. Click the Export button.

Exporting Coefficients to an ASCII File

To save filter coefficients to a text file,

1. Select > . The Export dialog box appears.

2. Select Coefficients File (ASCII) from the menu.

3. Click the Export button. The Export Filter Coefficients to .FCF File dialog box appears.

4. Choose or enter a filename and click the Save button.

The coefficients are saved in the text file that you specified, and the MATLAB Editor opens to display the file. The text file also contains comments with the MATLAB version number, the Signal Processing Toolbox™ version number, and filter information.

Exporting Coefficients or Objects to a MAT-File

To save filter coefficients or a filter object as variables in a MAT-file:

1. Select > . The Export dialog box appears.

2. Select MAT-file from the menu.

3. Select Coefficients from the menu to save the filter coefficients or select Objects to save the filter in a filter object.

4. For coefficients, assign variable names using the Numerator (for FIR filters) or Numerator and Denominator (for IIR filters), or SOS Matrix and Scale Values (for IIR filters in second-order section form) text boxes in the Variable Names region.

   For objects, assign the variable name in the Discrete Filter (or Quantized Filter) text box. If you have variables with the same names in your workspace and you want to overwrite them, select the Overwrite Variables check box.

5. Click the Export button. The Export to a MAT-File dialog box appears.

6. Choose or enter a filename and click the Save button.

Exporting to a Simulink Model

If you have the Simulink® product installed, you can export a Simulink block of your filter design and insert it into a new or existing Simulink model.

You can export a filter designed using any filter design method available in the filter designer app.

Note

If you have the DSP System Toolbox and Fixed-Point Designer™ installed, you can export a CIC filter to a Simulink model.

1. After designing your filter, click the Realize Model sidebar button or select > . The Realize Model panel is displayed.

   

2. Specify the name to use for your block in Block name.

3. To insert the block into the current (most recently selected) Simulink model, set the Destination to Current. To inset the block into a new model, select New. To insert the block into a user-defined subsystem, select User defined.

4. If you want to overwrite a block previously created from this panel, check Overwrite generated `Filter' block.

5. If you select the Build model using basic elements check box, your filter is created as a subsystem (Simulink) block, which uses separate sub-elements. In this mode, the following optimization(s) are available:

   • Optimize for zero gains — Removes zero-valued gain paths from the filter structure.

   • Optimize for unity gains — Substitutes a wire (short circuit) for gains equal to 1 in the filter structure.

   • Optimize for negative gains — Substitutes a wire (short circuit) for gains equal to -1 and changes corresponding additions to subtractions in the filter structure.

   • Optimize delay chains — Substitutes delay chains composed of n unit delays with a single delay of n.

   • Optimize for unity scale values — Removes multiplications for scale values equal to 1 from the filter structure.

   The following illustration shows the effects of some of the optimizations:

   Optimization Effects

   

   Note

   The Build model using basic elements check box is enabled only when you have a DSP System Toolbox license and your filter can be designed using digital filter blocks from that library. For more information, see the Filter Realization Wizard.

6. Set the Input processing parameter to specify whether the generated filter performs sample- or frame-based processing on the input. Depending on the type of filter you design, one or both of the following options may be available:

   • Columns as channels (frame based) — When you select this option, the block treats each column of the input as a separate channel.

   • Elements as channels (sample based) — When you select this option, the block treats each element of the input as a separate channel.

7. Click the Realize Model button to create the filter block. When the Build model using basic elements check box is selected, filter designer implements the filter as a subsystem block using Sum (Simulink), Gain (Simulink), and Delay (Simulink) blocks.

If you double-click the Simulink Filter block, the filter structure is displayed.

Other Ways to Export a Filter

You can also send your filter to a C header file or generate MATLAB code to construct your filter from the command line. For detailed instructions, see the following sections:

• Generating a C Header File

• Generating MATLAB Code