<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>SphinxBase: include/sphinxbase/cmn.h File Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="navtree.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="navtree.js"></script> <script type="text/javascript" src="resize.js"></script> <script type="text/javascript"> $(document).ready(initResizable); </script> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">SphinxBase <span id="projectnumber">0.6</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>Globals</span></a></li> </ul> </div> </div> <div id="side-nav" class="ui-resizable side-nav-resizable"> <div id="nav-tree"> <div id="nav-tree-contents"> </div> </div> <div id="splitbar" style="-moz-user-select:none;" class="ui-resizable-handle"> </div> </div> <script type="text/javascript"> initNavTree('cmn_8h.html',''); </script> <div id="doc-content"> <div class="header"> <div class="summary"> <a href="#nested-classes">Data Structures</a> | <a href="#define-members">Defines</a> | <a href="#typedef-members">Typedefs</a> | <a href="#enum-members">Enumerations</a> | <a href="#func-members">Functions</a> | <a href="#var-members">Variables</a> </div> <div class="headertitle"> <h1>include/sphinxbase/cmn.h File Reference</h1> </div> </div> <div class="contents"> <p>Apply Cepstral Mean Normalization (CMN) to the set of input mfc frames. <a href="#_details">More...</a></p> <div class="textblock"><code>#include <sphinxbase/sphinxbase_export.h></code><br/> <code>#include <sphinxbase/prim_type.h></code><br/> <code>#include <sphinxbase/fe.h></code><br/> </div> <p><a href="cmn_8h_source.html">Go to the source code of this file.</a></p> <table class="memberdecls"> <tr><td colspan="2"><h2><a name="nested-classes"></a> Data Structures</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structcmn__t.html">cmn_t</a></td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">wrapper of operation of the cepstral mean normalization. <a href="structcmn__t.html#_details">More...</a><br/></td></tr> <tr><td colspan="2"><h2><a name="define-members"></a> Defines</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="abbf37b74032c295136b4b299ecfcedae"></a><!-- doxytag: member="cmn.h::CMN_WIN_HWM" ref="abbf37b74032c295136b4b299ecfcedae" args="" --> #define </td><td class="memItemRight" valign="bottom"><b>CMN_WIN_HWM</b>   800</td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a500dafed8351d334da9290ec4f3f6ab3"></a><!-- doxytag: member="cmn.h::CMN_WIN" ref="a500dafed8351d334da9290ec4f3f6ab3" args="" --> #define </td><td class="memItemRight" valign="bottom"><b>CMN_WIN</b>   500</td></tr> <tr><td colspan="2"><h2><a name="typedef-members"></a> Typedefs</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9384c411b10e9db9745cfb550a5c7652"></a><!-- doxytag: member="cmn.h::cmn_type_t" ref="a9384c411b10e9db9745cfb550a5c7652" args="" --> typedef enum <a class="el" href="cmn_8h.html#a5bb134416e9e63a317eac20b0102bd59">cmn_type_e</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#a9384c411b10e9db9745cfb550a5c7652">cmn_type_t</a></td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Types of cepstral mean normalization to apply to the features. <br/></td></tr> <tr><td colspan="2"><h2><a name="enum-members"></a> Enumerations</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#a5bb134416e9e63a317eac20b0102bd59">cmn_type_e</a> { <b>CMN_NONE</b> = 0, <b>CMN_CURRENT</b>, <b>CMN_PRIOR</b> }</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight"><p>Types of cepstral mean normalization to apply to the features. </p> <br/></td></tr> <tr><td colspan="2"><h2><a name="func-members"></a> Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acf5e65a03a0d74630add4a400fed0ce8"></a><!-- doxytag: member="cmn.h::cmn_type_from_str" ref="acf5e65a03a0d74630add4a400fed0ce8" args="(const char *str)" --> SPHINXBASE_EXPORT <a class="el" href="cmn_8h.html#a9384c411b10e9db9745cfb550a5c7652">cmn_type_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#acf5e65a03a0d74630add4a400fed0ce8">cmn_type_from_str</a> (const char *str)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Convert string representation (from command-line) to cmn_type_t. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7ba6ce5489afce232b9bb61bd2ebd20f"></a><!-- doxytag: member="cmn.h::cmn_init" ref="a7ba6ce5489afce232b9bb61bd2ebd20f" args="(int32 veclen)" --> SPHINXBASE_EXPORT <a class="el" href="structcmn__t.html">cmn_t</a> * </td><td class="memItemRight" valign="bottom"><b>cmn_init</b> (int32 veclen)</td></tr> <tr><td class="memItemLeft" align="right" valign="top">SPHINXBASE_EXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#accf10de8ef4d98b4bf591529cf16565e">cmn</a> (<a class="el" href="structcmn__t.html">cmn_t</a> *cmn, mfcc_t **mfc, int32 varnorm, int32 n_frame)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">CMN for the whole sentence. <a href="#accf10de8ef4d98b4bf591529cf16565e"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">SPHINXBASE_EXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#aa622cf1b6a1b9a9bffd8f60b903bfc42">cmn_prior</a> (<a class="el" href="structcmn__t.html">cmn_t</a> *cmn, mfcc_t **incep, int32 varnorm, int32 nfr)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">CMN for one block of data, using prior mean. <a href="#aa622cf1b6a1b9a9bffd8f60b903bfc42"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="aae61df2ec71082520669fc63d94bb1ef"></a><!-- doxytag: member="cmn.h::cmn_prior_update" ref="aae61df2ec71082520669fc63d94bb1ef" args="(cmn_t *cmn)" --> SPHINXBASE_EXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#aae61df2ec71082520669fc63d94bb1ef">cmn_prior_update</a> (<a class="el" href="structcmn__t.html">cmn_t</a> *cmn)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Update prior mean based on observed data. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0f6f70d51143d6a33130650b8d4758ab"></a><!-- doxytag: member="cmn.h::cmn_prior_set" ref="a0f6f70d51143d6a33130650b8d4758ab" args="(cmn_t *cmn, mfcc_t const *vec)" --> SPHINXBASE_EXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#a0f6f70d51143d6a33130650b8d4758ab">cmn_prior_set</a> (<a class="el" href="structcmn__t.html">cmn_t</a> *cmn, mfcc_t const *vec)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Set the prior mean. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a4f624f5b805288f66fa05b79b1e4f383"></a><!-- doxytag: member="cmn.h::cmn_prior_get" ref="a4f624f5b805288f66fa05b79b1e4f383" args="(cmn_t *cmn, mfcc_t *vec)" --> SPHINXBASE_EXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#a4f624f5b805288f66fa05b79b1e4f383">cmn_prior_get</a> (<a class="el" href="structcmn__t.html">cmn_t</a> *cmn, mfcc_t *vec)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Get the prior mean. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0f70f378107e3d4e861e39d4f76d8d50"></a><!-- doxytag: member="cmn.h::cmn_free" ref="a0f70f378107e3d4e861e39d4f76d8d50" args="(cmn_t *cmn)" --> SPHINXBASE_EXPORT void </td><td class="memItemRight" valign="bottom"><b>cmn_free</b> (<a class="el" href="structcmn__t.html">cmn_t</a> *cmn)</td></tr> <tr><td colspan="2"><h2><a name="var-members"></a> Variables</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">SPHINXBASE_EXPORT const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cmn_8h.html#ae2ab0bad7168386076c43fc2a421867f">cmn_type_str</a> []</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">String representations of cmn_type_t values. <a href="#ae2ab0bad7168386076c43fc2a421867f"></a><br/></td></tr> </table> <hr/><a name="_details"></a><h2>Detailed Description</h2> <div class="textblock"><p>Apply Cepstral Mean Normalization (CMN) to the set of input mfc frames. </p> <p>By subtractingthe mean of the input from each frame. C0 is also included in this process. This function operates on an entire utterance at a time. Hence, the entire utterance must be available beforehand (batchmode). </p> <p>Definition in file <a class="el" href="cmn_8h_source.html">cmn.h</a>.</p> </div><hr/><h2>Function Documentation</h2> <a class="anchor" id="accf10de8ef4d98b4bf591529cf16565e"></a><!-- doxytag: member="cmn.h::cmn" ref="accf10de8ef4d98b4bf591529cf16565e" args="(cmn_t *cmn, mfcc_t **mfc, int32 varnorm, int32 n_frame)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">SPHINXBASE_EXPORT void cmn </td> <td>(</td> <td class="paramtype"><a class="el" href="structcmn__t.html">cmn_t</a> * </td> <td class="paramname"><em>cmn</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">mfcc_t ** </td> <td class="paramname"><em>mfc</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int32 </td> <td class="paramname"><em>varnorm</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int32 </td> <td class="paramname"><em>n_frame</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>CMN for the whole sentence. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">cmn</td><td>In/Out: cmn normalization, which contains the cmn_mean and cmn_var) </td></tr> <tr><td class="paramname">mfc</td><td>In/Out: mfc[f] = mfc vector in frame f </td></tr> <tr><td class="paramname">varnorm</td><td>In: if not FALSE, variance normalize the input vectors to have unit variance (along each dimension independently); Irrelevant if no cmn is performed </td></tr> <tr><td class="paramname">n_frame</td><td>In: Number of frames of mfc vectors </td></tr> </table> </dd> </dl> <p>Definition at line <a class="el" href="cmn_8c_source.html#l00150">150</a> of file <a class="el" href="cmn_8c_source.html">cmn.c</a>.</p> <p>References <a class="el" href="cmn_8h_source.html#l00129">cmn_t::cmn_mean</a>, <a class="el" href="cmn_8h_source.html#l00130">cmn_t::cmn_var</a>, <a class="el" href="err_8h_source.html#l00147">E_INFO</a>, <a class="el" href="err_8h_source.html#l00153">E_INFOCONT</a>, and <a class="el" href="cmn_8h_source.html#l00133">cmn_t::veclen</a>.</p> </div> </div> <a class="anchor" id="aa622cf1b6a1b9a9bffd8f60b903bfc42"></a><!-- doxytag: member="cmn.h::cmn_prior" ref="aa622cf1b6a1b9a9bffd8f60b903bfc42" args="(cmn_t *cmn, mfcc_t **incep, int32 varnorm, int32 nfr)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">SPHINXBASE_EXPORT void cmn_prior </td> <td>(</td> <td class="paramtype"><a class="el" href="structcmn__t.html">cmn_t</a> * </td> <td class="paramname"><em>cmn</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">mfcc_t ** </td> <td class="paramname"><em>incep</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int32 </td> <td class="paramname"><em>varnorm</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int32 </td> <td class="paramname"><em>nfr</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>CMN for one block of data, using prior mean. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">cmn</td><td>In/Out: cmn normalization, which contains the cmn_mean and cmn_var) </td></tr> <tr><td class="paramname">incep</td><td>In/Out: mfc[f] = mfc vector in frame f </td></tr> <tr><td class="paramname">varnorm</td><td>This flag should always be 0 for live </td></tr> <tr><td class="paramname">nfr</td><td>Number of incoming frames </td></tr> </table> </dd> </dl> <p>Definition at line <a class="el" href="cmn__prior_8c_source.html#l00146">146</a> of file <a class="el" href="cmn__prior_8c_source.html">cmn_prior.c</a>.</p> <p>References <a class="el" href="cmn_8h_source.html#l00129">cmn_t::cmn_mean</a>, <a class="el" href="cmn__prior_8c_source.html#l00146">cmn_prior()</a>, <a class="el" href="err_8h_source.html#l00127">E_FATAL</a>, <a class="el" href="cmn_8h_source.html#l00132">cmn_t::nframe</a>, <a class="el" href="cmn_8h_source.html#l00131">cmn_t::sum</a>, and <a class="el" href="cmn_8h_source.html#l00133">cmn_t::veclen</a>.</p> <p>Referenced by <a class="el" href="cmn__prior_8c_source.html#l00146">cmn_prior()</a>.</p> </div> </div> <hr/><h2>Variable Documentation</h2> <a class="anchor" id="ae2ab0bad7168386076c43fc2a421867f"></a><!-- doxytag: member="cmn.h::cmn_type_str" ref="ae2ab0bad7168386076c43fc2a421867f" args="[]" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">SPHINXBASE_EXPORT const char* <a class="el" href="cmn_8h.html#ae2ab0bad7168386076c43fc2a421867f">cmn_type_str</a>[]</td> </tr> </table> </div> <div class="memdoc"> <p>String representations of cmn_type_t values. </p> <p>Definition at line <a class="el" href="cmn_8c_source.html#l00110">110</a> of file <a class="el" href="cmn_8c_source.html">cmn.c</a>.</p> <p>Referenced by <a class="el" href="cmn_8c_source.html#l00118">cmn_type_from_str()</a>, and <a class="el" href="feat_8c_source.html#l00689">feat_init()</a>.</p> </div> </div> </div> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="cmn_8h.html">cmn.h</a> </li> <li class="footer">Generated on Tue Apr 19 2011 for SphinxBase by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </li> </ul> </div> </body> </html>