Nsound::FilterBandRejectIIR Class Reference

#include <Nsound/FilterBandRejectIIR.h>

Inheritance diagram for Nsound::FilterBandRejectIIR:

Public Member Functions
	FilterBandRejectIIR (const float64 &sample_rate, uint32 n_poles, const float64 &frequency_Hz_low, const float64 &frequency_Hz_high, const float64 &percent_ripple=0.0)
virtual	~FilterBandRejectIIR ()
float64	getFrequencyLow () const
float64	getFrequencyHigh () const
AudioStream	filter (const AudioStream &x)
AudioStream	filter (const AudioStream &x, const float64 &f)
AudioStream	filter (const AudioStream &x, const Buffer &frequencies)
AudioStream	filter (const AudioStream &x, const float64 &f_low, const float64 &f_high)
AudioStream	filter (const AudioStream &x, const Buffer &low_frequencies, const Buffer &high_frequencies)
Buffer	filter (const Buffer &x)
Buffer	filter (const Buffer &x, const float64 &f)
Buffer	filter (const Buffer &x, const Buffer &frequencies)
Buffer	filter (const Buffer &x, const float64 &f_low, const float64 &f_high)
Buffer	filter (const Buffer &x, const Buffer &frequencies_Hz_low, const Buffer &frequencies_Hz_high)
virtual float64	filter (const float64 &x)
virtual float64	filter (const float64 &x, const float64 &frequency_Hz)
virtual float64	filter (const float64 &x, const float64 &frequency_Hz_low, const float64 &frequency_Hz_high)
void	plot (boolean show_fc=true, boolean show_phase=false)
void	reset ()
void	setRealtime (bool flag)
Buffer	getFrequencyAxis (const uint32 n_fft=8192)
Buffer	getFrequencyResponse (const uint32 n_fft=8192)
Buffer	getImpulseResponse (const uint32 n_samples=8192)
virtual uint32	getKernelSize () const
Buffer	getPhaseResponse ()
float64	getSampleRate () const
void	plot (boolean show_phase=false)

Protected Attributes
FilterLowPassIIR *	low_
FilterHighPassIIR *	high_
float64	sample_rate_
float64	two_pi_over_sample_rate_
float64	sample_time_
uint32	kernel_size_
bool	is_realtime_

Private Member Functions
	FilterBandRejectIIR (const FilterBandRejectIIR &copy)
FilterBandRejectIIR &	operator= (const FilterBandRejectIIR &rhs)

Detailed Description

Definition at line 49 of file FilterBandRejectIIR.h.

Constructor & Destructor Documentation

FilterBandRejectIIR::FilterBandRejectIIR	(	const float64 &	sample_rate,
		uint32	n_poles,
		const float64 &	frequency_Hz_low,
		const float64 &	frequency_Hz_high,
		const float64 &	percent_ripple = 0.0
	)

Definition at line 49 of file FilterBandRejectIIR.cc.

References Nsound::Filter::kernel_size_, and reset().

    :
    Filter(sample_rate),
    low_(new  FilterLowPassIIR(
        sample_rate,
        n_poles,
        frequency_Hz_low,
        percent_ripple)),
    high_(new FilterHighPassIIR(
        sample_rate,
        n_poles,
        frequency_Hz_high,
        percent_ripple))
{
    reset();

    kernel_size_ = n_poles;
}

FilterBandRejectIIR::~FilterBandRejectIIR ( )

virtual

Definition at line 74 of file FilterBandRejectIIR.cc.

References high_, and low_.

{
    delete low_;
    delete high_;
}

Nsound::FilterBandRejectIIR::FilterBandRejectIIR ( const FilterBandRejectIIR &  copy )

private

Member Function Documentation

float64 FilterBandRejectIIR::getFrequencyLow

(

)

const

Definition at line 82 of file FilterBandRejectIIR.cc.

References Nsound::FilterLowPassIIR::getFrequency(), and low_.

{
    return low_->getFrequency();
}

float64 FilterBandRejectIIR::getFrequencyHigh

(

)

const

Definition at line 89 of file FilterBandRejectIIR.cc.

References Nsound::FilterHighPassIIR::getFrequency(), and high_.

{
    return high_->getFrequency();
}

AudioStream FilterBandRejectIIR::filter

(

const AudioStream &

x

)

Definition at line 96 of file FilterBandRejectIIR.cc.

References Nsound::Filter::filter().

Referenced by filter(), and main().

{
    return Filter::filter(x);
}

AudioStream FilterBandRejectIIR::filter	(	const AudioStream &	x,
		const float64 &	f
	)

Definition at line 103 of file FilterBandRejectIIR.cc.

