# mlib_signallpcpitchanalyze_s16(3mlib) [sunos man page]

mlib_SignalLPCPitchAnalyze_S16(3MLIB) mediaLib Library Functions mlib_SignalLPCPitchAnalyze_S16(3MLIB)NAME

mlib_SignalLPCPitchAnalyze_S16 - perform open-loop pitch analysisSYNOPSIS

cc [ flag... ] file...[ library... ] #include <mlib.h> mlib_status mlib_SignalLPCPitchAnalyze_S16(mlib_s32 *pitch, const mlib_s16 *sigwgt, const mlib_s32 *region, mlib_s32 length);-lmlibDESCRIPTION

The mlib_SignalLPCPitchAnalyze_S16() function performs open-loop pitch analysis. The open-loop pitch analysis uses perceptual weighted signal and is done with following steps. In the first step, three maxima of the correlation N-1 R(k) = SUM sw(j) * sw(j-k) j=0 where N = length, is located for each of the three search regions. In the second step, the retained maxima R(Ti), i=0,1,2 are normalized as following. R(Ti) Rn(ti) =, i=0,1,2 N-1 2 SQRT(SUM sw(j-Ti) ) j=0 where N = length. In the third step, the best open-loop delay Topt is determined as following. Topt = T0 if (Rn(t1) >= (0.85 * Rn(Topt)) Topt = t1 if (Rn(t2) >= (0.85 * Rn(Topt)) Topt = t2 See G.729, G.729A, GSM EFR standards.---------------------PARAMETERS

The function takes the following arguments: pitch The speech pitch estimated. sigwgt The weighted signal vector with samples in Q15 format. sigwgt points to the current sample of the weighted signal vector, length samples must be availabe after this point, and MAX{region[i],i=0,1,...,5} samples must be available before this point. region The lower/upper boundaries of the three search regions, where region[2*i] is the lower boundary of search region i and region[2*i+1] is the upper boundary of search region i. length The length of the signal vectors over which the correlation is calculated.RETURN VALUES

The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.ATTRIBUTES

See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+SEE ALSO

mlib_SignalLPCPitchAnalyze_F32(3MLIB), attributes(5)SunOS 5.1010 Nov 2004 mlib_SignalLPCPitchAnalyze_S16(3MLIB)

## Check Out this Related Man Page

mlib_SignalLPCPerceptWeight_S16(3MLIB) mediaLib Library Functions mlib_SignalLPCPerceptWeight_S16(3MLIB)NAME

mlib_SignalLPCPerceptWeight_S16 - perform perceptual weighting on input signalSYNOPSIS

cc [ flag... ] file...[ library... ] #include <mlib.h> mlib_status mlib_SignalLPCPerceptWeight_S16(mlib_s16 *sigwgt, const mlib_s16 *signal, const mlib_s16 *lpc, mlib_s32 lscale, mlib_s16 r1, mlib_s16 r2, void *state);-lmlibDESCRIPTION

The mlib_SignalLPCPerceptWeight_S16() function performs perceptual weighting on input signal. The perceptual weighting filter is defined as following. A(z*r1) W(z) =A(z*r2) where A(z) is the inverse filter M---------A(z) = 1 - SUM a(i) * z i=1 See G.723.1, G.728, G.729, G.729A, GSM EFR standards.-iPARAMETERS

The function takes the following arguments: sigwgt The weighted signal vector, the signal samples are in Q15 format. signal The input signal vector, the signal samples are in Q15 format. lpc The linear prediction coefficients. lscale The scaling factor of the linear prediction coefficients, where actual_data = input_data * 2**(-scaling_factor). r1 The perceptual weighting filter coefficient, the coefficient is in Q15 format, it is treated as 1 if 0 is supplied. r2 The perceptual weighting filter coefficient, the coefficient is in Q15 format, it is treated as 1 if 0 is supplied. state Pointer to the internal state structure.RETURN VALUES

The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.ATTRIBUTES

See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Committed | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+SEE ALSO

mlib_SignalLPCPerceptWeightInit_S16(3MLIB), mlib_SignalLPCPerceptWeightFree_S16(3MLIB), attributes(5)SunOS 5.112 Mar 2007 mlib_SignalLPCPerceptWeight_S16(3MLIB)