<?php $isip_window_title = "ISIP Homepage"; ?>
<?php include("/data/isip/www/templates/documentation/header/header.html"); ?>

<!--#set var="isip_page_title" value="isip_lm_tester" -->
<!--#include virtual="/hse/ies/templates/documentation/body/index_utility.html" -->
<?php include("/data/isip/www/templates/documentation/body/bar.html"); ?>

<a name="name">
<b>
name:
<a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_lm_tester/isip_lm_tester.cc">isip_lm_tester</a>
</b>

<br><br>

<a name="synopsis">
<b>synopsis:</b>
<br>

<blockquote>
<pre>
isip_lm_tester -seed [randome number]
               -sentence_count [the number of sentences to be generated]
               -language_model [language model file]

</pre>
</blockquote>

<a name="quick_start">
<b>quick start:</b>
<br>

<blockquote>
<pre>
isip_lm_tester -help
isip_model_tester -language_model my_grammar.sof
isip_model_tester -seed 30 -max_length 100 -sentence_count 10 -language_model my_grammar.sof

</pre>
</blockquote>

<a name="description"> 
<b>description:</b>
<br>

<ul>
  The isip_lm_tester utility randomly generates sentences based on the language model file and tests the language model and JSGF parser
</ul>
<br>

<a name="options">
<b>options:</b>
<br>

<ul>
  <li> -help: displays a help message
  <li> -max_length: specify maximum length of each sentence (default = 100)
  <li> -sentence_count: specify the number of sentences to be generated (default = 1)
  <li> -seed: specify random seed for weights (default: seed with the current time)
  <li> -language_model: the language model file name
  <li> -level: specify the level for output (default = the highest level)
  <li> -name: specify the output transcription DB name
  <li> -type: output transcription DB type (default = text, binary)
  <li> -list: the identifier list for output transcription DB (default: automatically assigned)
  <li> -exclude: exclude the exclude symbols of output sentences(default = false)
  <li> -debug: log verbosity level (default = NONE, BRIEF, DETAILED, ALL)
</ul>       

<a name="arguments">
<b>arguments:</b>
<br><br>

<ul>
  <li> specify the output transcription DB file (default: output to screen in plain text)
</ul>
<br>

<a name="examples">
<b>examples:</b>
<br><br>

<ul>
  <li> This example shows how to generate sentences in the input file "my_grammar.sof"

<pre>
isip_lm_tester -language_model <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_lm_tester/my_grammar.sof">my_grammar.sof</a></pre>

  <li> This example shows how to generate sentences in the input file "my_grammar.sof" using -seed and -length options:

<pre>
isip_lm_tester -seed 30 -max_length 100 -language_model <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_lm_tester/my_grammar.sof">my_grammar.sof</a></pre>

</ul>
       
<a name="manuals">
<b>manuals:</b>
<br><br>

<ul>
  None.
</ul>
       
<a name="languages">
<b>languages:</b>
<br><br>

<ul>
  This utility is written entirely in C++.
</ul>
       
<a name="variables">
<b>environment variables:</b>
<br><br>

<ul>
  None.
</ul>

<a name="files">
<b>files:</b>
<br><br>

<ul>
  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_lm_tester/isip_lm_tester.h">./isip_lm_tester.h</a>: header file

       <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_lm_tester/usage_message.text">./usage_message.text</a>: ussage message

       <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_lm_tester/help_message.text">./help_message.text</a>: help message
</ul>
       
<a name="see_also">
<b>see also:</b>
<br><br>

<ul>
  
  <li><a href="../isip_model_creator/index.html">isip_model_creator</a>
  <li><a href="../isip_lm_converter/index.html">isip_lm_converter</a>
  <li><a href="../isip_lm_creator/index.html">isip_lm_creator</a>
       
</ul>

<a name="notes">
<b>notes:</b>
<br><br>

<ul>
Command line options allways override parameter file values.
</ul>

<!--#include virtual="/hse/ies/templates/documentation/footer/footer.html" -->




