marytts.tools.newlanguage

Class LTSTrainer

java.lang.Object

marytts.fst.AlignerTrainer

marytts.tools.newlanguage.LTSTrainer

public class LTSTrainer
extends marytts.fst.AlignerTrainer

This class is a generic approach to predict a phone sequence from a grapheme sequence. the normal sequence of steps is: 1) initialize the trainer with a phone set and a locale 2) read in the lexicon, preserve stress if you like 3) make some alignment iterations (usually 5-10) 4) train the trees and save them in wagon format in a specified directory see main method for an example. Apply the model using TrainedLTS

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	considerStress
protected int	context
protected boolean	convertToLowercase
protected marytts.modules.phonemiser.AllophoneSet	phSet

Fields inherited from class marytts.fst.AlignerTrainer

graphemeSet, inSplit, logger, optInfo, outSplit

Constructor Summary

Constructors

Constructor and Description
LTSTrainer(marytts.modules.phonemiser.AllophoneSet aPhSet, boolean convertToLowercase, boolean considerStress, int context) Create a new LTSTrainer.

Method Summary

Modifier and Type	Method and Description
static void	main(java.lang.String[] args)
void	readLexicon(java.io.BufferedReader lexicon, java.lang.String splitPattern) reads in a lexicon in text format, lines are of the kind: graphemechain | phonechain | otherinformation Stress is optionally preserved, marking the first vowel of a stressed syllable with "1".
void	readLexicon(java.util.HashMap<java.lang.String,java.lang.String> lexicon) reads in a lexicon in text format, lines are of the kind: graphemechain | phonechain | otherinformation Stress is optionally preserved, marking the first vowel of a stressed syllable with "1".
void	save(marytts.cart.CART tree, java.lang.String saveTreefile) Convenience method to save files to graph2phon.wagon and graph2phon.pfeats in a specified directory with UTF-8 encoding.
marytts.cart.CART	trainTree(int minLeafData) Train the tree, using binary decision nodes.

Methods inherited from class marytts.fst.AlignerTrainer

addAlreadySplit, addAlreadySplit, addAlreadySplit, addAlreadySplit, align, alignIteration, getAlignment, getAlignmentString, getInfoAlignment, getInputSyms, lexiconSize, splitAndAdd

Methods inherited from class java.lang.Object

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

Field Detail

phSet

protected marytts.modules.phonemiser.AllophoneSet phSet

context

protected int context

convertToLowercase

protected boolean convertToLowercase

considerStress

protected boolean considerStress

Constructor Detail

LTSTrainer

public LTSTrainer(marytts.modules.phonemiser.AllophoneSet aPhSet,
                  boolean convertToLowercase,
                  boolean considerStress,
                  int context)

Create a new LTSTrainer.

Parameters:

aPhSet - the allophone set to use.

convertToLowercase - whether to convert all graphemes to lowercase, using the locale of the allophone set.

considerStress - indicator if stress is preserved

context - context

Method Detail

trainTree

public marytts.cart.CART trainTree(int minLeafData)
                            throws java.io.IOException

Train the tree, using binary decision nodes.

Parameters:

minLeafData - the minimum number of instances that have to occur in at least two subsets induced by split

Returns:

bigTree

Throws:

java.io.IOException - IOException

save

public void save(marytts.cart.CART tree,
                 java.lang.String saveTreefile)
          throws java.io.IOException

Convenience method to save files to graph2phon.wagon and graph2phon.pfeats in a specified directory with UTF-8 encoding.

Parameters:

tree - tree

saveTreefile - saveTreefile

Throws:

java.io.IOException - IOException

readLexicon

public void readLexicon(java.io.BufferedReader lexicon,
                        java.lang.String splitPattern)
                 throws java.io.IOException

reads in a lexicon in text format, lines are of the kind: graphemechain | phonechain | otherinformation Stress is optionally preserved, marking the first vowel of a stressed syllable with "1".

Overrides:

readLexicon in class marytts.fst.AlignerTrainer

Parameters:

lexicon - reader with lines of lexicon

splitPattern - a regular expression used for identifying the field separator in each line.

Throws:

java.io.IOException - IOException

readLexicon

public void readLexicon(java.util.HashMap<java.lang.String,java.lang.String> lexicon)

reads in a lexicon in text format, lines are of the kind: graphemechain | phonechain | otherinformation Stress is optionally preserved, marking the first vowel of a stressed syllable with "1".

Parameters:

lexicon - lexicon

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException,
                        marytts.exceptions.MaryConfigurationException

Throws:

java.io.IOException

marytts.exceptions.MaryConfigurationException