# fdesign.arbmagnphase

Arbitrary response magnitude and phase filter specification object

## Syntax

`d = fdesign.arbmagnphase`

d = fdesign.arbmagnphase(specification)

d = fdesign.arbmagnphase(specification,specvalue1,specvalue2,...)

d = fdesign.arbmagnphase(specvalue1,specvalue2,specvalue3)

d = fdesign.arbmagnphase(...,fs)

## Description

`d = fdesign.arbmagnphase`

constructs
an arbitrary magnitude filter specification object `d`

.

`d = fdesign.arbmagnphase(specification)`

initializes
the `Specification`

property for specifications
object `d`

to `specification`

. The
input argument `specification`

must be one of the
choices shown in the following table. Specification options are not
case sensitive.

Specification | Description of Resulting Filter |
---|---|

| Single band design (default). FIR and IIR ( |

| FIR multiband design where |

| IIR single band design. |

The following table describes the specification arguments.

Argument | Description |
---|---|

| Number of bands in the multiband filter. |

| Frequency vector. Frequency values specified in |

| Complex frequency response values. |

| Filter order for FIR filters and the numerator and denominator
orders for IIR filters (when not specified by |

| Numerator order for IIR filters. |

| Denominator order for IIR filter designs. |

By default, this method assumes that all frequency specifications are supplied in normalized frequency.

### Specifying f and h

`f`

and `h`

are the input
arguments you use to define the filter response desired. Each frequency
value you specify in `f`

must have a corresponding
response value in `h`

. This example creates a filter
with two passbands (`b`

= `4`

) and shows how `f`

and `h`

are
related. This example is for illustration only. It is not an actual
filter.

Define the frequency vector `f`

as ```
[0
0.1 0.2 0.4 0.5 0.6 0.9 1.0]
```

Define the response vector `h`

as ```
[0
0.5 0.5 0.1 0.1 0.8 0.8 0]
```

These specifications connect`f`

and `h`

as
shown in the following table.

f (Normalized Frequency) | h (Response Desired at f) |
---|---|

0 | 0 |

0.1 | 0.5 |

0.2 | 0.5 |

0.4 | 0.1 |

0.5 | 0.1 |

0.6 | 0.8 |

0.9 | 0.8 |

1.0 | 0.0 |

A response with two passbands—one roughly between 0.1
and 0.2 and the second between 0.6 and 0.9—results from the
mapping between `f`

and `h`

. Plotting `f`

and `h`

yields
the following figure that resembles a filter with two passbands.

The second example in Examples shows this plot in more detail
with a complex filter response for `h`

. In the example, `h`

uses
complex values for the response.

Different specification types often have different design methods
available. Use `designmethods`

`(d)`

to
get a list of design methods available for a given specification option
and specifications object.

`d = fdesign.arbmagnphase(specification,specvalue1,specvalue2,...)`

initializes
the filter specification object with `specvalue1`

, `specvalue2`

,
and so on. Use `get(d,'description')`

for descriptions
of the various specifications `specvalue1`

, `specvalue2`

,
...`spec`

* n*.

`d = fdesign.arbmagnphase(specvalue1,specvalue2,specvalue3)`

uses
the default specification option `n,f,h`

, setting
the filter order, filter frequency vector, and the complex frequency
response vector to the values `specvalue1`

, `specvalue2`

,
and `specvalue3`

.

`d = fdesign.arbmagnphase(...,fs)`

specifies
the sampling frequency in Hz. All other frequency specifications are
also assumed to be in Hz when you specify `fs`

.

## Examples

## See Also

`fdesign`

| `design`

| `designmethods`

| `setspecs`

**Introduced in R2011a**