# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

# allpassbpc2bpc

Allpass filter for complex bandpass transformation

## Syntax

```[AllpassNum,AllpassDen] = allpassbpc2bpc(Wo,Wt) ```

## Description

`[AllpassNum,AllpassDen] = allpassbpc2bpc(Wo,Wt)` returns the numerator, `AllpassNum`, and the denominator, `AllpassDen`, of the first-order allpass mapping filter for performing a complex bandpass to complex bandpass frequency transformation. This transformation effectively places two features of an original filter, located at frequencies Wo1 and Wo2, at the required target frequency locations Wt1 and Wt2. It is assumed that Wt2 is greater than Wt1. In most of the cases the features selected for the transformation are the band edges of the filter passbands. In general it is possible to select any feature; e.g., the stopband edge, the DC, the deep minimum in the stopband, or other ones.

Relative positions of other features of an original filter do not change in the target filter. This means that it is possible to select two features of an original filter, F1 and F2, with F1 preceding F2. Feature F1 will still precede F2 after the transformation. However, the distance between F1 and F2 will not be the same before and after the transformation.

This transformation can also be used for transforming other types of filters; e.g., complex notch filters or resonators can be repositioned at two distinct desired frequencies at any place around the unit circle. This is very attractive for adaptive systems.

## Examples

collapse all

This example shows how to design allpass mapping filter, changing the complex bandpass filter with the band edges at and to the new band edges of and . Find the frequency response of the allpass mapping filter:

```Wo = [0.2, 0.4]; Wt = [0.3, 0.6]; [AllpassNum, AllpassDen] = allpassbpc2bpc(Wo, Wt); [ha, f] = freqz(AllpassNum, AllpassDen, 'whole'); plot(f/pi,-angle(ha)/pi, Wt, Wo, 'ro'); title('Mapping Function Wo(Wt)'); xlabel('New Frequency, Wt'); ylabel('Old Frequency, Wo');```

## Arguments

VariableDescription
`Wo`

Frequency values to be transformed from the prototype filter

`Wt`

Desired frequency locations in the transformed target filter

`AllpassNum`

Numerator of the mapping filter

`AllpassDen`

Denominator of the mapping filter

Frequencies must be normalized to be between -1 and 1, with 1 corresponding to half the sample rate.