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

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

<br><br>

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

<blockquote>
<pre>
isip_posterior_creator -model_file stat_model.sof
  -output_file update_stat_model.sof -pos_examples pos_examples_list.sof
  -neg_examples neg_examples_list.sof [options]
</pre>
</blockquote>

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

<blockquote>
<pre>
isip_posterior_creator -help;
isip_posterior_creator -pos_examples pos_examples_list.sof
  -neg_examples neg_examples_list.sof
</pre>
</blockquote>

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

<ul>
  This utility creates a posterior model which converts the support vector machine distance to a probability.
</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> -model_file: statistical model file (support vector model)
  <li> -output_file: statistical model containing the re-estimated posterior model
  <li> -pos_examples: in-class support vector machine distances
  <li> -neg_examples: out-of--class support vector machine distances
  <li> -pos_prior: in-class priori probability (default 0.5)
  <li> -neg_prior: out-of-class priori probability (default 0.5)
  <li> -bin_width: histogram bin width (default 0.05)

       <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 classify unseen observations using the options specified:

<pre>
isip_posterior_creator -model_file stat_model.sof -output_file update_stat_model.sof -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> -pos_prior 0.5 -neg_prior 0.5 -bin_width 0.05 -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_posterior_creator/isip_posterior_creator.h">./isip_posterior_creator.h</a>: header file

       <br><br>

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

       <br><br>

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