References Nsound::Filter::filter().

{
    return Filter::filter(x);
}

AudioStream FilterBandRejectIIR::filter	(	const AudioStream &	x,
		const Buffer &	frequencies
	)

Definition at line 110 of file FilterBandRejectIIR.cc.

References Nsound::Filter::filter().

{
    return Filter::filter(x);
}

AudioStream FilterBandRejectIIR::filter	(	const AudioStream &	x,
		const float64 &	f_low,
		const float64 &	f_high
	)

Definition at line 117 of file FilterBandRejectIIR.cc.

References Nsound::FilterHighPassIIR::filter(), Nsound::FilterLowPassIIR::filter(), high_, Nsound::Filter::is_realtime_, low_, and reset().

{
    if(!is_realtime_) reset();

    return low_->filter(x, f_low)
         + high_->filter(x, f_high);
}

AudioStream FilterBandRejectIIR::filter	(	const AudioStream &	x,
		const Buffer &	low_frequencies,
		const Buffer &	high_frequencies
	)

Definition at line 130 of file FilterBandRejectIIR.cc.

References Nsound::FilterHighPassIIR::filter(), Nsound::FilterLowPassIIR::filter(), high_, Nsound::Filter::is_realtime_, low_, and reset().

{
    if(!is_realtime_) reset();

    return low_->filter(x, frequencies_Hz_low)
         + high_->filter(x, frequencies_Hz_high);
}

Buffer FilterBandRejectIIR::filter

(

const Buffer &

x

)

Definition at line 143 of file FilterBandRejectIIR.cc.

References Nsound::Filter::filter().

{
    return Filter::filter(x);
}

Buffer FilterBandRejectIIR::filter	(	const Buffer &	x,
		const float64 &	f
	)

Definition at line 150 of file FilterBandRejectIIR.cc.

References Nsound::Filter::filter().

{
    return Filter::filter(x);
}

Buffer FilterBandRejectIIR::filter	(	const Buffer &	x,
		const Buffer &	frequencies
	)

Definition at line 157 of file FilterBandRejectIIR.cc.

References Nsound::Filter::filter().

{
    return Filter::filter(x);
}

Buffer FilterBandRejectIIR::filter	(	const Buffer &	x,
		const float64 &	f_low,
		const float64 &	f_high
	)

Definition at line 164 of file FilterBandRejectIIR.cc.

References Nsound::FilterHighPassIIR::filter(), Nsound::FilterLowPassIIR::filter(), high_, Nsound::Filter::is_realtime_, low_, and reset().

{
    if(!is_realtime_) reset();

    return low_->filter(x, f_low)
         + high_->filter(x, f_high);
}

Buffer FilterBandRejectIIR::filter	(	const Buffer &	x,
		const Buffer &	frequencies_Hz_low,
		const Buffer &	frequencies_Hz_high
	)

Definition at line 177 of file FilterBandRejectIIR.cc.

References filter(), Nsound::Buffer::getLength(), Nsound::Filter::is_realtime_, and reset().

{
    if(!is_realtime_) reset();

    uint32 n_high_freqs = frequencies_Hz_high.getLength();
    uint32 n_low_freqs  = frequencies_Hz_low.getLength();

    Buffer y;

    uint32 x_samples = x.getLength();

    for(uint32 i = 0; i < x_samples; ++i)
    {
        y << FilterBandRejectIIR::filter(
            x[i],
            frequencies_Hz_low [i % n_low_freqs],
            frequencies_Hz_high[i % n_high_freqs]);
    }

    return y;
}

float64 FilterBandRejectIIR::filter ( const float64 &  x )

virtual

Implements Nsound::Filter.

Definition at line 204 of file FilterBandRejectIIR.cc.

References Nsound::FilterHighPassIIR::filter(), Nsound::FilterLowPassIIR::filter(), high_, and low_.

{
    return low_->filter(x) + high_->filter(x);
};

float64 FilterBandRejectIIR::filter ( const float64 &  x, const float64 &  frequency_Hz  )

virtual

Implements Nsound::Filter.

Definition at line 211 of file FilterBandRejectIIR.cc.

References filter().

{
    return FilterBandRejectIIR::filter(x);
}

float64 FilterBandRejectIIR::filter ( const float64 &  x, const float64 &  frequency_Hz_low, const float64 &  frequency_Hz_high  )

virtual

Definition at line 218 of file FilterBandRejectIIR.cc.

References Nsound::FilterHighPassIIR::filter(), Nsound::FilterLowPassIIR::filter(), high_, and low_.

{
    return low_->filter(x, frequencies_Hz_low)
        + high_->filter(x, frequencies_Hz_high);
}

