FIRLMSMRUpdateTaps

Updates the filter coefficients using the adaptation error value.

Syntax

IppStatus ippsFIRLMSMRUpdateTaps32s_16s(Ipp32s errVal, IppsFIRLMSMRState32s_16s* pState);

IppStatus ippsFIRLMSMRUpdateTaps32sc_16sc(Ipp32scerrVal, IppsFIRLMSMRState32sc_16sc* pState);

Parameters

pState

Pointer to the filter state structure.

errVal

Adaptation error value.

Description

The function ippsFIRLMSMRUpdateTaps is declared in the ipps.h file. This function updates the filter coefficients that are stored in the filter state structure pState. It is assumed that the filter operation was performed and the adaptation error value errVal was computed before calling this function. The adaptation error value is computed outside the function as the difference between output and reference signals. Updated filter coefficients are defined as hn+1(i) = hn(i) + mu * errVal * x(n- (i * dlyStep) - updateDly),

where hn+1(i) denotes new taps, hn(i) denotes initial taps, and mu, errVal and updateDly are the adaptation step, adaptation error value and adaptation delay, respectively. Before calling the function ippsFIRLMSMRUpdateTaps the filter state structure must be initialized by the function ippsFIRLMSMRInitAlloc.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when the pState pointer is NULL.

ippStsContextMatchErr

Indicates an error when the state identifier is incorrect.

Submit feedback on this help topic

Copyright © 2000 - 2011, Intel Corporation. All rights reserved.