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

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

<br><br>

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

<blockquote>

<pre>
isip_feature_select [options]
</pre>

</blockquote>

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

<blockquote>
<pre>

isip_feature_select -help;

isip_feature_select -audiodb database/inclass_db.sof -symbol aa -list \
lists/aa_similar_symbols_sdb.sof -symbol_list \
lists/all_symbols_sdb.sof -ratio_class "1:1" -ratio_similar "1:1" -suffix \
_out_of_class -input_format raw -input_type text -dimension 118 \
-verbose brief;

</pre>
</blockquote>

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

The isip_feature_select utility selects the out-of-class feature
vectors for an input symbol given the set of in-class feature vectors
corresponding to all the symbols.

<br><br>

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

<ul>
  <li> -audiodb: audio database specifying the input feature files
  <li> -debug: debug level (default=NONE, BRIEF, DETAILED, ALL)
  <li> -dimension: dimensions of the feature vectors in the
                   database(default=118)
  <li> -extension: new file extension (default=sof)
  <li> -help: this message
  <li> -input_format: input feature file format(default=sof, raw)
  <li> -input_type: input feature file type(default=binary,text)
  <li> -list: input sdb list of symbols phonetically similar to input symbol
  <li> -log_file: log messages
  <li> -output_format: output feature file format(default=sof, raw)
  <li> -output_type: output feature/min-max file type(default=binary,text)
  <li> -ratio_class: ratio of in-class to out-of-class data
                     with respect to the amount of in-class data
  <li> -ratio_similar: ratio in which the out-of-class data is
                       distributed between similar and dissimilar
                       symbols with respect to the input symbol
  <li> -suffix: new basename suffix (default=out_of_class)
  <li> -symbol: input symbol whose out-of-class data is selected
  <li> -symbol_list: input sdb list of all symbols in the symbol-set
  <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> none
</ul>       

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

<ul>

  <li> This example shows how to select features corresponding to the
       symbol <i>aa</i>
        <br><br>

       isip_feature_select -audiodb 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_feature_select/database/inclass_db.sof">inclass_db.sof</a>
       -symbol aa -list 
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_feature_select/lists/aa_similar_symbols_sdb.sof">aa_similar_symbols_sdb.sof</a>
        -symbol_list
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_feature_select/lists/all_symbols_sdb.sof">all_symbols_sdb.sof</a>
        -ratio_class "1:2" - ratio_similar "1:1" -suffix _out_of_class
        -input_format raw -input_type text -dimension 118 -extension sof

	<br><br>

       The output feature file representing out-of-class data for
       symbol <i>aa</i> is:
       <a href="/perl/ifc_document.pl?file=$isip/doc/examples/util/speech/isip_feature_select/output/aa_out_of_class.sof">aa_out_of_class.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_feature_select/isip_feature_select.h">./isip_feature_select.h</a>: header file

  <br><br>

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

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

  <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_feature_select/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>
<li> <a href="../../../util/speech/isip_segment_concat/index.html">isip_segment_concat</a>

</ul>

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

<ul>
<li> none
</ul>

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