**Namespace:**PrecisionImage.FrequencyDomainProcessing

**Assembly:**PrecisionImage (in PrecisionImage.dll) Version: 2.0.0.0 (2.0.0.0)

#### Parameters

- lowCutoff
- Type: System Single

A Single type that specifies the 50% attenuation of the stop-band falling edge.

- highCutoff
- Type: System Single

A Single type that specifies the 50% attenuation of the stop-band rising edge.

- lowFrequencyOrder
- Type: System Single

A Single that controls the slope of the stop-band falling edge (larger values induce steeper slope).

- highFrequencyOrder
- Type: System Single

A Single that controls the slope of the stop-band rising edge (larger values induce steeper slope).

Exception | Condition |
---|---|

System ArgumentOutOfRangeException | Thrown when lowCutoff is less than or equal to 0.0, or greater than or equal to 1.0. |

System ArgumentOutOfRangeException | Thrown when highCutoff is less than or equal to 0.0 or gretaer than or eaula to 1.0. |

System ArgumentException | Thrown when lowCutoff is greater than or equal to highCutoff. |

System ArgumentOutOfRangeException | Thrown when lowFrequencyOrder is less than or equal to 0.0. |

System ArgumentOutOfRangeException | Thrown when highFrequencyOrder is less than or equal to 0.0. |

The IsotropicBandStopFilter is a Butterworth band-stop filter that allows for adjustment of the lower and upper frequency roll-off characteristics as well as the stop-band width. The filter is circularly symmetric and will suppress (or pass) all directional basis functions of a given frequency equally and based on the user-specified filter characteristics.

The stop-band characteristics of the filter are controlled by the four constructor arguments (or otherwise using the object's LowCutoff, HighCutoff, LowFrequencyOrder and HighFrequencyOrder properties if the object has already been instantiated). The lowCutoff and highCutoff arguments are the frequencies at which 50% attenuation occurs. The rate at which the attenuation changes in the frequency region about these points is controlled by the lowFrequencyOrder and highFrequencyOrder arguments. Note that the roll-off characteristics are a function of both the tuning parameters as well as the cutoff values.

The cutoff values are defined as Nyquist frequency-normalized values. To specify the lower frequency stop band falling edge to center at a frequency 25% of the maximum (Nyquist) sampling frequency, assign a value of 0.25f to lowCutoff. Likewise, to declare the upper frequency stop-band rising edge to center at 90% of the Nyquist frequency, assign 0.90f to highCutoff. Such a filter will therefore suppress approximately 65% of the spectral content. The degree to which the stop-band differs from the original spectrum will depend on the tuning parameters.

The lowFrequencyOrder and highFrequencyOrder parameters control the falling rate and rising rate of the stop band, respectively. Larger values will generate steeper rising/falling rates. A value of 5.0 - 10.0 will typically generate a gradual filter that induces less ringing than a value of 50.0 for example (which is virtually an ideal filter).