name: keyword_search
synopsis: keyword_search [options] 

description:  

this tool searches a phone lattice for a given list of keywords. a word 
lexicon is consulted for each keyword and the lattice is searched for the
sequence of phones making up the word. the tool reports each occurrence of 
the word, including the start frame, end frame, and likelihood of the 
occurence. 

arguments:

  -p params_file	: parameters file
  -help                 : this file

examples:

keyword_search -p params.text

an example parameter file:

   # parameters file for the isip keyword search tool
   #
   
   # define the file containing the list of context-independent models.
   #
   monophones_file = ./monophones.text

   # define phone lexicon file. since the prototype system's decoder performs
   # a 3-level hierarchical search (and the number of levels is not adjustable)
   # this "dummy" lexicon collapses the word and model levels into one. the
   # phone lexicon should have the form:
   #
   # phone1 phone1
   # phone2 phone2
   # phone3 phone3
   #
   # which essentially gives each phone a lexical definition of the phone
   # itself
   #   
   phone_lexicon_file = ./phone_lexicon.text
   
   # define word lexicon file. this provides a phonetic definition for each
   # word in the vocabulary. NOTE: All phones in this lexicon MUST be defined
   # in the phone_lexicon_file
   #
   word_lexicon_file = ./word_lexicon.text
   
   # define search words file. this is a list of all words the lattice will
   # be searched for. out-of-vocabulary words are not handled, so each word
   # in this list must be present in the word_lexicon
   #
   search_words_file = ./search_words.text
   
   # define scoring parameters. lm_scale is used to scale the language model
   # scores. word_penalty is added to the language model scores in the lattice
   #
   lm_scale = 10.0
   word_penalty = 10
   
   # define input and output lists. output_results_list contains the list
   # if output files to which the keyword search results will be written.
   # input_lattice_list is the list of lattice files to be searched.
   # NOTE: These files MUST have a 1-to-1 correspondence
   #
   output_results_list = output_results.list
   input_lattice_list = input_lattice.list
   
   # end of file
   #
