Changes between Version 14 and Version 15 of VoiceImportToolsTutorial

Timestamp:

09/18/07 21:17:29 (17 years ago)

Author:

sach01

Comment:

--

VoiceImportToolsTutorial

@@ -6 +6 @@
 This Tutorial explains the procedure to build a new voice with Voice Import Tools (VIT) under MARY Environment.
 
- Voice Import Tool is a Graphical User Interface(GUI), which contains a set of Voice Import Components and helps the user to build new voices under MARY(Modular Architecture for Research in speech sYnthesis) Environment. This GUI Tool designing is primarily aims to build new voices very easily by any user with out knowing much technical details of Speech Synthesis.
+Voice Import Tool is a Graphical User Interface(GUI), which contains a set of Voice Import Components and helps the user to build new voices under MARY(Modular Architecture for Research in speech sYnthesis) Environment. This GUI Tool designing is primarily aims to build new voices very easily by any user with out knowing much technical details of Speech Synthesis.
 
 Currently, Voice Import Tool supports following  categories mainly:
@@ -62 +62 @@
  - !SphinxLabeler
  - MRPALabelConverter
+ - !LabelledFilesInspector
+ - !PhoneUnitLabelComputer 
+ - !PhoneLabelFeatureAligner 
+ - !HalfPhoneUnitLabelComputer 
+ - !HalfPhoneLabelFeatureAligner 
  - !HalfPhoneUnitfileWriter
  - !HalfPhoneFeatureFileWriter
@@ -438 +443 @@
 
 
-For more information, see the example file: Marybase/lib/modules/import/examples/PhoneUnitFeatureDefinition.txt
+For more information, see the example file: ''Marybase/lib/modules/import/examples/PhoneUnitFeatureDefinition.txt''
 
 Configuration Settings:
@@ -480 +485 @@
 
 
-( '''Under Construction''' - to continued)
-
-
-
-
-
-
+
+
+== 8. Unit Selection ==
+
+
+'''!HalfPhoneUnitfileWriter'''[[BR]]
+
+It produces a file containing all halfphone sized units.
+
+
+Configuration Settings:
+
+ * corrPmDir - directory containing the corrected pitchmarks
+ * labelDir - directory containing the halfphone labels
+ * unitFile - file containing all halfphone units. Will be created by this module
+
+
+'''!HalfPhoneFeatureFileWriter'''[[BR]]
+
+It produces a file containing all the target cost features for the phone sized units. The module needs a file defining which features are to be used and what weights are given to them. They must be the same features as the ones that the !HalfPhoneFeatureComputer used. If you do not have a feature definition, the module tries to create one.
+
+For more information, see the example file: ''Marybase/lib/modules/import/examples/HalfPhoneUnitFeatureDefinition.txt''
+
+Configuration Settings:
+
+ * featureDir - directory containing the halfphone features
+ * featureFile - file containing all halfphone units and their target cost features.Will be created by this module
+ * unitFile - file containing all halfphone units
+ * weightsFile - file containing the list of halfphone target cost features, their values and weights
+
+
+'''!JoinCostFileMaker'''[[BR]]
+
+It produces a file containing all the join cost features for the halfphone sized units.
+
+Configuration Settings:
+
+ * joinCostFile - file containing all halfphone units and their join cost features. Will be created by this module
+ * mcepDir - directory containing the mcep files
+ * mcepTimeline - file containing all mcep files
+ * unitFile - file containing all halfphone units
+ * weightsFile - file containing the list of join cost weights and their weights
+
+
+'''!AcousticFeatureFileWriter'''[[BR]]
+
+It produces a file containing all the target cost features plus two acoustic target cost features for the halfphone sized units. Also produces a feature definition containing those features.
+
+ * acFeatDef - file containing the list of phone target cost features, their values and weights
+ * acFeatureFile - file containing all halfphone units and their target cost features plus the acoustic target cost features. Will be created by this module.
+ * featureFile - file containing all halfphone units and their target cost features
+ * unitFile - file containing all halfphone units
+ * waveTimeLine - file containing all wave files
+
+
+'''CARTBuilder'''[[BR]]
+
+It builds a preselection tree for the target cost features using "wagon" (CART) from the Edinburgh Speech tools.
+
+Additionally, User need to specify either a feature sequence or a top level tree. They are used to built a basic tree that is extendend by wagon. This way, wagon runs several times on smaller subsets of units rather than the whole set. It might still take some time to run this module. 
+
+ - Feature sequence: A file containing a list of features for which to build the tree.
+ - Top level tree: A file containing the basic tree.
+
+For more information on these two possibilities of specifying the basic tree, see the example files in ''Marybase/lib/modules/import/examples/''
+
+If you give the CARTBuilder neither a feature sequence nor a top level tree file, a default feature sequence is created which only contains "mary_phoneme" as feature. If the basic tree contains leaves that are contain more units than the maximum number of units allowed, the leaves are pruned and a warning message is printed. It is recommended that you make sure that there are no leaves that are too big.
+
+
+Configuration Settings:
+
+ * acFeatureFile - file containing all halfphone units and their target cost features plus the acoustic target cost features
+ * cartFile - file containing the preselection CART. Will be created by this module
+ * estDir - directory containing the local installation of the Edinburgh Speech Tools
+ * featureSeqFile - file containing the feature sequence for the basic tree
+ * maxLeafSize - the maximum number of units in a leaf of the basic tree
+ * mcepTimeline - file containing the mcep files
+ * readFeatureSequence - if "true", basic tree is read from feature sequence file; if "false", basic tree is read from top level tree file.
+ * topLevelTreeFile - file containing the basic tree
+ * unitFile - file containing all halfphone units
+
+
+'''CARTPruner'''[[BR]]
+
+It prunes the preselection tree and this module also removes outliers from the preselection tree.
+
+Configuration Settings:
+
+ * cartFile - file containing the preselection CART
+ * prunedCartFile - file containing the pruned preselection CART. Will be created by this module
+ * unitFeatureFile - file containing all halfphone units and their target cost features
+ * unitFile - file containing all halfphone units
+ * waveFile - file containing all wave files
+
+
+
+== 9. Installation of New Voice in to MARY ==
+
+
+'''!VoiceInstaller'''[[BR]]
+
+It supports the built voice installation in to MARY automatically. It copies all the necessary files to a new subdirectory in the ''lib/voices/'' directory of your Mary installation. Furthermore, a file that specifies the properties of the voice is created and stored in the ''conf/'' directory of your Mary installation. Next time you start the Mary server, the voice is loaded. 
+
+
+Configuration Settings:
+
+ * cartFile - file containing the preselection CART
+ * durTree - file containing the duration CART
+ * exampleText - file containing example text (for limited domain voices only)
+ * f0LeftTree - file containing the left f0 CART
+ * f0MidTree - file containing the mid f0 CART
+ * f0RightTree - file containing the right f0 CART
+ * halfPhoneFeatDefAc - file containing the list of halfphone target cost features, their values and weights
+ * halfPhoneFeatsAc - file containing all halfphone units and their target cost featuresplus the acoustic target cost features
+ * halfPhoneUnits - file containing all halfphone units
+ * joinCostFeatDef - file containing the list of join cost weights and their weights
+ * joinCostFeats - file containing all halfphone units and their join cost features
+ * phoneFeatDef - file containing the list of phone target cost features, their values and weights
+ * waveTimeline - file containing all wave files 
+
+
+
+
+
+
+
+
+
+
+
+