Nsound::FilterSlinky Class Reference

#include <Nsound/FilterSlinky.h>

Inheritance diagram for Nsound::FilterSlinky:

[legend]

List of all members.

Public Member Functions
	FilterSlinky (const float64 &sample_rate, const float64 &delay_time, const float64 &frequency_window)
virtual	~FilterSlinky ()
AudioStream	filter (const AudioStream &x)
AudioStream	filter (const AudioStream &x, const Buffer &frequencies)
Buffer	filter (const Buffer &x)
Buffer	filter (const Buffer &x, const Buffer &frequencies)
float64	filter (const float64 &x)
float64	filter (const float64 &x, const float64 &frequency)
void	reset ()
AudioStream	filter (const AudioStream &x, const float64 &frequency)
Buffer	filter (const Buffer &x, const float64 &frequency)
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 Types
typedef std::vector < FilterDelay * >	DelayVector
typedef std::vector < FilterBandPassIIR * >	FilterVector
Protected Attributes
DelayVector	delay_lines_
FilterVector	filters_
float64	sample_rate_
float64	two_pi_over_sample_rate_
uint32	kernel_size_

---

Detailed Description

Base class for IIR Filters, defines the interface.

Definition at line 53 of file FilterSlinky.h.

---

Member Typedef Documentation

typedef std::vector< FilterDelay * > Nsound::FilterSlinky::DelayVector [protected]

Definition at line 98 of file FilterSlinky.h.

typedef std::vector< FilterBandPassIIR * > Nsound::FilterSlinky::FilterVector [protected]

Definition at line 99 of file FilterSlinky.h.

---

Constructor & Destructor Documentation

FilterSlinky::FilterSlinky	(	const float64 &	sample_rate,
		const float64 &	delay_time,
		const float64 &	frequency_window
	)

Definition at line 45 of file FilterSlinky.cc.

References delay_lines_, filters_, and Nsound::Filter::sample_rate_.

00050     :
00051     Filter(sample_rate),
00052     delay_lines_(),
00053     filters_()
00054 {
00055     float64 f = 0.0;
00056 
00057     while( f < sample_rate_ / 2.0)
00058     {
00059         if(f == 0.0)
00060         {
00061             f = frequency_octave;
00062         }
00063         else
00064         {
00065             f += frequency_octave;
00066         }
00067     }
00068 
00069     // Create the highest frequency pass band filter.
00070 
00071     float64 f_high = f;
00072     f -= frequency_octave;
00073     float64 f_low  = f;
00074 
00075     filters_.push_back(
00076         new FilterBandPassIIR(
00077             sample_rate_,
00078             6,
00079             f_low,
00080             f_high,
00081             0.01));
00082 
00083     // Create pass band filters for the remaing frequency octaves.
00084     float64 dt = delay_octave;
00085     while(f >= frequency_octave)
00086     {
00087         f_high = f;
00088         f -= frequency_octave;
00089         f_low = f;
00090 
00091         if(f_high == frequency_octave)
00092         {
00093             f_low = 0.0;
00094         }
00095 
00096         filters_.push_back(
00097         new FilterBandPassIIR(
00098             sample_rate_,
00099             6,
00100             f_low,
00101             f_high,
00102             0.01));
00103 
00104         delay_lines_.push_back(
00105             new FilterDelay(sample_rate_, dt));
00106 
00107         dt += delay_octave;
00108     }
00109 
00110 //~    cout << "n_filters = " << filters_.size() << endl
00111 //~         << "n_delays  = " << delay_lines_.size() << endl;
}

FilterSlinky::~FilterSlinky

(

)

[virtual]

Definition at line 115 of file FilterSlinky.cc.

References delay_lines_, filter(), and filters_.

{
    FilterVector::iterator filter = filters_.begin();
    FilterVector::iterator end    = filters_.end();

    DelayVector::iterator delay = delay_lines_.begin();

    delete *filter;
    ++filter;

    while(filter != end)
    {
        delete *filter;
        delete *delay;

        ++filter;
        ++delay;
    }
}

---

Member Function Documentation

AudioStream FilterSlinky::filter

(

const AudioStream &

x

)

Reimplemented from Nsound::Filter.

Definition at line 139 of file FilterSlinky.cc.

References Nsound::AudioStream::getNChannels(), and Nsound::AudioStream::getSampleRate().

Referenced by filter(), reset(), and ~FilterSlinky().

{
    uint32 n_channels = x.getNChannels();

    AudioStream y(x.getSampleRate(), n_channels);

    for(uint32 channel = 0; channel < n_channels; ++channel)
    {
        y[channel] = FilterSlinky::filter(x[channel]);
    }

    return y;
}

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

Reimplemented from Nsound::Filter.

Definition at line 156 of file FilterSlinky.cc.

References filter().

{
    return FilterSlinky::filter(x);
}

Buffer FilterSlinky::filter

(

const Buffer &

x

)

Reimplemented from Nsound::Filter.

Definition at line 164 of file FilterSlinky.cc.

References filter(), and Nsound::Buffer::getLength().

{
    Buffer y;

    uint32 n_samples = x.getLength();

    for(uint32 n = 0; n < n_samples; ++n)
    {
        y << FilterSlinky::filter(x[n]);
    }

    return y;
}

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

Reimplemented from Nsound::Filter.

Definition at line 181 of file FilterSlinky.cc.

References filter().

{
    return FilterSlinky::filter(x);
}

float64 FilterSlinky::filter

(

const float64 &

x

)

[virtual]

Implements Nsound::Filter.

