Skip to content

Plotmish in Command Line

mclabelle edited this page Oct 23, 2014 · 1 revision

From the command line

cd to the plotmish folder and run plotmish as:

python plotmish.py [arguments]

Command Line Arguments

positional arguments:
	vowel info        	formant.txt file or folder
	wav file          	.wav file or folder
	annotator         	what's your name?

optional arguments:
	-h, --help        	show help message and exit
	-k 		        	keyword for selecting files in a directory, default is all files in the directory
	-o 		    	change folder to write log files to, default is plotmish/logs
	-a                	append to older log file instead of writing over it
	-p 	         	change path to Praat application, default is /Applications/Praat.app
	-f0 		 	folder containing pre-generated pitch tracks for each sound file
	-c                	path to epw.cd celex dictionary file, will then run in celex mode, default is 
				ARPABET mode

Command Line Input Files

Vowel info files should be tab delimited text files named something that ends in -formant.txt (ex: example_ _file-formant.txt).

There should be a row with column headings that correspond to the headings in the config.txt file. The formant.txt files can have anything written above the headings row.

See the config.txt file for the required and optional columns in the formant.txt file and the example files in the examples/ folder.

To edit default column headings

If you want to name a column something other than the default column headings you can do this by changing the heading names in the config.txt file. For example, if you want the column containing the arpabet pronunciation of the vowel to be called 'arpVow' you should change the first line in the config.txt file from:

ARPABET : vowel # arpabet vowel token (with or without stress)

to

ARPABET : arpVow # arpabet vowel token (with or without stress)

For further details on the required and optional columns in the formant.txt files see the comments (everything to the right of the #) in the config.txt files

The default config.txt file is configured to use the output of FAVE-extract (faav.something.com). If using the output of FAVE-extract, add the line:

candidates=T

to the config file in the FAVE-extract main directory in order to get all of the alternate measurements.

Naming Input Files

The wav files should be .wav configured sound files that correspond to the formant.txt files. They should be named the same as the -formant.txt files.

For example, two corresponding files should be named:

example_file-formant.txt and example_file.wav

Pitch Tracks

Pitch tracks are pitch files generated using Praat that correspond to the wav files.

The pitch track for example_file.wav should be called example_file.Pitch. Pitch tracks for your wav files can be automatically generated by running getPitch.Praat or by clicking the 'Make Pitch Tracks' button in start_plotmish.py.

The location of these files should be specified with the -f0 flag on start up or by writing it in the 'Pitch Tracks' line in start_plotmish.py.

Pitch tracks are optional and are not required to run plotmish.

Other Plotmish Command Line Arguments

annotator 	:	who is annotating the file (made mandatory to encourage good practice)
-k		: 	specify a keyword to filter the files to use.  For example: using the keyword 'day10' will only
			run files with that string in the basename.
-o		:	all changes are written to log files saved in the folder specified here (default is log/)
-a		: 	append to the currently saved log files instead of writing over them
-p		:	specify the location of Praat (default is /Applications/Praat.app
-c		: 	specify the epw.cd celex dictionary if you want to run in Celex mode (see below) 

Clone this wiki locally