-================= PHONAAS =================-

PHONAAS is a graphical user interface (GUI) tool, written in Perl and GTK2, using the R programming language (http://www.r-project.org/) and PRAAT (www.fon.hum.uva.nl/praat/) to extract vowel formant data.

Version: 2.0.3.9

Platform: Windows (tested on Windows 7).

License: GNU GPL 2 (or greater)
The license is present in the "License.txt" file.


-=== To Install ==

* Double click PHONAAS-msw-x86-2-0-3.exe and follow the wizard to install PHONAAS.


-=== To Run ===-

* Launch the application by double-clicking the PHONAAS shortcut on the desktop OR
  Launch the application by clicking the PHONAAS link under the PHONAAS program group in the start menu OR
  Launch the application by double-clicking the PHONAAS.2.0.3.exe file under C:\Program Files (x86)\W-NORM\bin
  
* Make sure that you run this application as Administrator.


-=== Operation ===-

* Choose the input sound file (only *.wav files accepted)

* Choose the input TextGrid (word tier must be named "word" and segmented tier must be named "segment")

* Type in the speaker name.
 
* Tick the checkboxes for data output type:
  * Combined Output will output one file with the chosen types in.

* Optionally choose additional data to be added.

* Optionally add elements to be removed from the segment tier.

* Optionally change the formant settings.

* Optionally add and change graphical output

* Choose the Output Directory for the data and plots.  The default location is C:\Users\[username]\PHONAAS.

* Click Finish to start the analysis.

* A messagebox will be displayed after the process is done.  Browse to the Output Directory to find the  output data.


-=== Pre Processing of Input File ===-

The input TextGrid must contain two or more tiers. The word tier must be named "word" and the segmented tier must be named "segment"


-=== Included in the install ===-

Included in this install are the PRAAT console application (http://www.fon.hum.uva.nl/praat/praatcon5410_win32.zip).


-=== Additional programs and modules needed ===-

* R-2.15.2: http://cran.r-project.org/bin/windows/base/old/2.15.2/R-2.15.2-win.exe


-=== Acknowledgements ===-

* Boersma, Paul & Weenink, David (2015). Praat: doing phonetics by computer [Computer program]. http://www.praat.org/

* Robert Gentleman and Ross Ihaka for the initial creation of R and all the other contributors (http://www.r-project.org/contributors.html).



For technical enquiries regarding this tool, contact Wikus Pienaar (wikus.pienaar@nwu.ac.za).
For any further enquiries, contact Daan Wissing (daan.wissing@nwu.ac.za).
