BUILDINDEX(1SP)

NAME
buildindex - builds an index for a database of labeled waveforms

SYNOPSIS
buildindex dbname

DESCRIPTION
buildindex creates the index files used by findphone(1SP).

Indexing a database is a two step process. First, create a database configuration file and place it in the directory from which you run Findphone ore /projects/cslu/speech/findphone/configs. ** THIS DIRECTORY WILL CHANGE BETW. MACHINES. SHOULD IT REMAIN? The name of the configuration file will be the name of the database (dbname). Second, run buildindex.

The configuration file consists of field-value pairs, one per line. The field-value pair format is:

    FieldName: value

Where FieldName is one of BaseDir, IndexDir, LolaDir, LolaExtension, LolaPoints, SampleRate, WaveformDir, and WaveformExtension.

Blank lines and lines starting with ` file.

FIELD VALUES
Each field listed below must be set in the database configuration file.

BaseDir
    Path of directory which LolaDir and WaveformDir are relative to.

IndexDir
    Path of the directory in which the index files will be placed. Only one database index per directory.

LolaDir
    Path to the directory of Lola files. Subdirectories will be searched as well. The directory is relative to BaseDir. More then one LolaDir can be listed in a configuration file.

LolaExtension
    Extension of Lola files (ptlola, phn).

LolaPoints
    The time in seconds which one 'lola point' represents. This is approximately equal to the value of the MillisecondsPerFrame in the header.

SampleRate
    Sample rate of waveform files in Hz. Common sample rates are 8,000 to 16,000 Hz.

WaveformDir
    Path to the directory of waveform files. Subdirectories will be searched as well. The directory is relative to BaseDir. More than one WaveformDir can be listed in a configuration file.

WaveformExtension
    Extension of waveform files (adc, wav).

EXAMPLE CONFIGS

Configuration file for say_lname database:

    BaseDir: /projects/cslu/speech/phonedb
    IndexDir: /projects/cslu/speech/index/say_lname
    WaveformExtension: adc
    LolaExtension: ptlola
    LolaPoints: 0.003
    SampleRate: 8000
    LolaDir: say_lname_handlabels
    WaveformDir: say_lname

SEE ALSO
findphone(1SP)

CAVEATS
The Lola file and corresponding Waveform file must have the same basename (this is how the correspondence is made). The indexes will be correct if either: (1) the Lola files are in the same directory as the waveform files, or (2) there are no two Waveform or Lola files with the same basename. In particular, parallel directory structure will not be used to disambiguate two files with the same name unless they are actually in the same directory.

BUGS
Should have a command line option to set the directory in which the configuration files are found.

AUTHORS
Center for Spoken Language Understanding
Department of Computer Science and Engineering
Oregon Graduate Institute of Science & Technology