Content-type: text/html
cc [ flag... ] file... -lmlib [ library... ] #include <mlib.h> mlib_status mlib_SignalNLMSFilterInit_S16_S16(void **filter, const mlib_f32 *flt, mlib_s32 tap, mlib_f32 beta);
mlib_status mlib_SignalNLMSFilterInit_S16S_S16S(void **filter, const mlib_f32 *flt, mlib_s32 tap, mlib_f32 beta);
mlib_status mlib_SignalNLMSFilterInit_F32_F32(void **filter, const mlib_f32 *flt, mlib_s32 tap, mlib_f32 beta);
mlib_status mlib_SignalNLMSFilterInit_F32S_F32S(void **filter, const mlib_f32 *flt, mlib_s32 tap, mlib_f32 beta);
mlib_status mlib_SignalNLMSFilter_S16_S16_Sat(mlib_s16 *dst, const mlib_s16 *src, const mlib_s16 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilter_S16S_S16S_Sat(mlib_s16 *dst, const mlib_s16 *src, const mlib_s16 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilter_F32_F32(mlib_f32 *dst, const mlib_f32 *src, const mlib_f32 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilter_F32S_F32S(mlib_f32 *dst, const mlib_f32 *src, const mlib_f32 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilterNonAdapt_S16_S16_Sat(mlib_s16 *dst, const mlib_s16 *src, const mlib_s16 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilterNonAdapt_S16S_S16S_Sat(mlib_s16 *dst, const mlib_s16 *src, const mlib_s16 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilterNonAdapt_F32_F32(mlib_f32 *dst, const mlib_f32 *src, const mlib_f32 *ref, void *filter, mlib_s32 n);
mlib_status mlib_SignalNLMSFilterNonAdapt_F32S_F32S(mlib_f32 *dst, const mlib_f32 *src, const mlib_f32 *ref, void *filter, mlib_s32 n);
void mlib_SignalNLMSFilterFree_S16_S16(void *filter);
void mlib_SignalNLMSFilterFree_S16S_S16S(void *filter);
void mlib_SignalNLMSFilterFree_F32_F32(void *filter);
void mlib_SignalNLMSFilterFree_F32S_F32S(void *filter);
The normalized LMS adaptive algorithm is summarized as follows:
Each of the FilterInit functions allocates memory for the internal filter structure and converts the parameters into the internal representation.
Each of the Filter functions applies the NLMS adaptive filter on one signal packet and updates the filter states.
Each of the FilterNoAdapt functions applies the NLMS filter on one signal packet and updates the filter states but without changing the filter weights.
Each of the FilterFree functions releases the memory allocated for the internal filter structure.
Each of the functions takes some of the following arguments:
filter
flt
tap
beta
dst
src
ref
n
Each of the FilterInit, Filter and FilterNonAdapt functions returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE. The FilterFree functions don't return anything.
See attributes(5) for descriptions of the following attributes:
|
mlib_SignalLMSFilter(3MLIB), attributes(5)