PdsDigitalSources: Funciones del módulo PdsIQWave.

Estructuras de datos
struct	PdsIQWave
	La estructura tipo PdsIQWave . Más...

Funciones
PdsIQWave *	pds_iqwave_new (PdsDsReal A, PdsDsReal Teta)
	Crea una estructura de tipo PdsIQWave. Más...

PdsIQWave *	pds_iqwave_new_nos (PdsDsReal A, PdsDsNatural N)
	Crea una estructura de tipo PdsIQWave. Más...

int	pds_iqwave_get_value (PdsIQWave WAVE, PdsDsReal yc, PdsDsReal *ys)
	Obtiene un valor de yc e ys en la salida e itera el generador IQ sinusoidal. Más...

int	pds_iqwave_get_last_value (PdsIQWave WAVE, PdsDsReal yc, PdsDsReal *ys)
	Obtiene el último valor a la salida del generador IQ sinusoidal. Más...

int	pds_iqwave_get_vector (PdsIQWave WAVE, PdsVector VectorC, PdsVector *VectorS)
	Carga un par de vectores con valores obtenidos en la salida del generador IQ. Realiza una iteración para cada elemento "i" de los vectores. Más...

void	pds_iqwave_free (PdsIQWave *WAVE)
	Libera una estructura de tipo puntero PdsIQWave. Más...

void	pds_iqwave_destroy (PdsIQWave **WAVE)
	Libera una estructura de tipo puntero PdsIQWave, y lo carga con NULL. Más...

Descripción detallada

La frecuencia de muestreo es 2pi, teta $\theta$ es la frecuencia del IQ Wave

Generador IQ sinusoidal digital

$\begin{eqnarray*} y_c[n] &=& cos(\theta)~y_c[n-1]-sin(\theta)~y_s[n-1] \\ y_s[n] &=& sin(\theta)~y_c[n-1]+cos(\theta)~y_s[n-1] \end{eqnarray*}$

$y_c[n]=A~cos[(n+1)\theta ]$

$y_s[n]=A~sin[(n+1)\theta ]$

$y_c[0]=A~cos[\theta ]~~~y_c[-1]=A$

$y_s[0]=A~sin[\theta ]~~~y_s[-1]=0$

Documentación de las funciones

PdsIQWave * pds_iqwave_new	(	PdsDsReal	A,
		PdsDsReal	Teta
	)

Crea una estructura de tipo PdsIQWave.

El primer valor de la estructura es yc[0]=A*cos(Teta) ys[0]=A*sin(Teta).

Parámetros

[in]	A	Es la amplitud de onda IQ sinusoidal.
[in]	Teta	$\theta$ Es la frecuencia normalizada a 2pi para Fsampling, en la onda IQ sinusoidal.

Devuelve: Un puntero a una estructura de tipo PdsIQWave.

Ejemplos:: testprog2.c.

PdsIQWave * pds_iqwave_new_nos	(	PdsDsReal	A,
		PdsDsNatural	N
	)

Crea una estructura de tipo PdsIQWave.

El primer valor de la estructura es yc[0]=A*cos(Teta) ys[0]=A*sin(Teta).

Parámetros

[in]	A	Es la amplitud de onda IQ sinusoidal.
[in]	N	Número de muestras por periodo en la onda IQ sinusoidal.

Devuelve: Un puntero a una estructura de tipo PdsIQWave.

int pds_iqwave_get_value	(	PdsIQWave *	WAVE,
		PdsDsReal *	yc,
		PdsDsReal *	ys
	)

Obtiene un valor de yc e ys en la salida e itera el generador IQ sinusoidal.

Parámetros

[in,out]	WAVE	La estructura de PdsIQWave a consultar.
[out]	yc	En esta variable se carga el nuevo valor a la salida de generador coseno.
[out]	ys	En esta variable se carga el nuevo valor a la salida de generador seno.

Devuelve: TRUE si todo fue bien o FALSE si no. Ejemplo WAVE==NULL.

int pds_iqwave_get_last_value	(	PdsIQWave *	WAVE,
		PdsDsReal *	yc,
		PdsDsReal *	ys
	)

Obtiene el último valor a la salida del generador IQ sinusoidal.

Parámetros

[in,out]	WAVE	La estructura de PdsIQWave a consultar.
[out]	yc	En esta variable se carga el último valor a la salida de generador coseno.
[out]	ys	En esta variable se carga el último valor a la salida de generador seno.

Devuelve: TRUE si todo fue bien o FALSE si no. Ejemplo WAVE==NULL.

int pds_iqwave_get_vector	(	PdsIQWave *	WAVE,
		PdsVector *	VectorC,
		PdsVector *	VectorS
	)

Carga un par de vectores con valores obtenidos en la salida del generador IQ. Realiza una iteración para cada elemento "i" de los vectores.

Parámetros

[in,out]	WAVE	La estructura de PdsIQWave a consultar.
[out]	VectorC	En este vector se cargará los valores a la salida coseno de generador.
[out]	VectorS	En este vector se cargará los valores a la salida seno de generador.

Devuelve: TRUE si todo fue bien o FALSE si no. Ejemplo WAVE==NULL, Vector==NULL o los tamaños de los vectores no coinciden.

Ejemplos:: testprog2.c.

void pds_iqwave_free ( PdsIQWave * WAVE )

Libera una estructura de tipo puntero PdsIQWave.

Parámetros

[in,out] WAVE La estructura de PdsIQWave a liberar.

Devuelve: No retorna valor.

Ejemplos:: testprog2.c.

void pds_iqwave_destroy ( PdsIQWave ** WAVE )

Libera una estructura de tipo puntero PdsIQWave, y lo carga con NULL.

Parámetros

[in,out] WAVE La estructura de PdsIQWave a liberar.

Devuelve: No retorna valor.

Estructuras de datos

Funciones

Descripción detallada

Documentación de las funciones

Enlaces de interés