com.tagtraum.jipes.math

Class MultirateFilters.Interpolator

java.lang.Object

com.tagtraum.jipes.math.MultirateFilters.Interpolator

All Implemented Interfaces:

MapFunction<float[]>, StatefulMapFunction<float[]>

Enclosing class:

MultirateFilters

public static class MultirateFilters.Interpolator
extends Object
implements StatefulMapFunction<float[]>

Interpolator based on coefficients of a given Filters.FIRFilter. This class combines upsampling (i.e. zero stuffing) and filtering (to avoid aliasing).

Constructor Summary

Constructors

Constructor and Description
Interpolator(double[] coefficients, int factor) Creates an interpolator with the given FIR coefficients for filtering after upsampling to avoid aliasing.
Interpolator(Filters.FIRFilter filter, int factor) Creates an interpolator with the given FIR filter for filtering after upsampling to avoid aliasing.
Interpolator(int factor) Creates an interpolator using a simple fir1 16th order low pass filter.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
int	getFactor() Get upsample factor.
int	hashCode()
float[]	map(float[] data) Maps an object (usually an array, an RealAudioBuffer or a List) to another one of the same size.
void	reset() Resets the function's state.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Interpolator

public Interpolator(int factor)

Creates an interpolator using a simple fir1 16th order low pass filter.

Parameters:

factor - upsample factor

Throws:

IllegalArgumentException - if the upsample factor is not supported

See Also:

Filters.createFir1_16thOrderLowpass(int)

Interpolator

public Interpolator(double[] coefficients,
                    int factor)

Creates an interpolator with the given FIR coefficients for filtering after upsampling to avoid aliasing. It's recommended to use a multiple of the upsample factor as the number of coefficients. If that's not the case, zeros are added to the coefficients.

Parameters:

coefficients - FIR filter coefficients

factor - upsample factor

Interpolator

public Interpolator(Filters.FIRFilter filter,
                    int factor)

Creates an interpolator with the given FIR filter for filtering after upsampling to avoid aliasing. It's recommended to use a filter with a multiple of the upsample factor as the number of coefficients (taps). If that's not the case, zeros are added to the filter's coefficients.

Parameters:

filter - FIR filter

factor - upsample factor

Method Detail

reset

public void reset()

Description copied from interface: StatefulMapFunction

Resets the function's state.

Specified by:

reset in interface StatefulMapFunction<float[]>

getFactor

public int getFactor()

Get upsample factor.

Returns:

upsample factor

map

public float[] map(float[] data)

Description copied from interface: MapFunction

Maps an object (usually an array, an RealAudioBuffer or a List) to another one of the same size.

Specified by:

map in interface MapFunction<float[]>

Parameters:

data - data

Returns:

mapped data

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object