void FilterBandRejectIIR::plot	(	boolean	show_fc = true,
		boolean	show_phase = false
	)

Definition at line 229 of file FilterBandRejectIIR.cc.

References Nsound::Plotter::axvline(), Nsound::FilterHighPassIIR::getFrequency(), Nsound::FilterLowPassIIR::getFrequency(), Nsound::Filter::getKernelSize(), high_, low_, Nsound::Filter::plot(), Nsound::Filter::sample_rate_, Nsound::Plotter::subplot(), and Nsound::Plotter::title().

Referenced by main().

{
    char title[128];
    sprintf(title,
        "Band Reject IIR Frequency Response\n"
        "order = %d, fl = %0.1f Hz, fl = %0.1f Hz, sr = %0.1f Hz",
        low_->getKernelSize() - 1,
        low_->getFrequency(),
        high_->getFrequency(),
        sample_rate_);

    Filter::plot(show_phase);

    Plotter pylab;

    uint32 n_rows = 1;

    if(show_phase)
    {
        n_rows = 2;
    }

    if(show_fc)
    {
        pylab.subplot(n_rows, 1, 1);

        pylab.axvline(low_->getFrequency(),"color='red'");
        pylab.axvline(high_->getFrequency(),"color='red'");

        pylab.title(title);
    }
}

void FilterBandRejectIIR::reset ( )

virtual

Resets interal history buffer and sets the cut off frequency to the one used at declaration.

Implements Nsound::Filter.

Definition at line 264 of file FilterBandRejectIIR.cc.

References high_, low_, Nsound::FilterHighPassIIR::reset(), and Nsound::FilterLowPassIIR::reset().

Referenced by filter(), and FilterBandRejectIIR().

{
    low_->reset();
    high_->reset();
}

FilterBandRejectIIR& Nsound::FilterBandRejectIIR::operator= ( const FilterBandRejectIIR &  rhs )

private

void Nsound::Filter::setRealtime ( bool  flag )

inlineinherited

Definition at line 57 of file Filter.h.

References Nsound::Filter::is_realtime_.

{is_realtime_ = flag;}

Buffer Filter::getFrequencyAxis ( const uint32  n_fft = 8192 )

inherited

Definition at line 185 of file Filter.cc.

References Nsound::FFTransform::roundUp2(), and Nsound::Filter::sample_rate_.

Referenced by main(), Nsound::Filter::plot(), and Nsound::FilterIIR::savePlot().

{
    uint32 fft_chunk_size = FFTransform::roundUp2(
        static_cast<int32>(n_fft));

    uint32 n_samples = fft_chunk_size / 2 + 1;

    float64 f_step = (1.0 / (static_cast<float64>(fft_chunk_size) / 2.0))
                   * (sample_rate_ / 2.0);

    Buffer f_axis;

    float64 f = 0.0;

    for(uint32 i = 0; i < n_samples; ++i)
    {
        f_axis << f;
        f += f_step;
    }

    return f_axis;
};

Buffer Filter::getFrequencyResponse ( const uint32  n_fft = 8192 )

inherited

Definition at line 210 of file Filter.cc.

References Nsound::FFTransform::fft(), Nsound::Filter::getImpulseResponse(), and Nsound::Filter::sample_rate_.

Referenced by Nsound::FilterBandPassIIR::FilterBandPassIIR(), FilterLeastSquaresFIR_UnitTest(), Nsound::FilterIIR::getRMS(), main(), Nsound::Filter::plot(), and Nsound::FilterIIR::savePlot().

{
    FFTransform fft(sample_rate_);

//~    fft.setWindow(HANNING);

    FFTChunkVector vec;

    vec = fft.fft(getImpulseResponse(), n_fft);

    return vec[0].getMagnitude();
}

Buffer Filter::getImpulseResponse ( const uint32  n_samples = 8192 )

inherited

Definition at line 225 of file Filter.cc.

References Nsound::Filter::filter(), Nsound::Filter::is_realtime_, and Nsound::Filter::reset().

Referenced by Nsound::Filter::getFrequencyResponse(), Nsound::FilterHighPassFIR::getImpulseResponse(), Nsound::FilterLowPassFIR::getImpulseResponse(), Nsound::FilterLeastSquaresFIR::getImpulseResponse(), Nsound::FilterIIR::getImpulseResponse(), and Nsound::Filter::getPhaseResponse().

{
    if(!is_realtime_) reset();

    Buffer response(n_samples);

    response << filter(1.0);

    for(uint32 i = 1; i < n_samples; ++i)
    {
        response << filter(0.0);
    }

    if(!is_realtime_) reset();

    return response;
}

