Known bugs and changelog

Version 0.9.3

• accelerate FIR/IIR online filtering (~2x)
• add 64-bit FIR/IIR filters and block convolvers (OLA/OLS)
• fix incorrect implementation of adaptive filtering
• slightly accelerate feature extractors
• bugfix: allow STFT have window size different from power-of-two
• add OverlapAddFilter base class for PV-based filters/effects
• [planned] replace FeatureVector objects with plain float[] arrays
• [planned] apply floor for log-energy in MFCC (should we?)
• [planned] add more effects (chorus, compressor), improve existing effects
• [planned] add Karplus-Strong builder
• [planned] add some 3D audio functionality (stereo pan, HRTF)

Version 0.9.2

• Add more IIR filters: Bessel, Chebyshev-I & II, Elliptic, Thiran
• Add TfToSos / SosToTf methods to DesignFilter class for working with second-order sections
• Add SavitzkyGolayFilter class (window size up to 31; derivatives 0, 1, 2)
• Add Fwt class for Fast Wavelet Transform and wavelets ("haar", "db1-20", "sym2-20", "coif1-5")
• Add PolyphaseSystem class
• Add PlpExtractor class
• Add Lpc class with new methods ToLsf / FromLsf, move LPC-related functions to Lpc
• Add more customizations in MfccExtractor class
• Add preconfigured extractors: MfccExtractorHtk and MfccExtractorSlaney
• Add more customizations in FilterBanks class
• Add VtlnWarper class
• Add Stft methods: MagnitudePhaseSpectrogram()/ReconstructMagnitudePhase()
• Add HarmonicPercussiveSeparator class
• Add GriffinLimReconstructor class
• Add Remez class for equiripple FIR filter design
• Add methods FirWin(Lp|Hp|Bp|Bs) and FirEquiripple(Lp|Hp|Bp|Bs) to DesignFilter class
• Fix bug with pre-emphasis in PnccExtractor that led to less accurate results
• Add lpcOrder parameter to LpccExtractor
• Add RealFft class and use it instead of Fft where possible (25-35% performance gain)
• Important change in interface and implementation of LTI filter classes:

// code in versions before 0.9.2
var filter = DesignFilter.FirLp(145, 0.15f);
var impulseResponse = filter.ImpulseResponse();
var magnitudeResponse = filter.FrequencyResponse().Magnitude;
var tf = filter.Tf;

// became:
var filter = new FirFilter(DesignFilter.FirWinLp(145, 0.15));
var impulseResponse = filter.Tf.ImpulseResponse();
var magnitudeResponse = filter.Tf.FrequencyResponse().Magnitude;
var tf = filter.Tf;  // looks the same, but now it's more optimized

// in short:
// FirFilter / IirFilter classes are now used only for filtering.
// Everything related to filter design & analysis as of ver.0.9.2
// is concentrated in TransferFunction class. It was here before,
// but FDA responsibilities were somewhat mixed between filters and Tf.

// Filter objects contained arrays of both 32-bit and 64-bit coefficients
// although filtering was (and still is) done with 32-bit floats
// and FDA was (and still is) done with 64-bit doubles.

// As of ver.0.9.2 filters contain only 32-bit coefficients for filtering
// and the reference to TransferFunction object (not null - only if needed).
// TF objects contain 64-bit numerator / denominator coefficients.

var filter = new IirFilter(new[] { 1, 0.2, -0.3 }, new[] { 1, 0.9 });
var tf = filter.Tf;
// in this case TransferFunction will be generated on the fly
// from 32-bit floats (so we'll lose precision).
// Internal Tf object of the filter is still null.
// Memory efficient, but this filter maybe lacks precision for filter analysis.
// If we need just to filter data, this is the best solution.

var filter = new IirFilter(new TransferFunction(new[]{ 1, 0.2, -0.3 }, new[]{ 1, 0.9 }));
var tf = filter.Tf;
// here the filter stores the reference to TF with 64-bit precision
// and Tf property returns this reference.
// If we use this filter only for filtering, then this constructor is redundant
// and memory inefficient.


// Surely, we can work just with TF object, without any filter objects:

var tf = new TransferFunction(new[] { 1, 0.2, -0.3 }, new[] { 1, 0.9 });
var zeros = tf.Zeros;
var freqResponse = tf.FrequencyResponse(1024);
// etc.

// 64-bit precision:
var tf1 = new TransferFunction(b, a);
var tf2 = new TransferFunction(d, c);
var tf = tf1 * tf2;

// 32-bit precision:
var filter1 = new IirFilter(b, a);
var filter2 = new IirFilter(d, c);
var filter = filter1 * filter2;


// also:
var hpFilter = DesignFilter.LpToHp(filter);
var lpFilter = DesignFilter.HpToLp(hpFilter);
var bpFilter = DesignFilter.FirBp(123, 0.05f, 0.15f);
var brFilter = DesignFilter.FirBr(201, 0.08f, 0.23f, WindowTypes.Kaiser);

// became:
var hpFilter = DesignFilter.FirLpToHp(filter);
var lpFilter = DesignFilter.FirHpToLp(hpFilter);
var bpFilter = DesignFilter.FirWinBp(123, 0.05, 0.15);
var brFilter = DesignFilter.FirWinBr(201, 0.08, 0.23, WindowTypes.Kaiser);

Version 0.9.1

• Add adaptive filters (LMS variations, LMF, RLS)
• Add Hartley transform
• Add Mellin transform
• Add wavetable and ADSR signal builders
• Add PitchShiftVocoderEffect class
• Add parameter int parallelThreads in ParallelComputeFrom method of feature extractors
• Add overloaded versions of ParallelComputeFrom methods with startSample and endSample parameters
• Implement online processing methods in SpectralSubtractor, WhisperEffect, RobotEffect, MorphEffect
• Phase Vocoder with Identity Phase Locking is used by default for TSM (instead of WSOLA)
• Trim feature names in FeatureDescriptions list of multi-feature extractors
• Move PitchExtractor to FeatureExtractors namespace
• Fix bug with incorrectly working pre-emphasis filter in Lpc/LpccExtractor
• Size of FFT in Pncc/SpnccExtractor is 0 by default (it'll be auto-derived)