edu.cmu.sphinx.linguist.acoustic.tiedstate.trainer

Class Sphinx3Saver

java.lang.Object

edu.cmu.sphinx.linguist.acoustic.tiedstate.trainer.Sphinx3Saver

All Implemented Interfaces:

Saver, Configurable

public class Sphinx3Saver
extends java.lang.Object
implements Saver

An acoustic model saver that saves sphinx3 ascii data.

Mixture weights and transition probabilities are saved in linear scale.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	BYTE_ORDER_MAGIC
protected static int	CONTEXT_SIZE
static java.lang.String	DATA_LOCATION
static java.lang.String	DEF_FILE
protected static java.lang.String	DENSITY_FILE_VERSION
protected static java.lang.String	FILLER
static java.lang.String	LOADER
protected java.util.logging.Logger	logger
protected LogMath	logMath
protected static java.lang.String	MIXW_FILE_VERSION
static java.lang.String	MODEL_VERSION
static java.lang.String	PROP_MC_FLOOR
static java.lang.String	PROP_SPARSE_FORM The property specifying whether the transition matrices of the acoustic model is in sparse form, i.e., omitting the zeros of the non-transitioning states.
static java.lang.String	PROP_USE_CD_UNITS
static java.lang.String	PROP_VECTOR_LENGTH
static java.lang.String	SAVE_LOCATION
protected static java.lang.String	SILENCE_CIPHONE
protected boolean	sparseForm
protected static java.lang.String	TMAT_FILE_VERSION
boolean	useCDUnits

Fields inherited from interface edu.cmu.sphinx.linguist.acoustic.tiedstate.Saver

PROP_MW_FLOOR, PROP_VARIANCE_FLOOR

Constructor Summary

Constructors

Constructor and Description
Sphinx3Saver()

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	getCheckSum() Return the checksum string.
java.util.Map<java.lang.String,Unit>	getContextIndependentUnits() Returns the map of context indepent units.
protected boolean	getDoCheckSum() Return whether to do the dochecksum.
HMMManager	getHMMManager() Returns the HMM Manager for this loader.
int	getLeftContextSize() Returns the size of the left context for context dependent units.
protected java.lang.String	getLocation() Return the location.
Pool<float[]>	getMeansPool() Gets the pool of means for this loader.
Pool<float[][]>	getMeansTransformationMatrixPool() Gets the pool of means transformation matrices for this loader.
Pool<float[]>	getMeansTransformationVectorPool() Gets the pool of means transformation vectors for this loader.
int	getRightContextSize() Returns the size of the right context for context dependent units.
Pool<Senone>	getSenonePool() Gets the senone pool for this loader.
Pool<float[]>	getVariancePool() Gets the variance pool.
Pool<float[][]>	getVarianceTransformationMatrixPool() Gets the variance transformation matrix pool.
Pool<float[]>	getVarianceTransformationVectorPool() Gets the variance transformation vectorpool.
void	logInfo() logs information about this loader
void	newProperties(PropertySheet ps) This method is called when this configurable component needs to be reconfigured.
void	save(java.lang.String modelName, boolean b) Saves the AcousticModel from a directory in the file system.
protected void	saveTransitionMatricesAscii(Pool<float[][]> pool, java.lang.String path, boolean append) Saves the transition matrices
protected void	saveTransitionMatricesBinary(Pool<float[][]> pool, java.lang.String path, boolean append) Saves the transition matrices (Binary)
protected void	writeFloat(java.io.DataOutputStream dos, float val) Writes a float to the output stream, byte-swapping as necessary
protected void	writeFloatArray(java.io.DataOutputStream dos, float[] data) Writes the given number of floats from an array of floats to a stream.
protected void	writeInt(java.io.DataOutputStream dos, int val) Writes an integer to the output stream, byte-swapping as necessary
protected java.io.DataOutputStream	writeS3BinaryHeader(java.lang.String location, java.lang.String path, java.util.Properties props, boolean append) Writes the S3 binary header to the given location+path.

Methods inherited from class java.lang.Object

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