virtual uint32 Nsound::Filter::getKernelSize ( ) const

inlinevirtualinherited

Reimplemented in Nsound::FilterIIR, and Nsound::FilterTone.

Definition at line 96 of file Filter.h.

References Nsound::Filter::kernel_size_.

Referenced by Nsound::FilterBandPassIIR::FilterBandPassIIR(), Nsound::FilterBandPassFIR::plot(), Nsound::FilterBandPassIIR::plot(), and plot().

{return kernel_size_;};

Buffer Filter::getPhaseResponse ( )

inherited

Definition at line 245 of file Filter.cc.

References Nsound::FFTransform::fft(), Nsound::Filter::getImpulseResponse(), Nsound::Buffer::getLength(), Nsound::Filter::sample_rate_, and Nsound::Buffer::subbuffer().

Referenced by Nsound::Filter::plot().

{
    uint32 n_samples = static_cast<uint32>(sample_rate_ * 2);

    FFTransform fft(n_samples);

    FFTChunkVector vec;

    vec = fft.fft(getImpulseResponse(), n_samples);

    Buffer phase = vec[0].getPhase();

    return phase.subbuffer(0, phase.getLength() / 2 + 1);
}

float64 Nsound::Filter::getSampleRate ( ) const

inlineinherited

Definition at line 102 of file Filter.h.

References Nsound::Filter::sample_rate_.

{ return sample_rate_; };

void Filter::plot ( boolean  show_phase = false )

inherited

Definition at line 262 of file Filter.cc.

References Nsound::Plotter::figure(), Nsound::Buffer::getdB(), Nsound::Filter::getFrequencyAxis(), Nsound::Filter::getFrequencyResponse(), Nsound::Buffer::getMax(), Nsound::Filter::getPhaseResponse(), Nsound::Plotter::plot(), Nsound::Plotter::subplot(), Nsound::Plotter::xlabel(), Nsound::Plotter::ylabel(), and Nsound::Plotter::ylim().

Referenced by main(), Nsound::FilterLowPassMoogVcf::plot(), Nsound::FilterPhaser::plot(), Nsound::FilterTone::plot(), Nsound::FilterHighPassIIR::plot(), Nsound::FilterCombLowPassFeedback::plot(), Nsound::FilterLowPassIIR::plot(), Nsound::FilterLowPassFIR::plot(), Nsound::FilterHighPassFIR::plot(), Nsound::FilterAllPass::plot(), Nsound::FilterBandPassVocoder::plot(), Nsound::FilterBandPassFIR::plot(), Nsound::FilterLeastSquaresFIR::plot(), Nsound::FilterFlanger::plot(), Nsound::FilterBandRejectFIR::plot(), Nsound::FilterBandPassIIR::plot(), plot(), and Nsound::FilterParametricEqualizer::plot().

{
    Buffer x = getFrequencyAxis();
    Buffer fr = getFrequencyResponse().getdB();

    Plotter pylab;

    pylab.figure();

    uint32 n_rows = 1;
    uint32 n_cols = 1;

    if(show_phase)
    {
        n_rows = 2;
    }

    pylab.subplot(n_rows, n_cols, 1);

    // Frequency response
    pylab.plot(x,fr, "blue");

    pylab.xlabel("Frequency (Hz)");
    pylab.ylabel("Frequency Response (dB)");

    // Phase response
    if(show_phase)
    {
        pylab.subplot(n_rows, n_cols, 2);

        Buffer pr = getPhaseResponse().getdB();

        pylab.plot(x,pr);

        pylab.xlabel("Frequency (Hz)");
        pylab.ylabel("Phase Response (dB)");
    }

    float64 ymax = fr.getMax();
    float64 height = ymax - -60.0;

    pylab.ylim(-60.0, ymax + 0.05 * height);
}

Member Data Documentation

FilterLowPassIIR* Nsound::FilterBandRejectIIR::low_

protected

Definition at line 135 of file FilterBandRejectIIR.h.

Referenced by filter(), getFrequencyLow(), plot(), reset(), and ~FilterBandRejectIIR().

FilterHighPassIIR* Nsound::FilterBandRejectIIR::high_

protected

Definition at line 136 of file FilterBandRejectIIR.h.

Referenced by filter(), getFrequencyHigh(), plot(), reset(), and ~FilterBandRejectIIR().

float64 Nsound::Filter::sample_rate_

protectedinherited

Definition at line 113 of file Filter.h.

