marytts.signalproc.process

Class EnergyNormaliser

java.lang.Object

marytts.signalproc.process.EnergyNormaliser

All Implemented Interfaces:

AudioProcessor

public class EnergyNormaliser
extends Object
implements AudioProcessor

Author:

Marc Schröder

Field Summary

Fields

Modifier and Type	Field and Description
protected double	amplitudeFactor
protected double	referencePower

Constructor Summary

Constructors

Constructor and Description
EnergyNormaliser(AudioInputStream reference) Adapt the amplitudes of a signal such that the average power is the same as the one in the reference.
EnergyNormaliser(double energyFactor) Adapt the amplitudes of a signal such that the energy changes by the given factor.
EnergyNormaliser(DoubleDataSource reference) Adapt the amplitudes of a signal such that the average power is the same as the one in the reference.

Method Summary

Methods

Modifier and Type	Method and Description
AudioInputStream	apply(AudioInputStream ais) Apply this processor inline on the given audio input stream.
DoubleDataSource	apply(DoubleDataSource signal)
static double	determineAveragePower(AudioInputStream ais) For a given audio input stream, determine the average power.
static double	determineAveragePower(double[] signal) For a given audio signal and sampling rate, determine the average power.
static double	determineAveragePower(DoubleDataSource signal) For a given audio signal, determine the average power.
double	getAmplitudeFactor()
double	getReferencePower()
static void	main(String[] args)

Methods inherited from class java.lang.Object

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

Field Detail

amplitudeFactor

protected double amplitudeFactor

referencePower

protected double referencePower

Constructor Detail

EnergyNormaliser

public EnergyNormaliser(double energyFactor)

Adapt the amplitudes of a signal such that the energy changes by the given factor.

Parameters:

energyFactor - energy factor

EnergyNormaliser

public EnergyNormaliser(AudioInputStream reference)

Adapt the amplitudes of a signal such that the average power is the same as the one in the reference.

Parameters:

reference - an audio input stream with the reference power.

EnergyNormaliser

public EnergyNormaliser(DoubleDataSource reference)

Adapt the amplitudes of a signal such that the average power is the same as the one in the reference.

Parameters:

reference - an audio signal with the reference power.

Method Detail

getAmplitudeFactor

public double getAmplitudeFactor()

getReferencePower

public double getReferencePower()

determineAveragePower

public static double determineAveragePower(AudioInputStream ais)

For a given audio input stream, determine the average power.

Parameters:

ais - audio input stream for which to determine the average power

Returns:

a non-negative double representing the average power as energy per sample, i.e. the total energy divided by the total duration.

determineAveragePower

public static double determineAveragePower(DoubleDataSource signal)

For a given audio signal, determine the average power.

Parameters:

signal - a double data source for which to determine the average power

Returns:

a non-negative double representing the average power as energy per sample, i.e. the total energy divided by the total duration.

determineAveragePower

public static double determineAveragePower(double[] signal)

For a given audio signal and sampling rate, determine the average power.

Parameters:

signal - audio signal for which to determine the average power

Returns:

a non-negative double representing the average power as energy per sample, i.e. the total energy divided by the total duration.

apply

public AudioInputStream apply(AudioInputStream ais)

Description copied from interface: AudioProcessor

Apply this processor inline on the given audio input stream. It is expected to work continuously, i.e. it should start providing audio data before having read all input data.

Specified by:

apply in interface AudioProcessor

Parameters:

ais - ais

Returns:

ais

apply

public DoubleDataSource apply(DoubleDataSource signal)

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception