PdsDigitalFilters: Funciones del módulo PdsFirLms.

Estructuras de datos
struct	PdsFirLms
	Una estructura tipo PdsFirLms . Más...

Funciones
PdsFirLms *	pds_fir_lms_new (PdsDfReal Mhu, PdsRaNatural M)
	Crea un filtro FIR LMS con parametros h[i] del filtro FIR, con un valor inicial de h[i]=1/(1+M). Por defecto el filtro FIR LMS estará auto configurandose continuamente, a no ser que se deshabilite con pds_fir_lms_disable . Más...

int	pds_fir_lms_disable (PdsFirLms *FirLms)
	Deshabilita la reconfiguración de los pesos h[i] del filtro FIR LMS y se mantienen los ultimos pesos modificados. Más...

int	pds_fir_lms_enable (PdsFirLms *FirLms)
	Habilita la reconfiguración de los pesos h[i] del filtro FIR LMS. Más...

int	pds_fir_lms_set_mhu (PdsFirLms *FirLms, PdsDfReal Mhu)
	Coloca el valor Mhu del filtro FIR LMS. Más...

int	pds_fir_lms_evaluate_value (PdsFirLms FirLms, PdsDfReal d, PdsDfReal x, PdsDfReal e, PdsDfReal *y)
	Evalúa el filtro FIR LMS con el valor de entrada "d" e "x", el resultado es cargado en "e" e "y". Más...

int	pds_fir_lms_evaluate_vector (PdsFirLms FirLms, const PdsVector d, const PdsVector x, PdsVector e, PdsVector *y)
	Evalúa el filtro FIR LMS con el vector de entrada x, el resultado es cargado en el vector y. Más...

void	pds_fir_lms_free (PdsFirLms *FirLms)
	Libera el filtro de tipo PdsFirLms. Más...

void	pds_fir_lms_destroy (PdsFirLms **FirLms)
	Libera el filtro de tipo PdsFirLms. y carga la variable con NULL. Más...

Descripción detallada

Filtro LMS FIR

Actualización de pesos

$y[n]=\sum_{i=0}^{M}h_ix[n-i]$

$e[n]=d[n] - y[n]$

$h_i[n+1]=h_i[n] + \mu e[n] x[n-i]$

Documentación de las funciones

PdsFirLms * pds_fir_lms_new	(	PdsDfReal	Mhu,
		PdsRaNatural	M
	)

Crea un filtro FIR LMS con parametros h[i] del filtro FIR, con un valor inicial de h[i]=1/(1+M). Por defecto el filtro FIR LMS estará auto configurandose continuamente, a no ser que se deshabilite con pds_fir_lms_disable .

Parámetros

[in]	Mhu	Es el paso de la constante de adaptación.
[in]	M	Es el grado del filtro FIR, h[i], 0<= i <=M.

Devuelve: Un puntero a una estructura de tipo PdsFirLms. O NULL en caso de error.

Ejemplos:: testprog3.c y testprog4.c.

int pds_fir_lms_disable ( PdsFirLms * FirLms )

Deshabilita la reconfiguración de los pesos h[i] del filtro FIR LMS y se mantienen los ultimos pesos modificados.

Parámetros

[in,out] FirLms El filtro FIR LMS a usar.

Devuelve: TRUE si todo fue bien o FALSE si no;

int pds_fir_lms_enable ( PdsFirLms * FirLms )

Habilita la reconfiguración de los pesos h[i] del filtro FIR LMS.

Parámetros

[in,out] FirLms El filtro FIR LMS a usar.

Devuelve: TRUE si todo fue bien o FALSE si no;

int pds_fir_lms_set_mhu	(	PdsFirLms *	FirLms,
		PdsDfReal	Mhu
	)

Coloca el valor Mhu del filtro FIR LMS.

Parámetros

[in,out]	FirLms	El filtro FIR LMS a usar.
[in]	Mhu	Factor de aprendizaje Mhu.

Devuelve: TRUE si todo fue bien o FALSE si no;

int pds_fir_lms_evaluate_value	(	PdsFirLms *	FirLms,
		PdsDfReal	d,
		PdsDfReal	x,
		PdsDfReal *	e,
		PdsDfReal *	y
	)

Evalúa el filtro FIR LMS con el valor de entrada "d" e "x", el resultado es cargado en "e" e "y".

Parámetros

[in,out]	FirLms	El filtro FIR LMS a usar.
[in]	d	Es una entrada adicional al filtro FIR LMS.
[in]	x	Es la señal de entrada del filtro FIR.
[out]	e	Es la señal de error, es la diferencia entre "d" e "y".
[out]	y	Es el valor de salida del filtro FIR.

Devuelve: TRUE si todo fue bien o FALSE si no;

Ejemplos:: testprog3.c.

int pds_fir_lms_evaluate_vector	(	PdsFirLms *	FirLms,
		const PdsVector *	d,
		const PdsVector *	x,
		PdsVector *	e,
		PdsVector *	y
	)

Evalúa el filtro FIR LMS con el vector de entrada x, el resultado es cargado en el vector y.

Se recomienda usar esta función solo cuando x es mucho mayo que FIR->h. Solo se realizan corrimientos de FIR->X al inicio y al final del vector x en los casos intermediarios se aprovecha tener el vector y no se efectuan corrimientos, por lo que es un poco mas rápido que pds_fir_lms_evaluate_value cuando x es mucho mayo que FIR->h.

Parámetros

[in,out]	FirLms	El filtro FIR a usar.
[in]	d	Es el vector de una entrada adicional al filtro FIR LMS.
[in]	x	Es el vector de la señal de entrada del filtro FIR.
[out]	e	Es el vector de la señal de error, es la diferencia entre "d" e "y".
[out]	y	Es el vector del valor de salida del filtro FIR.

Devuelve: TRUE si todo fue bien o FALSE si no.

Ejemplos:: testprog4.c.

void pds_fir_lms_free ( PdsFirLms * FirLms )

Libera el filtro de tipo PdsFirLms.

Parámetros

[in] FirLms El filtro a liberar.

Devuelve: No retorna valor.

Ejemplos:: testprog3.c y testprog4.c.

void pds_fir_lms_destroy ( PdsFirLms ** FirLms )

Libera el filtro de tipo PdsFirLms. y carga la variable con NULL.

Parámetros

[in] FirLms El filtro a liberar.

Devuelve: No retorna valor.

Estructuras de datos

Funciones

Descripción detallada

Documentación de las funciones

Enlaces de interés