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

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

<br><br>

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

<blockquote>

<pre>
isip_segment_concat [options]
</pre>

</blockquote>

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

<blockquote>
<pre>

isip_segment_concat -help;

isip_segment_concat -min_max -min_max_file min_max.sof -output_type text \
 -list ident_sdb.sof -audiodb audiodb.sof -input_format raw -input_type binary \
-dimension 39 -verbosity brief;

isip_segment_concat -duration -normalize -min_max_file min_max.sof -list ident_sdb.sof \
-audiodb audiodb.sof -input_format raw -input_type binary  \
-dimension 39 -ratio 3:4:3 -transdb transdb.sof -level phone -output_type text \
-output_format sof -suffix text -extension sof -verbosity brief;

isip_segment_concat -duration -normalize -min_max_file min_max.sof -list ident_sdb.sof \
-audiodb audiodb.sof -input_format raw -input_type binary -symbol_list symbols_sdb.sof \
-dimension 39 -ratio 3:4:3 -transdb transdb.sof -level phone -output_type text \
-output_format sof -suffix text -extension sof -verbosity brief;

</pre>
</blockquote>

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

<ul>

The isip_segment_concat utility has two purpose:

<br><br>

<li> Generate the minimum and maximum value for each dimension given
     the input feature-vectors. These minimum and maximum vectors can
     then be used for normalizing the input feature-vectors between
     [1, -1].

<br><br>

<li> Generate the segmental features given the ratio. Let say the
     ratio is 3:4:3. In this case, the feature-vectors corresponding
     to a typical alignment is divided into three parts following the
     ratio 3:4:3. The feature-vectors in each of these portions are
     averaged to form a single feature vector. All the three averaged
     feature vector corresponding to the three portions are then
     concatenated. A log of length of this aligment is appended to the
     output concatenated feature-vector if the duration flag is
     specified from the commandline. The segmental features can be
     generated on an utterance basis or symbol basis. In the former
     case, an entire input feature file is converted into segmental
     feature file based on the symbol alignments. However, in the
     latter case, only the features corresponding to the input symbol
     are converted into segmental features.

<br><br>

</ul>

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

<ul>
  <li> -ratio: ratio used to concat the segmental features
  <li> -min_max_file: output min_max file
  <li> -list input identifier list as sdb
  <li> -audiodb: audio database specifying the input feature files
  <li> -input_format: input feature file format(default=sof, raw)
  <li> -symbol_list: input symbols list as sdb
  <li> -input_type: input feature file type(default=binary,text)
  <li> -output_format: output feature file format(default=sof, raw)
  <li> -output_type: output feature/min-max file type(default=binary,text)
  <li> -transdb: transcription database specifying the aligments
  <li> -level transcription level for the alignments
  <li> -debug: debug level (default=NONE, BRIEF, DETAILED, ALL)
  <li> -help: this message
  <li> -log_file: log messages
  <li> -verbosity: verbosity level (default=NONE, BRIEF, DETAILED, ALL)
</ul>	    

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

<ul>

  <li> none

</ul>       

<a name="flags">

<b>flags:</b>
<br><br>

<ul>
  <li> -min_max: generate min_max file
  <li> -normalize: normalize input features before computing segmental features
  <li> -duration: log-duration of the alignment length added to the output feature-vector
</ul>       

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

<ul>

  <li> This example shows how to generate minimum and maximum values
       for each dimension of the input feature vectors:
       <br><br>

       isip_segment_concat -min_max -min_max_file
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/min_max.sof">min_max.sof</a> -list
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/lists/ident_sdb.sof">ident_sdb.sof</a> -audiodb 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/database/audiodb.sof">audiodb.sof</a> -input_format raw
       -input_type binary -dimension 39 -output_type text -verbosity
       brief

       <br><br>

  <li> This example shows how to compute segmental features on an
       utterance basis. The input features are normalized before the
       segmental feature computation and a log-duration is appended to
       each segmental feature vector:
       <br><br>

       isip_segment_concat -duration -normalize -min_max_file 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/min_max.sof">min_max.sof</a> -list
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/lists/ident_sdb.sof">ident_sdb.sof</a> -audiodb 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/database/audiodb.sof">audiodb.sof</a> -input_format raw
       -input_type binary -dimension 39 -ratio 3:4:3 -transdb 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/database/transdb.sof">transdb.sof</a> -level phone -output_type
       text -output_format sof -suffix text -extension sof -verbosity brief
       <br><br>

       The output should be three files: 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/AD-1106.getidtext.sof">AD-1106.getidtext.sof</a>,
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/AD-1106.p1text.sof">AD-1106.p1text.sof</a>, and 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/AD-1106.p10text.sof">AD-1106.p10text.sof</a>
       <br><br>

  <li> This example shows how to compute segmental features on a
       symbol basis. The input features are normalized before the
       segmental feature computation and a log-duration is appended to
       each segmental feature vector:
       <br><br>

       isip_segment_concat -duration -normalize -min_max_file 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/min_max.sof">min_max.sof</a> -list
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/lists/ident_sdb.sof">ident_sdb.sof</a> -audiodb 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/database/audiodb.sof">audiodb.sof</a> -input_format raw
       -input_type binary -symbol_list 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/symbols_sdb.sof">symbols_sdb.sof</a> -dimension 39
       -ratio 3:4:3 -transdb 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/database/transdb.sof">transdb.sof</a> -level phone -output_type
       text -output_format sof -suffix text -extension sof -verbosity brief
       <br><br>

       The output should be two files: 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/siltext.sof">siltext.sof</a> and 
<a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_segment_concat/output/ytext.sof">ytext.sof</a>
<br><br>      
</ul>
      
<a name="manuals">
<b>manuals:</b>
<br><br>

<ul>
  <li> 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>
  <li> none
</ul>

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

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

  <br><br>

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

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

  <br><br>

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

<ul>

<li> <a href="../../../util/speech/isip_make_db/index.html">isip_make_db</a>

</ul>

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

<ul>
<li> none
</ul>

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