mediaLib Library Functions
                     mlibSignalLPCAutoCorrelGetEnergyS16(3MLIB)



NAME
     mlibSignalLPCAutoCorrelGetEnergyS16,
     mlibSignalLPCAutoCorrelGetEnergyS16Adp   -   return   the
     energy of the input signal

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibSignalLPCAutoCorrelGetEnergyS16(
          mlibs16 *engery, mlibs32 escale, void *state);


     mlibstatus mlibSignalLPCAutoCorrelGetEnergyS16Adp(
          mlibs16 *engery, mlibs32 *escale, void *state);


DESCRIPTION
     Each of the functions returns the energy of the  input  sig-
     nal.


     In linear predictive coding (LPC) model, each speech  sample
     is  represented  as  a linear combination of the past M sam-
     ples.

                    M
            s(n) = SUM a(i) * s(n-i) ] G * u(n)
                   i=1



     where s(*) is the speech signal, u(*) is the excitation sig-
     nal,  and  G  is  the  gain constants, M is the order of the
     linear prediction filter. Given s(*), the goal is to find  a
     set  of coefficient a(*) that minimizes the prediction error
     e(*).

                           M
            e(n) = s(n) - SUM a(i) * s(n-i)
                          i=1



     In autocorrelation method, the coefficients can be  obtained
     by solving following set of linear equations.

             M
            SUM a(i) * r(i-k) = r(k), k=1,...,M
            i=1




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions
                     mlibSignalLPCAutoCorrelGetEnergyS16(3MLIB)



     where

                  N-k-1
            r(k) = SUM s(j) * s(j]k)
                   j=0



     are the autocorrelation  coefficients  of  s(*),  N  is  the
     length of the input speech vector. r(0) is the energy of the
     speech signal.


     Note that the autocorrelation matrix R is a Toeplitz  matrix
     (symmetric  with all diagonal elements equal), and the equa-
     tions can be solved efficiently with  Levinson-Durbin  algo-
     rithm.


     See Fundamentals of Speech Recognition by  Lawrence  Rabiner
     and Biing-Hwang Juang, Prentice Hall, 1993.


     Note for functions with adaptive scaling  (with  Adp  post-
     fix),  the  scaling factor of the output data will be calcu-
     lated based on the actual  data;  for  functions  with  non-
     adaptive  scaling  (without Adp postfix), the user supplied
     scaling factor will be used and the output will be saturated
     if necessary.

PARAMETERS
     Each function takes the following arguments:

     energy    The energy of the input signal.


     escale    The  scaling   factor   of   the   energy,   where
               actualdata = outputdata * 2**(-scalingfactor).


     state     Pointer to the internal state structure.


RETURN VALUES
     Each function returns MLIBSUCES if successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:




SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions
                     mlibSignalLPCAutoCorrelGetEnergyS16(3MLIB)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     mlibSignalLPCAutoCorrelInitS16(3MLIB),
     mlibSignalLPCAutoCorrelS16(3MLIB),
     mlibSignalLPCAutoCorrelGetPARCORS16(3MLIB),
     mlibSignalLPCAutoCorrelFreeS16(3MLIB), attributes(5)








































SunOS 5.11           Last change: 2 Mar 2007                    3






mediaLib Library Functions
                     mlibSignalLPCAutoCorrelGetEnergyS16(3MLIB)






















































SunOS 5.11           Last change: 2 Mar 2007                    4