OpenSauce

OpenSauce is an GNU Octave-compatible (knock on wood) edition of VoiceSauce, software for automated voice measurements. This software is under continuous development. If instructions are confusing/inaccurate, or you find bugs in the software, or something breaks, please feel free to email kate [at] umass.edu .

Requirements

Python 2.7
GNU Octave -- make sure you have the latest version (3.6.4)
Currently, OpenSauce only works on Mac OSX (tested on Mountain Lion)
You may need to install Tcl/Tk

If you have homebrew, you can use "check.sh" to make sure that your system has the required dependencies, i.e.

    $ ./check.sh

Running OpenSauce on a batch of *.wav files

Download or "git clone" OpenSauce, unpack it, and change into the "opensauce" directory. For example:
```
$ git clone https://github.com/voicesauce/opensauce.git
$ cd /path/to/opensauce
```
See opensauce/settings/settings_template.csv for an example of a settings file. This file represents the VoiceSauce-default settings. If you're fine using them, just specify opensauce/settings as the [settings-dir].

Where applicable, possible options are specified in the comments.

Check settings/getOutputSettings.m. This is where you specify where the text output of OpenSauce's calculations will be stored, as well as other options. For example, to set the directory where you'd like output files to be stored:
```
$ emacs settings/getOutputSettings.m

os.OT_outputdir = 'path/to/output/directory'
```

To run OpenSauce, use the command:

$ octave -qf sauce.m [wavdir] [matdir] [settings-dir]

Where [wavdir] is the directory where your *.wav files are stored and [outdir] is the directory where you'd like VoiceSauce to store the resulting *.mat files. "-qf" suppresses the Octave startup message.

PLEASE NOTE that [wavdir], [matdir], and [settings-dir] need to be absolute paths (e.g. "/Users/johndoe/wavfiles" or "~/wavfiles" rather than a relative path like "../wavfiles").

The command above carries out all calculations specified in the "Parameter Selection" dialog, runs OutputToText.m (in sys/) on the resulting *.mat files, and then stores the output in the specified directory (the field "os.OT_outputdir" in settings/getOutputSettings.m).

More Information

See the OpenSauce wiki!

Questions or bugs? E-mail ksilvers [at] umass.edu