OpenShot Audio Library | OpenShotAudio 0.3.2
|
#include <juce_FilterDesign.h>
Classes | |
struct | IIRPolyphaseAllpassStructure |
Public Types | |
using | FIRCoefficientsPtr = typename FIR::Coefficients< FloatType >::Ptr |
using | IIRCoefficients = typename IIR::Coefficients< FloatType > |
using | WindowingMethod = typename WindowingFunction< FloatType >::WindowingMethod |
This class provides a set of functions which generates FIR::Coefficients and IIR::Coefficients, of high-order low-pass filters. They can be used for processing directly audio as an equalizer, in resampling algorithms etc.
see FIRFilter::Coefficients, FIRFilter, WindowingFunction, IIRFilter::Coefficients, IIRFilter
Definition at line 42 of file juce_FilterDesign.h.
struct juce::dsp::FilterDesign::IIRPolyphaseAllpassStructure |
The structure returned by the function designIIRLowpassHalfBandPolyphaseAllpassMethod.
The two first members of this structure directPath and delayedPath are arrays of IIR::Coefficients, made of polyphase second order allpass filters and an additional delay in the second array, that can be used in cascaded filters processed in two parallel paths, which must be summed at the end to get the high order efficient low-pass filtering. The last member is an array with the useful parameters for simulating the structure using any custom processing function.
Definition at line 259 of file juce_FilterDesign.h.
Class Members | ||
---|---|---|
Array< double > | alpha | |
ReferenceCountedArray< IIRCoefficients > | delayedPath | |
ReferenceCountedArray< IIRCoefficients > | directPath |
using juce::dsp::FilterDesign< FloatType >::FIRCoefficientsPtr = typename FIR::Coefficients<FloatType>::Ptr |
Definition at line 44 of file juce_FilterDesign.h.
using juce::dsp::FilterDesign< FloatType >::IIRCoefficients = typename IIR::Coefficients<FloatType> |
Definition at line 45 of file juce_FilterDesign.h.
using juce::dsp::FilterDesign< FloatType >::WindowingMethod = typename WindowingFunction<FloatType>::WindowingMethod |
Definition at line 47 of file juce_FilterDesign.h.
|
static |
This method generates a FIR::Coefficients for a low-pass filter, with a cutoff frequency at half band, using an algorithm described in the article "Design of Half-Band FIR Filters for Signal Compression" from Pavel Zahradnik, to get an equiripple like high order FIR filter, without the need of an iterative method and convergence failure risks.
It generates linear phase filters coefficients.
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
amplitudedB | the maximum amplitude in dB expected in the stop band (must be negative) |
Definition at line 239 of file juce_FilterDesign.cpp.
|
static |
This a variant of the function designFIRLowpassWindowMethod, which allows the user to specify a transition width and a negative gain in dB, to get a low-pass filter using the Kaiser windowing function, with calculated values of the filter order and of the beta parameter, to satisfy the constraints.
It generates linear phase filters coefficients.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
amplitudedB | the maximum amplitude in dB expected in the stop band (must be negative) |
Definition at line 68 of file juce_FilterDesign.cpp.
|
static |
This method generates a FIR::Coefficients for a low-pass filter, by minimizing the average error between the generated filter and an ideal one using the least squares error criterion and matrices operations.
It generates linear phase filters coefficients.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
order | the order of the filter |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
stopBandWeight | between 1.0 and 100.0, indicates how much we want attenuation in the stop band, against some oscillation in the pass band |
Definition at line 129 of file juce_FilterDesign.cpp.
|
static |
This method is also a variant of the function designFIRLowpassWindowMethod, using a rectangular window as a basis, and a spline transition between the pass band and the stop band, to reduce the Gibbs phenomenon.
It generates linear phase filters coefficients.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
order | the order of the filter |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
spline | between 1.0 and 4.0, indicates how much the transition is curved, with 1.0 meaning a straight line |
Definition at line 96 of file juce_FilterDesign.cpp.
|
static |
This method generates a FIR::Coefficients for a low-pass filter, using the windowing design method, applied to a sinc impulse response. It is one of the simplest method used to generate a high order low-pass filter, which has the downside of needing more coefficients than more complex method to perform a given attenuation in the stop band.
It generates linear phase filters coefficients.
Note: The flatTop WindowingMethod generates an impulse response with a maximum amplitude higher than one, and might be normalised if necessary depending on the applications.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
order | the order of the filter |
type | the type, must be a WindowingFunction::WindowingType |
beta | an optional additional parameter useful for the Kaiser windowing function |
Definition at line 34 of file juce_FilterDesign.cpp.
|
static |
This method returns an array of IIR::Coefficients, made to be used in cascaded IIRFilters, providing a minimum phase high-pass filter without any ripple in the pass band and in the stop band.
frequency | the cutoff frequency of the high-pass filter |
sampleRate | the sample rate being used in the filter design |
order | the order of the resulting IIR filter, providing an attenuation of -6 dB times order / octave |
Definition at line 578 of file juce_FilterDesign.cpp.
|
static |
This method generates arrays of IIR::Coefficients for a low-pass filter, with a cutoff frequency at half band, using an algorithm described in the article "Digital Signal Processing Schemes for efficient interpolation and decimation" from Pavel Valenzuela and Constantinides.
The result is a IIRPolyphaseAllpassStructure object.
The two members of this structure directPath and delayedPath are arrays of IIR::Coefficients, made of polyphase second order allpass filters and an additional delay in the second array, that can be used in cascaded filters processed in two parallel paths, which must be summed at the end to get the high order efficient low-pass filtering.
The gain of the resulting pass-band is 6 dB, so don't forget to compensate it if you want to use that method for something else than two times oversampling.
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
stopbandAmplitudedB | the maximum amplitude in dB expected in the stop band (must be negative) |
Definition at line 613 of file juce_FilterDesign.cpp.
|
static |
This method returns an array of IIR::Coefficients, made to be used in cascaded IIRFilters, providing a minimum phase low-pass filter without any ripple in the pass band and in the stop band.
The algorithms are based on "Lecture Notes on Elliptic Filter Design" by Sophocles J. Orfanidis.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
passbandAmplitudedB | the highest gain in dB expected in the pass band (must be negative) |
stopbandAmplitudedB | the gain in dB expected in the stop band (must be negative) |
Definition at line 341 of file juce_FilterDesign.cpp.
|
static |
This method returns an array of IIR::Coefficients, made to be used in cascaded IIRFilters, providing a minimum phase low-pass filter without any ripple in the pass band and in the stop band.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
order | the order of the resulting IIR filter, providing an attenuation of -6 dB times order / octave |
Definition at line 543 of file juce_FilterDesign.cpp.
|
static |
This method returns an array of IIR::Coefficients, made to be used in cascaded IIRFilters, providing a minimum phase low-pass filter without any ripple in the stop band only.
The algorithms are based on "Lecture Notes on Elliptic Filter Design" by Sophocles J. Orfanidis.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
passbandAmplitudedB | the highest amplitude in dB expected in the pass band (must be negative) |
stopbandAmplitudedB | the lowest amplitude in dB expected in the stop band (must be negative) |
Definition at line 352 of file juce_FilterDesign.cpp.
|
static |
This method returns an array of IIR::Coefficients, made to be used in cascaded IIRFilters, providing a minimum phase low-pass filter without any ripple in the pass band only.
The algorithms are based on "Lecture Notes on Elliptic Filter Design" by Sophocles J. Orfanidis.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
passbandAmplitudedB | the highest amplitude in dB expected in the pass band (must be negative) |
stopbandAmplitudedB | the lowest amplitude in dB expected in the stop band (must be negative) |
Definition at line 363 of file juce_FilterDesign.cpp.
|
static |
This method returns an array of IIR::Coefficients, made to be used in cascaded IIR::Filters, providing a minimum phase low-pass filter with ripples in both the pass band and in the stop band.
The algorithms are based on "Lecture Notes on Elliptic Filter Design" by Sophocles J. Orfanidis.
frequency | the cutoff frequency of the low-pass filter |
sampleRate | the sample rate being used in the filter design |
normalisedTransitionWidth | the normalised size between 0 and 0.5 of the transition between the pass band and the stop band |
passbandAmplitudedB | the highest amplitude in dB expected in the pass band (must be negative) |
stopbandAmplitudedB | the lowest amplitude in dB expected in the stop band (must be negative) |
Definition at line 374 of file juce_FilterDesign.cpp.