README for PNCC (ver. 1) release -- 11/16/2011

If your Matlab Compiler Runtime is not in the default location (/opt/MATLAB/MATLAB_Compiler_Runtime/v714), you need to change the definition of MCRROOT in go_csawh_wrapper.sh accordingly.

To run:

$ ./go_pncc_wrapper.sh <filelist> <config_file>

The <config_file> parameter is optional; if it isn't specified, default values are used.

One example of a config file (with the default values) is included. It's called testConfigFile.

The definitions of the parameters are as follows:
fs --> sampling rate (default: 16khz)
feat_name --> name of feature for sphere header (default: cmu_feat)
appDeltas --> set to 1 to append delta and double-delta coefficients; if this is 0, then del_width is irrelevant (default: 1)
del_width --> parameter for calculating (double-)delta coefficients with deltas.m as supplied by Vikramjit; always set to some value, even if appDeltas is 0 (default: 5)
numFilts --> number of filters in the filter bank (default: 40)*
dLowFreq --> bottom edge frequency for filter bank (default: 200)*
dHighFreq --> high edge frequency for filter bank (default: 8000)*
fileType --> format of input audio, can be 'sph' or 'wav' (default: sph)
addDither --> setting to 1 adds dither to counteract adverse effects of digital zeros (default: 1)**
overwrite --> set to 1 to overwrite output files that already exist (default: 0)

IMPORTANT: The configuration file must contain all the parameters and they must not be rearranged. If this is problematic, another version that more intelligently parses the contents of the configuration file can be developed.

Footnotes:
*These values probably should change for 8kHz sampling rate... TBD
**We used the method suggested by CRSS

Mark Harvilla (mharvill@cs.cmu.edu)
Carnegie Mellon University
November 16, 2011 
