Extract a frequency subband using a onesided (complex) bandpass decimator
DSP System Toolbox / Filtering / Multirate Filters
The Complex Bandpass Decimator block extracts a specific subband of frequencies using a onesided, multistage, complex bandpass decimator. The block determines the bandwidth of interest using the specified center frequency, decimator factor, and bandwidth values.
x
— Data inputData input, specified as a vector or a matrix. The number of rows in the input must be a multiple of the decimation factor.
This port is unnamed unless you select the Specify center frequency from input port parameter.
Data Types: single
 double
Complex Number Support: Yes
Fc
— Center frequencyCenter frequency of the desired band in Hz, specified as a real, finite numeric scalar in the range [–Fs/2, Fs/2]. The value of Fs depends on the setting of the Inherit sample rate from input parameter. When you select this parameter, Fs is the value the block inherits from the input signal. When you clear this parameter, Fs is the value you specify in the Input sample rate (Hz) parameter.
This port is only available if you select the Specify center frequency from input port parameter.
Data Types: single
 double
Complex Number Support: Yes
Port_1
— Filtered outputOutput of the complex bandpass decimator, returned as a vector or a matrix. The output contains the subband of frequencies specified by the parameters on the block dialog. The number of rows (frame size) in the output signal is 1/D times the number of rows in the input signal, where D is the decimation factor. The number of channels (columns) does not change.
The data type of the output is same as the data type of the input. The output signal is always complex.
Data Types: single
 double
Complex Number Support: Yes
Filter specification
— Filter design parametersDecimation factor
(default)  Bandwidth
 Decimation factor and bandwidth
Filter design parameters, specified as one of the following:
Decimation factor
–– The block
specifies the decimation factor through the Decimation
factor parameter. The bandwidth of interest
(BW) is computed using the following
equation:
$$BW=Fs/D$$
where
Fs –– Sample rate specified through the Input sample rate (Hz) parameter.
D –– Decimation factor.
Bandwidth
–– The block specifies
the bandwidth through the Bandwidth (Hz)
parameter. The decimation factor (D) is
computed using the following equation:
$$D=\text{floor}\left(\frac{Fs}{BW+TW}\right)$$
where
Fs –– Sample rate specified through the Input sample rate (Hz) parameter.
BW –– Bandwidth of interest.
TW –– Transition width specified through the Transition width (Hz) parameter.
Decimation factor and bandwidth
––
The decimation factor and the bandwidth of interest are
specified through the Decimation factor and
Bandwidth (Hz) parameters.
Decimation factor
— Decimation factor2
(default)  positive integerFactor by which to reduce the bandwidth of the input signal, specified as a positive integer. The frame size (number of rows) of the input signal must be a multiple of the decimation factor.
This parameter applies when you set Filter
specification to either Decimation
factor
or Decimation factor and
bandwidth
.
Bandwidth (Hz)
— Bandwidth in Hz5000
(default)  real positive scalarWidth of the frequency band of interest, specified as a real positive scalar in Hz.
This parameter applies when you set Filter
specification to either
Bandwidth
or Decimation
factor and bandwidth
.
Data Types: single
 double
Specify center frequency from input port
— Flag to specify center frequencyWhen you select this check box, the center frequency is input through the Fc port. When you clear this check box, the center frequency is specified on the block dialog through the Center frequency (Hz) parameter.
When you select this check box, the block does not compute the filter response. To view the filter response, clear this check box, specify the center frequency on the block dialog, and click View Filter Response button.
Center frequency (Hz)
— Center frequency in Hz0
(default)  real scalarCenter frequency of the desired band in Hz, specified as a real, finite numeric scalar in the range [–Fs/2, Fs/2].
Tunable: Yes
Data Types: single
 double
Stopband attenuation (dB)
— Stopband attenuation in dB80
(default)  positive scalarStopband attenuation of the filter in dB, specified as a finite positive scalar.
Data Types: single
 double
 int8
 int16
 int32
 int64
 uint8
 uint16
 uint32
 uint64
Passband ripple (dB)
— Passband ripple in dB1
(default)  positive scalarPassband ripple of the filter, specified as a positive scalar in dB.
This parameter applies when you set Filter
specification to either
Bandwidth
or Decimation
factor and bandwidth
.
Data Types: single
 double
 int8
 int16
 int32
 int64
 uint8
 uint16
 uint32
 uint64
Transition width (Hz)
— Transition width in Hz100
(default)  positive scalarTransition width of the filter in Hz, specified as a positive scalar.
Data Types: single
 double
 int8
 int16
 int32
 int64
 uint8
 uint16
 uint32
 uint64
Reduce number of complex coefficients
— Minimize number of complex coefficientsMinimize the number of complex coefficients. When you select this parameter, the first stage of the multistage filter is bandpass (with complex coefficients) centered at the specified center frequency. The first stage is followed by a mixing stage that heterodynes the signal to DC. The remaining filter stages, all with real coefficients, follow.
When you clear the parameter, the input signal is first passed through the different stages of the multistage filter. All stages are bandpass (complex coefficients). The signal is then heterodyned to DC if Mix signal to baseband parameter is selected and the frequency offset resulting from the decimation is nonzero.
Mix signal to baseband
— Mix signal to basebandMix the signal to baseband. When you select this parameter, the block heterodynes the filtered, decimated signal to DC. This mixing stage runs at the output sample rate of the filter. When you clear this parameter, the block skips the mixing stage.
This parameter applies when you clear the Reduce number of complex coefficients parameter.
Inherit sample rate from input
— Flag to specify input sample rateWhen you select this parameter, the block inherits its sample rate from the input signal. The block calculates the sample rate based on the sample time of the input port. When you clear this parameter, specify the sample rate in Input sample rate (Hz).
Input sample rate (Hz)
— Input sample rate in Hz44100
(default)  real positive scalarSampling rate of the input signal in Hz, specified as a real positive scalar.
This parameter applies when you clear the Inherit sample rate from input parameter.
Data Types: single
 double
Data Types 

Multidimensional Signals 

VariableSize Signals 

The complex bandpass decimator is designed by applying a complex frequency shift transformation on a lowpass prototype filter. The lowpass prototype in this case is a multirate, multistage finite impulse response (FIR) filter. The desired frequency shift applies only to the first stage. Subsequent stages scale the desired frequency shift by their respective cumulative decimation factors. For details, see Complex Bandpass Filter Design and Zoom FFT.
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
Select web siteYou can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.