Funciones del módulo PdsCoin.

Estructuras de datos
struct	PdsCoin
	La estructura tipo PdsCoin. Esta estructura genera una variable aleatoria de Bernoulli. Para usar, incluir pdsrv/pdsrv.h. La función de densidad de probabilidad es: . Más...

'defines'
#define	PDS_MIN_COIN_PROB   1.0/PDS_RAND_MAX

Funciones
PdsCoin *	pds_coin_new (PdsRvReal p)
	Crea una variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_init (PdsCoin *X, PdsRvReal x0)
	Inicia con un valor x0 {-1,+1} a la variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_set_p (PdsCoin *X, PdsRvReal p)
	Inicia con una probabilidad de p a la variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_get_value (PdsCoin *X, PdsRvReal *x)
	Pide un valor {-1,1} a la variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_get_bit (PdsCoin *X, PdsRvByte *x)
	Pide un valor {0,1} a la variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_get_last_value (PdsCoin *X, PdsRvReal *x)
	Pide el último valor {-1,1} obtenido de la variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_get_last_bit (PdsCoin *X, PdsRvByte *x)
	Pide el último valor {0,1} obtenido de la variable aleatoria de tipo PdsCoin. Más...
int	pds_coin_get_vector (PdsCoin *X, PdsVector *V)
	Pide un vector de valores {-1,+1} a la variable aleatoria de tipo PdsCoin. Más...
void	pds_coin_free (PdsCoin *X)
	Libera la variable aleatoria de tipo puntero PdsCoin. Más...
void	pds_coin_destroy (PdsCoin **X)
	Libera la variable aleatoria de tipo puntero PdsCoin, y la carga con NULL. Más...

Descripción detallada

Documentación de los 'defines'

#define PDS_MIN_COIN_PROB   1.0/PDS_RAND_MAX

Minima probabilidad detectable y generable, es decir una probabilidad p, p< PDS_MIN_UNIFORM_PROB será considerada como cero; dada una probabilidad cualquiera p0, la probabilidad p+p0 será considerada como p0.

Definición en la línea 52 del archivo pdscoin.h.

Documentación de las funciones

PdsCoin * pds_coin_new

(

PdsRvReal

p

)

Crea una variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad p de obtener un 1 al ser jugada.

Parámetros

[in]

p

Probabilidad de la moneda de obtener un 1.

Devuelve

Un puntero a la variable aleatoria de tipo PdsCoin. La función retorna NULL en caso de error.

Ejemplos:

example_coin.c.

int pds_coin_init	(	PdsCoin *	X,
		PdsRvReal	x0
	)

Inicia con un valor x0 {-1,+1} a la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[in]	x0	Valor inicial de la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL.

int pds_coin_set_p	(	PdsCoin *	X,
		PdsRvReal	p
	)

Inicia con una probabilidad de p a la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[in]	p	Valor de probabilidad de la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL.

int pds_coin_get_value	(	PdsCoin *	X,
		PdsRvReal *	x
	)

Pide un valor {-1,1} a la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[out]	x	Valor de jugar la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL.

Ejemplos:

example_coin.c.

int pds_coin_get_bit	(	PdsCoin *	X,
		PdsRvByte *	x
	)

Pide un valor {0,1} a la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[out]	x	Valor de jugar la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL.

int pds_coin_get_last_value	(	PdsCoin *	X,
		PdsRvReal *	x
	)

Pide el último valor {-1,1} obtenido de la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[out]	x	Ultimo valor obtenido de jugar la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL.

int pds_coin_get_last_bit	(	PdsCoin *	X,
		PdsRvByte *	x
	)

Pide el último valor {0,1} obtenido de la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[out]	x	Ultimo valor obtenido de jugar la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL.

int pds_coin_get_vector	(	PdsCoin *	X,
		PdsVector *	V
	)

Pide un vector de valores {-1,+1} a la variable aleatoria de tipo PdsCoin.

Una variable de tipo PdsCoin representa una moneda de valores {0,1} con una probabilidad X->p de obtener un valor de 1 al ser jugada.

Parámetros

[in]	X	Variable aleatoria de tipo PdsCoin.
[out]	V	Vector a cargar con valores de la variable aleatoria de tipo PdsCoin.

Devuelve

TRUE si todo fue bien o FALSE si no. ejemplo X=NULL o V==NULL.

void pds_coin_free

(

PdsCoin *

X

)

Libera la variable aleatoria de tipo puntero PdsCoin.

Parámetros

[in]

X

La variable aleatoria a liberar.

Devuelve

No retorna valor.

void pds_coin_destroy

(

PdsCoin **

X

)

Libera la variable aleatoria de tipo puntero PdsCoin, y la carga con NULL.

Parámetros

[in]

X

La variable aleatoria a liberar.

Devuelve

No retorna valor.