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

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

<br><br>

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

<blockquote>
<pre>
isip_svm_learn -p param.sof [options]
</pre>
</blockquote>

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

<blockquote>
<pre>
isip_svm_learn -help;
isip_svm_learn -params_file params.sof -pos_examples pos_examples.sof
               -neg_examples neg_examples.sof
</pre>
</blockquote>

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

<ul>
  This utility computes the support vector model from a set of in-class and out-of-class observations.
</ul>

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

<ul>
  <li> -help: displays a help message
  <li> -verbose: log verbosity level
       <ul>
	 <li> NONE: output the number of files processed 
	 <li> BRIEF: output also names of the files processed
	 <li> DETAILED: output also hypotheses, scores and frames number 
       </ul>
       <br>
  <li> -debug_level: debugging information level (default NONE)
       <ul>
	 <li> NONE: output the number of files processed 
	 <li> BRIEF: output also names of the files processed
	 <li> DETAILED: output also hypotheses, scores and frames number 
       </ul>
       <br>

  <li> -params_file: support vector model parameter file
  <li> -pos_examples: in-class observations identifiers
  <li> -neg_examples: out-of-class observations identifiers
  <li> -penalty: training error vs margin trade-off parameter (default 50)
  <li> -epsilon: allowable error for QP termination criterion (default 0.001)
  <li> -tolerance: inaccuracies allowed around the KKT conditions (default 0.001)
  <li> -kappa: kappa parameter of the sigmoid kernel (default 1.0)
  <li> -delta: delta parameter of the sigmoid kernel (default 1.0)
  <li> -degree: degree parameter of the polynomial kernel (default 3.0)
  <li> -gamma: gamma parameter of the rbf kernel (default 0.5)
       
       <br><br>
  <li> -log_file: log file used instead of stdout
</ul>       

<a name="operands">
<b>operands:</b>

<ul>
  <li> None.
</ul>

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

<ul>
  <li> This example shows how to create a support vector model using the options specified:

<pre>
isip_svm_learn -params_file <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_svm_learn/param.sof">param.sof</a> -pos_examples <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_recognize/pos_examples.sof">pos_examples.sof</a> -neg_examples <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_recognize/neg_examples.sof">neg_examples.sof</a> -verbose all
</pre>
       
<a name="manuals">
<b>manuals:</b>
<br><br>

<ul>
  None.
</ul>

<br>

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

<ul>
  This utility is written entirely in C++.
</ul>

<br>

<a name="variables">
<b>environment variables:</b>
<br><br>

<ul>
  None.
</ul>

<br>

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

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

       <br><br>

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

       <br><br>

  <li> <a href="/perl/ifc_document.pl?file=$isip/util/speech/isip_svm_learn/help_message.text">./help_message.text</a>: help message
</ul>

<br>

<a name="see_also">
<b>see also:</b>
<br><br>

<ul>
  <a href="../isip_svm_classify/index.html">isip_svm_classify</a><br>  
  <a href="../isip_posterior_creator/index.html">isip_posterior_creator</a><br>
  <a href="../isip_model_combiner/index.html">isip_model_combiner</a><br>
  <a href="../isip_recognize/index.html">isip_recognize</a>
</ul>

<br>

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

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

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