Referenced by Nsound::FilterPhaser::filter(), Nsound::FilterCombLowPassFeedback::filter(), Nsound::FilterDelay::filter(), Nsound::FilterAllPass::FilterAllPass(), Nsound::FilterCombLowPassFeedback::FilterCombLowPassFeedback(), Nsound::FilterDelay::FilterDelay(), Nsound::FilterFlanger::FilterFlanger(), Nsound::FilterPhaser::FilterPhaser(), Nsound::FilterSlinky::FilterSlinky(), Nsound::Filter::getFrequencyAxis(), Nsound::Filter::getFrequencyResponse(), Nsound::Filter::getPhaseResponse(), Nsound::Filter::getSampleRate(), Nsound::FilterStageIIR::makeIIRKernelHelper(), Nsound::FilterHighPassFIR::makeKernel(), Nsound::FilterStageIIR::makeKernel(), Nsound::FilterBandPassVocoder::makeKernel(), Nsound::FilterLeastSquaresFIR::makeKernel(), Nsound::FilterParametricEqualizer::makeKernel(), Nsound::FilterPhaser::operator=(), Nsound::FilterLeastSquaresFIR::operator=(), Nsound::FilterFlanger::operator=(), Nsound::FilterIIR::operator=(), Nsound::FilterLowPassMoogVcf::plot(), Nsound::FilterPhaser::plot(), Nsound::FilterTone::plot(), Nsound::FilterHighPassIIR::plot(), Nsound::FilterLowPassIIR::plot(), Nsound::FilterCombLowPassFeedback::plot(), Nsound::FilterLowPassFIR::plot(), Nsound::FilterHighPassFIR::plot(), Nsound::FilterAllPass::plot(), Nsound::FilterBandPassFIR::plot(), Nsound::FilterLeastSquaresFIR::plot(), Nsound::FilterFlanger::plot(), Nsound::FilterBandRejectFIR::plot(), plot(), Nsound::FilterBandPassIIR::plot(), Nsound::FilterParametricEqualizer::plot(), Nsound::FilterLowPassIIR::setCutoff(), and Nsound::FilterLeastSquaresFIR::setWindow().

float64 Nsound::Filter::two_pi_over_sample_rate_

protectedinherited

Definition at line 114 of file Filter.h.

Referenced by Nsound::FilterTone::makeKernel(), Nsound::FilterLowPassFIR::makeKernel(), and Nsound::FilterParametricEqualizer::makeKernel().

float64 Nsound::Filter::sample_time_

protectedinherited

Definition at line 115 of file Filter.h.

Referenced by Nsound::FilterLowPassMoogVcf::_make_filter().

uint32 Nsound::Filter::kernel_size_

protectedinherited

Definition at line 116 of file Filter.h.

Referenced by Nsound::FilterLowPassFIR::filter(), Nsound::FilterLeastSquaresFIR::filter(), Nsound::FilterBandPassFIR::FilterBandPassFIR(), Nsound::FilterBandPassIIR::FilterBandPassIIR(), FilterBandRejectIIR(), Nsound::FilterHighPassIIR::FilterHighPassIIR(), Nsound::FilterLeastSquaresFIR::FilterLeastSquaresFIR(), Nsound::FilterLowPassFIR::FilterLowPassFIR(), Nsound::FilterLowPassIIR::FilterLowPassIIR(), Nsound::FilterLeastSquaresFIR::getKernel(), Nsound::Filter::getKernelSize(), Nsound::FilterHighPassFIR::makeKernel(), Nsound::FilterLowPassFIR::makeKernel(), Nsound::FilterBandRejectFIR::makeKernel(), Nsound::FilterLeastSquaresFIR::makeKernel(), Nsound::FilterLeastSquaresFIR::operator=(), Nsound::FilterLowPassFIR::plot(), Nsound::FilterHighPassFIR::plot(), Nsound::FilterLeastSquaresFIR::plot(), Nsound::FilterBandRejectFIR::plot(), Nsound::FilterLowPassFIR::reset(), Nsound::FilterHighPassFIR::reset(), Nsound::FilterLeastSquaresFIR::reset(), Nsound::FilterLeastSquaresFIR::setKernel(), Nsound::FilterLeastSquaresFIR::setWindow(), and Nsound::FilterHighPassFIR::spectraReversal_().

bool Nsound::Filter::is_realtime_

protectedinherited

Definition at line 118 of file Filter.h.

Referenced by Nsound::Filter::filter(), filter(), Nsound::FilterBandRejectFIR::filter(), Nsound::Filter::getImpulseResponse(), and Nsound::Filter::setRealtime().

---

The documentation for this class was generated from the following files:

• Nsound/FilterBandRejectIIR.h
• Nsound/FilterBandRejectIIR.cc