zoom

Zoom into region of interest in Filter Analyzer app displays

Since R2024a

Syntax

zoom(fa,"xy",lims)

zoom(fa,"x",xlims)

zoom(fa,"y",ylims)

zoom(fa,"default")

zoom(fa,"passband")

zoom(___,DisplayNums=dispnums)

Description

zoom(fa,"xy",lims) zooms into the area specified by lims in the active display of the Filter Analyzer app fa.

zoom(fa,"x",xlims) constrains the zoom to the x-axis.

zoom(fa,"y",ylims) constrains the zoom to the y-axis.

zoom(fa,"default") restores the axes limits to the default values.

zoom(fa,"passband") zooms into the passband of the filters. To use this syntax, you must have specified filters with design metadata in fa. To include metadata in your design, use a digitalFilter object or a filter System object™. You must have a DSP System Toolbox™ license to use this syntax.

zoom(___,DisplayNums=dispnums) zooms the displays with numbers specified in dispnums, in addition to any combination of input arguments from previous syntaxes..

Examples

Zoom into Region of Interest

Design two filters with different frequency constraints. Start Filter Analyzer and visualize the magnitude responses of the filters.

d1 = designfilt("lowpassfir", ...
    PassbandFrequency=0.45,StopbandFrequency=0.55);
d2 = designfilt("highpassfir", ...
    PassbandFrequency=0.45,StopbandFrequency=0.35);
fa = filterAnalyzer(d1,d2,FilterNames=["LP" "HP"]);

Zoom into the frequency region containing the transition bands.

zoom(fa,"x",[0.3 0.6])

Input Arguments

fa — Filter Analyzer app handle

filterAnalyzer object

Filter Analyzer app handle, specified as a filterAnalyzer object.

lims — Area limits

four-element vector

Area limits, specified as a four-element vector of the form [xmin xmax ymin ymax].

Example: [0.2 0.5 -60 10]

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

xlims — Area x-limits

two-element vector

Area x-limits, specified as a two-element vector of the form [xmin xmax].

Example: [0.2 0.5]

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

ylims — Area y-limits

two-element vector

Area y-limits, specified as a two-element vector of the form [ymin ymax].

Example: [-60 10]

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

dispnums — Displays to zoom

integer | vector of integers

Displays to zoom, specified as an integer or a vector of integers. If you do not specify this argument, Filter Analyzer works on the active display. Use display identification numbers to target displays when using other Filter Analyzer functions. Identification numbers appear above the plotting area of the app, on the tabs that correspond to the different displays.

Example: [1 5]

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

Version History

Introduced in R2024a