edu.cmu.sphinx.decoder.scorer

Class ThreadedAcousticScorer

java.lang.Object

edu.cmu.sphinx.util.props.ConfigurableAdapter

edu.cmu.sphinx.decoder.scorer.SimpleAcousticScorer

edu.cmu.sphinx.decoder.scorer.ThreadedAcousticScorer

All Implemented Interfaces:

AcousticScorer, Configurable

public class ThreadedAcousticScorer
extends SimpleAcousticScorer

An acoustic scorer that breaks the scoring up into a configurable number of separate threads.

All scores are maintained in LogMath log base

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_IS_CPU_RELATIVE The property that controls whether the number of available CPUs on the system is used when determining the number of threads to use for scoring.
static java.lang.String	PROP_MIN_SCOREABLES_PER_THREAD The property that controls the minimum number of scoreables sent to a thread.
static java.lang.String	PROP_NUM_THREADS The property that controls the number of threads that are used to score HMM states.
static java.lang.String	PROP_THREAD_PRIORITY The property that controls the thread priority of scoring threads.

Fields inherited from class edu.cmu.sphinx.decoder.scorer.SimpleAcousticScorer

FEATURE_FRONTEND, frontEnd, SCORE_NORMALIZER, scoreNormalizer

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

logger

Constructor Summary

Constructors

Constructor and Description
ThreadedAcousticScorer()
ThreadedAcousticScorer(BaseDataProcessor frontEnd, ScoreNormalizer scoreNormalizer, int minScoreablesPerThread, boolean cpuRelative, int numThreads, int threadPriority)

Method Summary

Modifier and Type	Method and Description
void	allocate() Allocates resources for this scorer
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.
void	newProperties(PropertySheet ps) This method is called when this configurable component needs to be reconfigured.

Methods inherited from class edu.cmu.sphinx.decoder.scorer.SimpleAcousticScorer

calculateScores, calculateScoresAndStoreData, calculateScoresForData, getNextData, startRecognition, stopRecognition

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

PROP_THREAD_PRIORITY

@S4Integer(defaultValue=5)
public static final java.lang.String PROP_THREAD_PRIORITY

The property that controls the thread priority of scoring threads. Must be a value between Thread.MIN_PRIORITY and Thread.MAX_PRIORITY, inclusive. The default is Thread.NORM_PRIORITY.

See Also:

Constant Field Values

PROP_NUM_THREADS

@S4Integer(defaultValue=0)
public static final java.lang.String PROP_NUM_THREADS

The property that controls the number of threads that are used to score HMM states. If the isCpuRelative property is false, then is is the exact number of threads that are used to score HMM states. If the isCpuRelative property is true, then this value is combined with the number of available processors on the system. If you want to have one thread per CPU available to score states, set the NUM_THREADS property to 0 and the isCpuRelative to true. If you want exactly one thread to process scores set NUM_THREADS to 1 and isCpuRelative to false.

If the value is 1 isCpuRelative is false no additional thread will be instantiated, and all computation will be done in the calling thread itself. The default value is 0.

See Also:

Constant Field Values

PROP_IS_CPU_RELATIVE

@S4Boolean(defaultValue=true)
public static final java.lang.String PROP_IS_CPU_RELATIVE

The property that controls whether the number of available CPUs on the system is used when determining the number of threads to use for scoring. If true, the NUM_THREADS property is combined with the available number of CPUS to determine the number of threads. Note that the number of threads is contained to be never lower than zero. Also, if the number of threads is 0, the states are scored on the calling thread, no separate threads are started. The default value is false.

See Also:

Constant Field Values

PROP_MIN_SCOREABLES_PER_THREAD

@S4Integer(defaultValue=10)
public static final java.lang.String PROP_MIN_SCOREABLES_PER_THREAD

The property that controls the minimum number of scoreables sent to a thread. This is used to prevent over threading of the scoring that could happen if the number of threads is high compared to the size of the active list. The default is 50

See Also:

Constant Field Values

Constructor Detail

ThreadedAcousticScorer

public ThreadedAcousticScorer(BaseDataProcessor frontEnd,
                              ScoreNormalizer scoreNormalizer,
                              int minScoreablesPerThread,
                              boolean cpuRelative,
                              int numThreads,
                              int threadPriority)

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.

minScoreablesPerThread - the number of threads that are used to score HMM states. If the isCpuRelative property is false, then is is the exact number of threads that are used to score HMM states. If the isCpuRelative property is true, then this value is combined with the number of available processors on the system. If you want to have one thread per CPU available to score states, set the NUM_THREADS property to 0 and the isCpuRelative to true. If you want exactly one thread to process scores set NUM_THREADS to 1 and isCpuRelative to false.

If the value is 1 isCpuRelative is false no additional thread will be instantiated, and all computation will be done in the calling thread itself. The default value is 0.

cpuRelative - controls whether the number of available CPUs on the system is used when determining the number of threads to use for scoring. If true, the NUM_THREADS property is combined with the available number of CPUS to determine the number of threads. Note that the number of threads is constrained to be never lower than zero. Also, if the number of threads is 0, the states are scored on the calling thread, no separate threads are started. The default value is false.

numThreads - the minimum number of scoreables sent to a thread. This is used to prevent over threading of the scoring that could happen if the number of threads is high compared to the size of the active list. The default is 50

threadPriority - the thread priority of scoring threads. Must be a value between Thread.MIN_PRIORITY and Thread.MAX_PRIORITY, inclusive. The default is Thread.NORM_PRIORITY.

ThreadedAcousticScorer

public ThreadedAcousticScorer()

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 SimpleAcousticScorer

Parameters:

ps - a property sheet holding the new data

Throws:

PropertyException - if there is a problem with the properties.

allocate

public void allocate()

Description copied from interface: AcousticScorer

Allocates resources for this scorer

Specified by:

allocate in interface AcousticScorer

Overrides:

allocate in class SimpleAcousticScorer

deallocate

public void deallocate()

Description copied from interface: AcousticScorer

Deallocates resources for this scorer

Specified by:

deallocate in interface AcousticScorer

Overrides:

deallocate in class SimpleAcousticScorer

doScoring

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

Description copied from class: SimpleAcousticScorer

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

Overrides:

doScoring in class SimpleAcousticScorer

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.