edu.cmu.sphinx.decoder.scorer

Class SimpleAcousticScorer

java.lang.Object

edu.cmu.sphinx.util.props.ConfigurableAdapter

edu.cmu.sphinx.decoder.scorer.SimpleAcousticScorer

All Implemented Interfaces:

AcousticScorer, Configurable

Direct Known Subclasses:

ThreadedAcousticScorer

public class SimpleAcousticScorer
extends ConfigurableAdapter
implements AcousticScorer

Implements some basic scorer functionality, including a simple default acoustic scoring implementation which scores within the current thread, that can be changed by overriding the doScoring(java.util.List<T>, edu.cmu.sphinx.frontend.Data) method.

Note that all scores are maintained in LogMath log base.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FEATURE_FRONTEND Property the defines the frontend to retrieve features from for scoring
protected BaseDataProcessor	frontEnd
static java.lang.String	SCORE_NORMALIZER An optional post-processor for computed scores that will normalize scores.
protected ScoreNormalizer	scoreNormalizer

Fields inherited from class edu.cmu.sphinx.util.props.ConfigurableAdapter

logger

Constructor Summary

Constructors

Constructor and Description
SimpleAcousticScorer()
SimpleAcousticScorer(BaseDataProcessor frontEnd, ScoreNormalizer scoreNormalizer)

Method Summary

Modifier and Type	Method and Description
void	allocate() Allocates resources for this scorer
Data	calculateScores(java.util.List<? extends Scoreable> scoreableList) Scores the given set of states.
Data	calculateScoresAndStoreData(java.util.List<? extends Scoreable> scoreableList) Scores the given set of states over previously acoustic data from frontend and stores latter in the queue
protected Data	calculateScoresForData(java.util.List<? extends Scoreable> scoreableList, Data data)
void	deallocate() Deallocates resources for this scorer
protected <T extends Scoreable> T	doScoring(java.util.List<T> scoreableList, Data data) Scores a a list of Scoreables given a Data -object.
protected Data	getNextData()
void	newProperties(PropertySheet ps) This method is called when this configurable component needs to be reconfigured.
void	startRecognition() starts the scorer
void	stopRecognition() stops the scorer

Methods inherited from class edu.cmu.sphinx.util.props.ConfigurableAdapter

getName, initLogger, toString

Methods inherited from class java.lang.Object

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

Field Detail

FEATURE_FRONTEND

@S4Component(type=BaseDataProcessor.class)
public static final java.lang.String FEATURE_FRONTEND

Property the defines the frontend to retrieve features from for scoring

See Also:

Constant Field Values

frontEnd

protected BaseDataProcessor frontEnd

SCORE_NORMALIZER

@S4Component(type=ScoreNormalizer.class,
             mandatory=false)
public static final java.lang.String SCORE_NORMALIZER

An optional post-processor for computed scores that will normalize scores. If not set, no normalization will applied and the token scores will be returned unchanged.

See Also:

Constant Field Values

scoreNormalizer

protected ScoreNormalizer scoreNormalizer

Constructor Detail

SimpleAcousticScorer

public SimpleAcousticScorer(BaseDataProcessor frontEnd,
                            ScoreNormalizer scoreNormalizer)

Parameters:

frontEnd - the frontend to retrieve features from for scoring

scoreNormalizer - optional post-processor for computed scores that will normalize scores. If not set, no normalization will applied and the token scores will be returned unchanged.

SimpleAcousticScorer

public SimpleAcousticScorer()

Method Detail

newProperties

public void newProperties(PropertySheet ps)
                   throws PropertyException

Description copied from interface: Configurable

This method is called when this configurable component needs to be reconfigured.

Specified by:

newProperties in interface Configurable

Overrides:

newProperties in class ConfigurableAdapter

Parameters:

ps - a property sheet holding the new data

Throws:

PropertyException - if there is a problem with the properties.

calculateScores

public Data calculateScores(java.util.List<? extends Scoreable> scoreableList)

Scores the given set of states.

Specified by:

calculateScores in interface AcousticScorer

Parameters:

scoreableList - A list containing scoreable objects to be scored

Returns:

The best scoring scoreable, or null if there are no more features to score

calculateScoresAndStoreData

public Data calculateScoresAndStoreData(java.util.List<? extends Scoreable> scoreableList)

Description copied from interface: AcousticScorer

Scores the given set of states over previously acoustic data from frontend and stores latter in the queue

Specified by:

calculateScoresAndStoreData in interface AcousticScorer

Parameters:

scoreableList - a list containing Scoreable objects to be scored

Returns:

the best scoring scoreable, or null if there are no more frames to score

calculateScoresForData

protected Data calculateScoresForData(java.util.List<? extends Scoreable> scoreableList,
                                      Data data)

getNextData

protected Data getNextData()

startRecognition

public void startRecognition()

Description copied from interface: AcousticScorer

starts the scorer

Specified by:

startRecognition in interface AcousticScorer

stopRecognition

public void stopRecognition()

Description copied from interface: AcousticScorer

stops the scorer

Specified by:

stopRecognition in interface AcousticScorer

doScoring

protected <T extends Scoreable> T doScoring(java.util.List<T> scoreableList,
                                            Data data)

Scores a a list of Scoreables given a Data -object.

Type Parameters:

T - type for scorables

Parameters:

scoreableList - The list of Scoreables to be scored

data - The Data-object to be used for scoring.

Returns:

the best scoring Scoreable or null if the list of scoreables was empty.

allocate

public void allocate()

Description copied from interface: AcousticScorer

Allocates resources for this scorer

Specified by:

allocate in interface AcousticScorer

deallocate

public void deallocate()

Description copied from interface: AcousticScorer

Deallocates resources for this scorer

Specified by:

deallocate in interface AcousticScorer