edu.cmu.sphinx.linguist.allphone

Class AllphoneLinguist

java.lang.Object

edu.cmu.sphinx.linguist.allphone.AllphoneLinguist

All Implemented Interfaces:

Linguist, Configurable

public class AllphoneLinguist
extends java.lang.Object
implements Linguist

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_ACOUSTIC_MODEL The property that defines the acoustic model to use when building the search graph
static java.lang.String	PROP_CD The property that controls whether to use context dependent phones.
static java.lang.String	PROP_PIP The property that controls phone insertion probability.

Fields inherited from interface edu.cmu.sphinx.linguist.Linguist

PROP_FILLER_INSERTION_PROBABILITY, PROP_LANGUAGE_WEIGHT, PROP_SILENCE_INSERTION_PROBABILITY, PROP_UNIT_INSERTION_PROBABILITY, PROP_WORD_INSERTION_PROBABILITY

Constructor Summary

Constructors

Constructor and Description
AllphoneLinguist()

Method Summary

Modifier and Type	Method and Description
void	allocate() Allocates the linguist.
void	deallocate() Deallocates the linguist.
AcousticModel	getAcousticModel()
java.util.ArrayList<HMM>	getCDSuccessors(Unit lc, Unit base)
java.util.ArrayList<HMM>	getCISuccessors()
float	getPhoneInsertionProb()
SearchGraph	getSearchGraph() Retrieves search graph.
java.util.ArrayList<Unit>	getUnits(SenoneSequence senoneSeq)
void	newProperties(PropertySheet ps) This method is called when this configurable component needs to be reconfigured.
void	startRecognition() Called before a recognition.
void	stopRecognition() Called after a recognition.
boolean	useContextDependentPhones()

Methods inherited from class java.lang.Object

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

Field Detail

PROP_ACOUSTIC_MODEL

@S4Component(type=AcousticModel.class)
public static final java.lang.String PROP_ACOUSTIC_MODEL

The property that defines the acoustic model to use when building the search graph

See Also:

Constant Field Values

PROP_PIP

@S4Double(defaultValue=0.05)
public static final java.lang.String PROP_PIP

The property that controls phone insertion probability. Default value for context independent phoneme decoding is 0.05, while for context dependent - 0.01.

See Also:

Constant Field Values

PROP_CD

@S4Boolean(defaultValue=false)
public static final java.lang.String PROP_CD

The property that controls whether to use context dependent phones. Changing it for true, don't forget to tune phone insertion probability.

See Also:

Constant Field Values

Constructor Detail

AllphoneLinguist

public AllphoneLinguist()

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

Parameters:

ps - a property sheet holding the new data

Throws:

PropertyException - if there is a problem with the properties.

getSearchGraph

public SearchGraph getSearchGraph()

Description copied from interface: Linguist

Retrieves search graph. The search graph represents the search space to be used to guide the search.

Implementor's note: This method is typically called at the beginning of each recognition and therefore should be

Specified by:

getSearchGraph in interface Linguist

Returns:

the search graph

startRecognition

public void startRecognition()

Description copied from interface: Linguist

Called before a recognition. This method gives a linguist the opportunity to prepare itself before a recognition begins.

Implementor's Note - Some linguists (or underlying lanaguge or acoustic models) may keep caches or pools that need to be initialzed before a recognition. A linguist may implement this method to perform such initialization. Note however, that an ideal linguist will, once allocated, be state-less. This will allow the linguist to be shared by multiple simulataneous searches. Reliance on a 'startRecognition' may prevent a linguist from being used in a multi-threaded search.

Specified by:

startRecognition in interface Linguist

stopRecognition

public void stopRecognition()

Description copied from interface: Linguist

Called after a recognition. This method gives a linguist the opportunity to clean up after a recognition has been completed.

Implementor's Note - Some linguists (or underlying lanaguge or acoustic models) may keep caches or pools that need to be flushed after a recognition. A linguist may implement this method to perform such flushing. Note however, that an ideal linguist will once allocated, be state-less. This will allow the linguist to be shared by multiple simulataneous searches. Reliance on a 'stopRecognition' may prevent a linguist from being used in a multi-threaded search.

Specified by:

stopRecognition in interface Linguist

allocate

public void allocate()
              throws java.io.IOException

Description copied from interface: Linguist

Allocates the linguist. Resources allocated by the linguist are allocated here. This method may take many seconds to complete depending upon the linguist.

Implementor's Note - A well written linguist will allow allocate to be called multiple times without harm. This will allow a linguist to be shared by multiple search managers.

Specified by:

allocate in interface Linguist

Throws:

java.io.IOException - if an IO error occurs

deallocate

public void deallocate()
                throws java.io.IOException

Description copied from interface: Linguist

Deallocates the linguist. Any resources allocated by this linguist are released.

Implementor's Note - if the linguist is being shared by multiple searches, the deallocate should only actually deallocate things when the last call to deallocate is made. Two approaches for dealing with this:

(1) Keep an allocation counter that is incremented during allocate and decremented during deallocate. Only when the counter reaches zero should the actually deallocation be performed.

(2) Do nothing in dellocate - just the the GC take care of things

Specified by:

deallocate in interface Linguist

Throws:

java.io.IOException - if an IO error occurs

getAcousticModel

public AcousticModel getAcousticModel()

getPhoneInsertionProb

public float getPhoneInsertionProb()

useContextDependentPhones

public boolean useContextDependentPhones()

getCISuccessors

public java.util.ArrayList<HMM> getCISuccessors()

getCDSuccessors

public java.util.ArrayList<HMM> getCDSuccessors(Unit lc,
                                                Unit base)

getUnits

public java.util.ArrayList<Unit> getUnits(SenoneSequence senoneSeq)