cmn.h
Go to the documentation of this file.
/* -*- c-basic-offset: 4; indent-tabs-mode: nil -*- */
/* ====================================================================
* Copyright (c) 1999-2004 Carnegie Mellon University. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* This work was supported in part by funding from the Defense Advanced
* Research Projects Agency and the National Science Foundation of the
* United States of America, and the CMU Sphinx Speech Consortium.
*
* THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY ``AS IS'' AND
* ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY
* NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* ====================================================================
*
*/
/*
* cmn.h -- Various forms of cepstral mean normalization
*
* **********************************************
* CMU ARPA Speech Project
*
* Copyright (c) 1999 Carnegie Mellon University.
* ALL RIGHTS RESERVED.
* **********************************************
*
* HISTORY
* $Log$
* Revision 1.1 2006/04/05 20:27:30 dhdfu
* A Great Reorganzation of header files and executables
*
* Revision 1.13 2006/02/23 03:48:27 arthchan2003
* Resolved conflict in cmn.h
*
*
* Revision 1.12 2006/02/22 23:43:55 arthchan2003
* Merged from the branch SPHINX3_5_2_RCI_IRII_BRANCH: Put data structure into the cmn_t structure.
*
* Revision 1.11.4.2 2005/10/17 04:45:57 arthchan2003
* Free stuffs in cmn and feat corectly.
*
* Revision 1.11.4.1 2005/07/05 06:25:08 arthchan2003
* Fixed dox-doc.
*
* Revision 1.11 2005/06/21 19:28:00 arthchan2003
* 1, Fixed doxygen documentation. 2, Added $ keyword.
*
* Revision 1.4 2005/06/13 04:02:56 archan
* Fixed most doxygen-style documentation under libs3decoder.
*
* Revision 1.3 2005/03/30 01:22:46 archan
* Fixed mistakes in last updates. Add
*
*
* 20.Apr.2001 RAH (rhoughton@mediasite.com, ricky.houghton@cs.cmu.edu)
* Added cmn_free() and moved *mean and *var out global space and named them cmn_mean and cmn_var
*
* 28-Apr-1999 M K Ravishankar (rkm@cs.cmu.edu) at Carnegie Mellon University
* Copied from previous version.
*/
#ifndef _S3_CMN_H_
#define _S3_CMN_H_
/* Win32/WinCE DLL gunk */
#include <sphinxbase/sphinxbase_export.h>
#include <sphinxbase/prim_type.h>
#include <sphinxbase/fe.h>
#ifdef __cplusplus
extern "C" {
#endif
#if 0
/* Fool Emacs. */
}
#endif
typedef enum cmn_type_e {
CMN_NONE = 0,
CMN_BATCH,
CMN_LIVE
} cmn_type_t;
SPHINXBASE_EXPORT
extern const char *cmn_type_str[];
SPHINXBASE_EXPORT
cmn_type_t cmn_type_from_str(const char *str);
typedef struct {
mfcc_t *cmn_mean;
mfcc_t *cmn_var;
mfcc_t *sum;
int32 nframe;
int32 veclen;
} cmn_t;
SPHINXBASE_EXPORT
cmn_t* cmn_init(int32 veclen);
SPHINXBASE_EXPORT
void cmn (cmn_t *cmn,
mfcc_t **mfc,
int32 varnorm,
int32 n_frame
);
#define CMN_WIN_HWM 800 /* #frames after which window shifted */
#define CMN_WIN 500
SPHINXBASE_EXPORT
void cmn_live(cmn_t *cmn,
mfcc_t **incep,
int32 varnorm,
int32 nfr
);
SPHINXBASE_EXPORT
void cmn_live_update(cmn_t *cmn);
SPHINXBASE_EXPORT
void cmn_live_set(cmn_t *cmn, mfcc_t const *vec);
SPHINXBASE_EXPORT
void cmn_live_get(cmn_t *cmn, mfcc_t *vec);
/* RAH, free previously allocated memory */
SPHINXBASE_EXPORT
void cmn_free (cmn_t *cmn);
#ifdef __cplusplus
}
#endif
#endif
cmn_live_get
SPHINXBASE_EXPORT void cmn_live_get(cmn_t *cmn, mfcc_t *vec)
Get the live mean.
Definition cmn_live.c:73
cmn_live
SPHINXBASE_EXPORT void cmn_live(cmn_t *cmn, mfcc_t **incep, int32 varnorm, int32 nfr)
CMN for one block of data, using live mean.
Definition cmn_live.c:145
cmn_type_e
cmn_type_e
Types of cepstral mean normalization to apply to the features.
Definition cmn.h:110
cmn_type_t
enum cmn_type_e cmn_type_t
Types of cepstral mean normalization to apply to the features.
cmn
SPHINXBASE_EXPORT void cmn(cmn_t *cmn, mfcc_t **mfc, int32 varnorm, int32 n_frame)
CMN for the whole sentence.
Definition cmn.c:100
cmn_type_from_str
SPHINXBASE_EXPORT cmn_type_t cmn_type_from_str(const char *str)
Convert string representation (from command-line) to cmn_type_t.
Definition cmn.c:72
cmn_live_update
SPHINXBASE_EXPORT void cmn_live_update(cmn_t *cmn)
Update live mean based on observed data.
Definition cmn_live.c:112
cmn_type_str
SPHINXBASE_EXPORT const char * cmn_type_str[]
String representations of cmn_type_t values.
Definition cmn.c:59
cmn_live_set
SPHINXBASE_EXPORT void cmn_live_set(cmn_t *cmn, mfcc_t const *vec)
Set the live mean.
Definition cmn_live.c:51
prim_type.h
Basic type definitions used in Sphinx.
cmn_t
wrapper of operation of the cepstral mean normalization.
Definition cmn.h:128
cmn_t::veclen
int32 veclen
Length of cepstral vector.
Definition cmn.h:133
cmn_t::nframe
int32 nframe
Number of frames.
Definition cmn.h:132
cmn_t::cmn_var
mfcc_t * cmn_var
Temporary variables: stored the cmn variance.
Definition cmn.h:130
cmn_t::sum
mfcc_t * sum
The sum of the cmn frames.
Definition cmn.h:131
cmn_t::cmn_mean
mfcc_t * cmn_mean
Temporary variable: current means.
Definition cmn.h:129