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

<!--#set var="isip_page_title" value="isip_extract_hypo" -->
<!--#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_extract_hypo/isip_extract_hypo.cc">isip_extract_hypo</a>
</b>

<br><br>

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

<blockquote>

<pre>
isip_extract_hypo [options] trans_db.sof
</pre>

</blockquote>

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

<blockquote>
<pre>
isip_extract_hypo -help;

isip_extract_hypo -level word -format NIST_TRN -output output.text
trans_db.sof -exclude_symbols ex_sym_sdb.sof
</pre>
</blockquote>

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

<ul>

  The isip_extract_hypo utility extracts the hypotheses/alignments
  from the transcription database given the level(s) and a list of
  identifiers. Note that the output of the recognizer is a
  transcription database that can be potentially used as an input to
  the trainer. The list of identifier is optional and by default, all
  the transcriptions in the database are extracted.

<br><br>

</ul>

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

<ul>


  <li> -debug: debug level (default=NONE, BRIEF, DETAILED, ALL)

  <li> -exclude_symbols: list of symbols that will be excluded in the
  output hypotheses. It is specified as a Sdb object in sof
  
  <li> -format: hypotheses/alignments format (default=NIST_TRN, HYP_ALIGN)
  
  <li> -help: display a help message

  <li> -level: transcription level (default=topmost level)

  <li> -list: list of identifiers as Sdb object (optional)
  
  <li> -log_file: log messages

  <li> -output: output hypotheses file

</ul>       

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

<ul>

  <li> trans_db.sof: input transcription database in sof

</ul>       

</ul>       

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

<ul>

  <li> -alignment: output alignments

</ul>       

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

<ul>   

  <li> -format "word : state" (outputs word, phone & state level alignments)

  <li> -format "word, state" (outputs word & state level alignments)


</ul>       


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

<ul>

  <li> This example shows how to extract word hypotheses in NIST_TRN
  format given the transcription database and the list of
  identifiers. Note that, we'll exclude the symbols "!SENT_START" and
  "!SENT_END" in the output hypotheses. Hence, these symbols are
  specified in the <i>exclude-symbols</i> file.
  
<pre>

isip_extract_hypo -level word -format NIST_TRN -list <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/id_sdb.sof">id_sdb.sof</a> -output <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/output.text">output.text</a> -exclude_symbols <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/ex_sym_sdb.sof">ex_sym_sdb.sof</a> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/trans_db.sof">trans_db.sof</a>

</pre>
       
  <li> This example shows how to extract word, phone, and state
  alignments in HYPO_ALIGN format given the transcription database and
  the list of identifiers.
  
<pre>

isip_extract_hypo -level "state:word" -list <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/id_sdb.sof">id_sdb.sof</a> -output <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/output.text">alignments.text</a> -format HYP_ALIGN -alignment  <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/trans_db.sof">trans_db.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_extract_hypo/isip_extract_hypo.h">./isip_extract_hypo.h</a>: header file

  <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_extract_hypo/isip_extract_hypo.cc">./isip_extract_hypo.cc</a>: main file
  
  <br><br>

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

  <br><br>

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

<ul>

<li> <a href="../../../class/mmedia/TranscriptionDatabase/index.html">TranscriptionDatabase</a>

</ul>

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

<ul>
<li> none
</ul>

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