Definition at line 189 of file FilterSlinky.cc.

References delay_lines_, filter(), and filters_.

{
    float64 y = 0.0;

    FilterVector::iterator filter = filters_.begin();
    FilterVector::iterator end    = filters_.end();

    DelayVector::iterator delay = delay_lines_.begin();

    // There is always one more filter than delay lines, this is because the
    // highest frequency have zero delay.

    y += (*filter)->filter(x);

    ++filter;

    while(filter != end)
    {
        y += (*delay)->filter((*filter)->filter(x));

        ++filter;
        ++delay;
    }

    return y;
}

float64 FilterSlinky::filter	(	const float64 &	x,
		const float64 &	frequency
	)			[virtual]

Implements Nsound::Filter.

Definition at line 219 of file FilterSlinky.cc.

References filter().

{
    return FilterSlinky::filter(x);
}

void FilterSlinky::reset

(

)

[virtual]

Implements Nsound::Filter.

Definition at line 227 of file FilterSlinky.cc.

References delay_lines_, filter(), and filters_.

{
    FilterVector::iterator filter = filters_.begin();
    FilterVector::iterator end  = filters_.end();

    DelayVector::iterator delay = delay_lines_.begin();

    (*filter)->reset();
    ++filter;

    while(filter != end)
    {
        (*filter)->reset();
        (*delay)->reset();

        ++filter;
        ++delay;
    }

}

AudioStream Filter::filter	(	const AudioStream &	x,
		const float64 &	frequency
	)			[inherited]

Reimplemented in Nsound::FilterAllPass, Nsound::FilterBandPassIIR, Nsound::FilterBandRejectIIR, Nsound::FilterDelay, Nsound::FilterFlanger, Nsound::FilterHighPassFIR, Nsound::FilterHighPassIIR, Nsound::FilterLeastSquaresFIR, Nsound::FilterLowPassFIR, Nsound::FilterLowPassIIR, and Nsound::FilterStageIIR.

Definition at line 72 of file Filter.cc.

References Nsound::Filter::filter(), Nsound::AudioStream::getNChannels(), Nsound::AudioStream::getSampleRate(), and Nsound::Filter::reset().

{
    reset();

    uint32 n_channels = x.getNChannels();

    AudioStream y(x.getSampleRate(), n_channels);

    for(uint32 channel = 0; channel < n_channels; ++channel)
    {
        y[channel] = filter(x[channel], frequency);
    }

    return y;
}

Buffer Filter::filter	(	const Buffer &	x,
		const float64 &	frequency
	)			[inherited]

Reimplemented in Nsound::FilterAllPass, Nsound::FilterBandPassIIR, Nsound::FilterBandRejectIIR, Nsound::FilterDelay, Nsound::FilterFlanger, Nsound::FilterHighPassFIR, Nsound::FilterHighPassIIR, Nsound::FilterLeastSquaresFIR, Nsound::FilterLowPassFIR, Nsound::FilterLowPassIIR, and Nsound::FilterStageIIR.

Definition at line 129 of file Filter.cc.

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

{
    reset();

    Buffer::const_iterator itor = x.begin();
    Buffer::const_iterator end = x.end();

    Buffer y(x.getLength());

    while(itor != end)
    {
        y << filter(*itor, frequency);

        ++itor;
    }

    return y;
}

Buffer Filter::getFrequencyAxis

(

const uint32

n_fft = 8192

)

[inherited]

Definition at line 176 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 202 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]

Reimplemented in Nsound::FilterIIR.

Definition at line 218 of file Filter.cc.

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

Referenced by Nsound::Filter::getFrequencyResponse(), and Nsound::Filter::getPhaseResponse().

{
    reset();

    Buffer response(n_samples);

    response << filter(1.0);

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

    reset();

    return response;
}

virtual uint32 Nsound::Filter::getKernelSize

(

)

const [inline, virtual, inherited]

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

Definition at line 109 of file Filter.h.

References Nsound::Filter::kernel_size_.

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

{return kernel_size_;};

Buffer Filter::getPhaseResponse

(

)

[inherited]

Definition at line 239 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 [inline, inherited]

Definition at line 117 of file Filter.h.

References Nsound::Filter::sample_rate_.

{ return sample_rate_; };

void Filter::plot

(

boolean

show_phase = false

)

[inherited]

Definition at line 257 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().

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

    Plotter pylab;

    pylab.figure();

    int subplot_int = 111;

    if(show_phase)
    {
        subplot_int = 211;
    }

    pylab.subplot(subplot_int);

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

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

    // Phase response
    if(show_phase)
    {
        pylab.subplot(subplot_int + 1);

        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

DelayVector Nsound::FilterSlinky::delay_lines_ [protected]

Definition at line 101 of file FilterSlinky.h.

Referenced by filter(), FilterSlinky(), reset(), and ~FilterSlinky().

FilterVector Nsound::FilterSlinky::filters_ [protected]

Definition at line 102 of file FilterSlinky.h.

Referenced by filter(), FilterSlinky(), reset(), and ~FilterSlinky().

float64 Nsound::Filter::sample_rate_ [protected, inherited]

Definition at line 131 of file Filter.h.

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

float64 Nsound::Filter::two_pi_over_sample_rate_ [protected, inherited]

Definition at line 132 of file Filter.h.

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

uint32 Nsound::Filter::kernel_size_ [protected, inherited]

Definition at line 133 of file Filter.h.

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

---

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

• Nsound/FilterSlinky.h
• Nsound/FilterSlinky.cc