Field Detail

PROP_SPARSE_FORM

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

The property specifying whether the transition matrices of the acoustic model is in sparse form, i.e., omitting the zeros of the non-transitioning states.

See Also:

Constant Field Values

sparseForm

protected boolean sparseForm

PROP_USE_CD_UNITS

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

See Also:

Constant Field Values

PROP_MC_FLOOR

@S4Double(defaultValue=0.0)
public static final java.lang.String PROP_MC_FLOOR

See Also:

Constant Field Values

LOADER

@S4Component(type=Loader.class)
public static final java.lang.String LOADER

See Also:

Constant Field Values

PROP_VECTOR_LENGTH

@S4Integer(defaultValue=39)
public static final java.lang.String PROP_VECTOR_LENGTH

See Also:

Constant Field Values

logger

protected java.util.logging.Logger logger

FILLER

protected static final java.lang.String FILLER

See Also:

Constant Field Values

SILENCE_CIPHONE

protected static final java.lang.String SILENCE_CIPHONE

See Also:

Constant Field Values

BYTE_ORDER_MAGIC

protected static final int BYTE_ORDER_MAGIC

See Also:

Constant Field Values

MODEL_VERSION

public static final java.lang.String MODEL_VERSION

See Also:

Constant Field Values

CONTEXT_SIZE

protected static final int CONTEXT_SIZE

See Also:

Constant Field Values

logMath

protected LogMath logMath

DENSITY_FILE_VERSION

protected static final java.lang.String DENSITY_FILE_VERSION

See Also:

Constant Field Values

MIXW_FILE_VERSION

protected static final java.lang.String MIXW_FILE_VERSION

See Also:

Constant Field Values

TMAT_FILE_VERSION

protected static final java.lang.String TMAT_FILE_VERSION

See Also:

Constant Field Values

SAVE_LOCATION

@S4String(defaultValue=".")
public static final java.lang.String SAVE_LOCATION

See Also:

Constant Field Values

DATA_LOCATION

@S4String(mandatory=false,
          defaultValue="")
public static final java.lang.String DATA_LOCATION

See Also:

Constant Field Values

DEF_FILE

@S4String(mandatory=false,
          defaultValue="")
public static final java.lang.String DEF_FILE

See Also:

Constant Field Values

useCDUnits

public boolean useCDUnits

Constructor Detail

Sphinx3Saver

public Sphinx3Saver()

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.

getCheckSum

protected java.lang.String getCheckSum()

Return the checksum string.

Returns:

the checksum

getDoCheckSum

protected boolean getDoCheckSum()

Return whether to do the dochecksum. If true, checksum is performed.

Returns:

the dochecksum

getLocation

protected java.lang.String getLocation()

Return the location.

Returns:

the location

save

public void save(java.lang.String modelName,
                 boolean b)
          throws java.io.IOException

Saves the AcousticModel from a directory in the file system.

Specified by:

save in interface Saver

Parameters:

modelName - the name of the acoustic model; if null we just save from the default location

Throws:

java.io.IOException

getContextIndependentUnits

public java.util.Map<java.lang.String,Unit> getContextIndependentUnits()

Description copied from interface: Saver

Returns the map of context indepent units. The map can be accessed by unit name.

Specified by:

getContextIndependentUnits in interface Saver

Returns:

the map of context independent units

writeS3BinaryHeader

protected java.io.DataOutputStream writeS3BinaryHeader(java.lang.String location,
                                                       java.lang.String path,
                                                       java.util.Properties props,
                                                       boolean append)
                                                throws java.io.IOException

Writes the S3 binary header to the given location+path.

Parameters:

location - the location of the file

path - the name of the file

props - the properties

append - is true, the file will be appended, useful if saving to a ZIP or JAR file

Returns:

the output stream positioned after the header

Throws:

java.io.IOException - on error

writeInt

protected void writeInt(java.io.DataOutputStream dos,
                        int val)
                 throws java.io.IOException

Writes an integer to the output stream, byte-swapping as necessary

Parameters:

dos - the output stream

val - an integer value

Throws:

java.io.IOException - on error

writeFloat

protected void writeFloat(java.io.DataOutputStream dos,
                          float val)
                   throws java.io.IOException

Writes a float to the output stream, byte-swapping as necessary

Parameters:

dos - the input stream

val - a float value

Throws:

java.io.IOException - on error

writeFloatArray

protected void writeFloatArray(java.io.DataOutputStream dos,
                               float[] data)
                        throws java.io.IOException

Writes the given number of floats from an array of floats to a stream.

Parameters:

dos - the stream to write the data to

data - the array of floats to write to the stream

Throws:

java.io.IOException - if an exception occurs

saveTransitionMatricesAscii

protected void saveTransitionMatricesAscii(Pool<float[][]> pool,
                                           java.lang.String path,
                                           boolean append)
                                    throws java.io.FileNotFoundException,
                                           java.io.IOException

Saves the transition matrices

Parameters:

pool - the transition matrices pool

path - the path to the transitions matrices

append - is true, the file will be appended, useful if saving to a ZIP or JAR file

Throws:

java.io.FileNotFoundException - if a file cannot be found

java.io.IOException - if an error occurs while saving the data

saveTransitionMatricesBinary

protected void saveTransitionMatricesBinary(Pool<float[][]> pool,
                                            java.lang.String path,
                                            boolean append)
                                     throws java.io.IOException

Saves the transition matrices (Binary)

Parameters:

pool - the transition matrices pool

path - the path to the transitions matrices

append - is true, the file will be appended, useful if saving to a ZIP or JAR file

Throws:

java.io.IOException - if an error occurs while saving the data

getMeansPool

public Pool<float[]> getMeansPool()

Description copied from interface: Saver

Gets the pool of means for this loader.

Specified by:

getMeansPool in interface Saver

Returns:

the pool

getMeansTransformationMatrixPool

public Pool<float[][]> getMeansTransformationMatrixPool()

Description copied from interface: Saver

Gets the pool of means transformation matrices for this loader.

Specified by:

getMeansTransformationMatrixPool in interface Saver

Returns:

the pool

getMeansTransformationVectorPool

public Pool<float[]> getMeansTransformationVectorPool()

Description copied from interface: Saver

Gets the pool of means transformation vectors for this loader.

Specified by:

getMeansTransformationVectorPool in interface Saver

Returns:

the pool

getVariancePool

public Pool<float[]> getVariancePool()

Description copied from interface: Saver

Gets the variance pool.

Specified by:

getVariancePool in interface Saver

Returns:

the pool

getVarianceTransformationMatrixPool

public Pool<float[][]> getVarianceTransformationMatrixPool()

Description copied from interface: Saver

Gets the variance transformation matrix pool.

Specified by:

getVarianceTransformationMatrixPool in interface Saver

Returns:

the pool

getVarianceTransformationVectorPool

public Pool<float[]> getVarianceTransformationVectorPool()

Description copied from interface: Saver

Gets the variance transformation vectorpool.

Specified by:

getVarianceTransformationVectorPool in interface Saver

Returns:

the pool

getSenonePool

public Pool<Senone> getSenonePool()

Description copied from interface: Saver

Gets the senone pool for this loader.

Specified by:

getSenonePool in interface Saver

Returns:

the pool

getLeftContextSize

public int getLeftContextSize()

Description copied from interface: Saver

Returns the size of the left context for context dependent units.

Specified by:

getLeftContextSize in interface Saver

Returns:

the left context size

getRightContextSize

public int getRightContextSize()

Description copied from interface: Saver

Returns the size of the right context for context dependent units.

Specified by:

getRightContextSize in interface Saver

Returns:

the left context size

getHMMManager

public HMMManager getHMMManager()

Description copied from interface: Saver

Returns the HMM Manager for this loader.

Specified by:

getHMMManager in interface Saver

Returns:

the HMM Manager

logInfo

public void logInfo()

Description copied from interface: Saver

logs information about this loader

Specified by:

logInfo in interface Saver