marytts.signalproc.analysis

Class ShortTermSpectrumAnalyser

java.lang.Object

marytts.signalproc.process.FrameProvider

marytts.signalproc.analysis.FrameBasedAnalyser<double[]>

marytts.signalproc.analysis.ShortTermSpectrumAnalyser

Direct Known Subclasses:

ShortTermLogSpectrumAnalyser, ShortTermPhaseSpectrumAnalyser

public class ShortTermSpectrumAnalyser
extends FrameBasedAnalyser<double[]>

Author:

Marc Schröder Implements a frame based spectrum analyser

Nested Class Summary

Nested classes/interfaces inherited from class marytts.signalproc.analysis.FrameBasedAnalyser

FrameBasedAnalyser.FrameAnalysisResult<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected double[]	real

Fields inherited from class marytts.signalproc.analysis.FrameBasedAnalyser

analysisResults

Fields inherited from class marytts.signalproc.process.FrameProvider

frame, frameLength, frameShift, frameStart, nextFrameStart, processor, samplingRate, signal, totalRead, validSamplesInFrame

Constructor Summary

Constructors

Constructor and Description
ShortTermSpectrumAnalyser(DoubleDataSource signal, int fftSize, Window window, int frameShift, int samplingRate) Initialise a FrameBasedAnalyser.

Method Summary

Methods

Modifier and Type	Method and Description
double[]	analyse(double[] frame) Apply this FrameBasedAnalyser to the given data.
int	getFFTWindowLength()
double	getFrequencyResolution() The distance of two adjacent points on the frequency axis, in Hertz.

Methods inherited from class marytts.signalproc.analysis.FrameBasedAnalyser

analyseAllFrames, analyseAvailableFrames, analyseNextFrame, constructAnalysisResult

Methods inherited from class marytts.signalproc.process.FrameProvider

getCurrentFrame, getData, getFrameLengthSamples, getFrameLengthTime, getFrameShiftSamples, getFrameShiftTime, getFrameStartSamples, getFrameStartTime, getNextFrame, getSamplingRate, hasMoreData, main, resetInternalTimer, stopWhenTouchingEnd, validSamplesInFrame

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

real

protected double[] real

Constructor Detail

ShortTermSpectrumAnalyser

public ShortTermSpectrumAnalyser(DoubleDataSource signal,
                         int fftSize,
                         Window window,
                         int frameShift,
                         int samplingRate)

Initialise a FrameBasedAnalyser.

Parameters:

signal - the signal source to read from

fftSize - the size of the FFT to use

window - the window function to apply to each frame

frameShift - the number of samples by which to shift the window from one frame analysis to the next; if this is smaller than window.getLength(), frames will overlap.

samplingRate - the number of samples in one second.

Throws:

IllegalArgumentException - if the window is longer than fftSize, or fftSize is not a power of two.

Method Detail

analyse

public double[] analyse(double[] frame)

Apply this FrameBasedAnalyser to the given data.

Specified by:

analyse in class FrameBasedAnalyser<double[]>

Parameters:

frame - the data to analyse, which must be of the length prescribed by this FrameBasedAnalyser, i.e. by works like FrameProvider.getFrameLengthSamples() .

Returns:

a double array of half the frame length

Throws:

IllegalArgumentException - if frame does not have the prescribed length

getFrequencyResolution

public double getFrequencyResolution()

The distance of two adjacent points on the frequency axis, in Hertz.

Returns:

samplingRate / real.length

getFFTWindowLength

public int getFFTWindowLength()