Funciones del módulo PdsUniform.

Estructuras de datos
struct	PdsUniform
	La estructura tipo PdsUniform. Esta estructura genera una variable aleatoria uniformemente distribuida. Esta R.V. está generada mediante el método congruencial mixto para 2^N, N=31. Para usar, incluir pdsrv/pdsrv.h. La función de densidad de probabilidad es: . Más...

'defines'
#define	PDS_MIN_UNIFORM_PROB   1.0/PDS_RAND_MAX

Funciones
PdsUniform *	pds_uniform_new (PdsRvReal A, PdsRvReal B)
	Crea una variable aleatoria de tipo PdsUniform. Más...
int	pds_uniform_init (PdsUniform *X, PdsRvReal x0)
	Inicializa la variable pseudo aleatorio y uniforme entre [A,B). Más...
int	pds_uniform_get_value (PdsUniform *X, PdsRvReal *x)
	Retorna un número pseudo aleatorio y uniforme entre [A,B), con PDS_RAND_MAX divisiones de resolución. Más...
int	pds_uniform_get_last_value (PdsUniform *X, PdsRvReal *x)
	Retorna el último número pseudo aleatorio entregado por la R.V. uniforme entre [A,B), con PDS_RAND_MAX divisiones de resolución. Más...
int	pds_uniform_get_vector (PdsUniform *X, PdsVector *x)
	Retorna un vector con valores pseudo aleatorio y uniforme entre [A,B), con PDS_RAND_MAX divisiones de resolución. Más...
void	pds_uniform_free (PdsUniform *X)
	Libera la variable aleatoria de tipo puntero PdsUniform. Más...
void	pds_uniform_destroy (PdsUniform **X)
	Libera la variable aleatoria de tipo puntero PdsUniform, y la carga con NULL. Más...

Descripción detallada

Documentación de los 'defines'

#define PDS_MIN_UNIFORM_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. Esto implica que si la variable aleatoria uniforme tiene valore x. 0 <= x <=1.0, entonces el minimo valor de cambio de x es PDS_MIN_UNIFORM_PROB .

Definición en la línea 56 del archivo pdsuniform.h.

Documentación de las funciones

PdsUniform * pds_uniform_new	(	PdsRvReal	A,
		PdsRvReal	B
	)

Crea una variable aleatoria de tipo PdsUniform.

Parámetros

[in]	A	Rango inicial izquierdo de la variable aleatoria.
[in]	B	Rango final derecho de la variable aleatoria.

Devuelve

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

int pds_uniform_init	(	PdsUniform *	X,
		PdsRvReal	x0
	)

Inicializa la variable pseudo aleatorio y uniforme entre [A,B).

Parámetros

[in]	X	Variable aleatoria uniformemente distribuida.
[in]	x0	X{inicial}=x0, si esta fuera de [A,B),X{inicial}=A.

Devuelve

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

int pds_uniform_get_value	(	PdsUniform *	X,
		PdsRvReal *	x
	)

Retorna un número pseudo aleatorio y uniforme entre [A,B), con PDS_RAND_MAX divisiones de resolución.

Parámetros

[in]	X	Variable aleatoria uniformemente distribuida.
[out]	x	x es cargado con un número entre [A,B). Incluye A pero no B. Si X es NULL entonces retorna 0.

Devuelve

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

int pds_uniform_get_last_value	(	PdsUniform *	X,
		PdsRvReal *	x
	)

Retorna el último número pseudo aleatorio entregado por la R.V. uniforme entre [A,B), con PDS_RAND_MAX divisiones de resolución.

Parámetros

[in]	X	Variable aleatoria uniformemente distribuida.
[out]	x	x es cargado con un número entre [A,B). Incluye A pero no B. Si X es NULL entonces retorna 0.

Devuelve

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

int pds_uniform_get_vector	(	PdsUniform *	X,
		PdsVector *	x
	)

Retorna un vector con valores pseudo aleatorio y uniforme entre [A,B), con PDS_RAND_MAX divisiones de resolución.

Parámetros

[in]	X	Variable aleatoria uniformemente distribuida.
[out]	x	x es cargado con números entre [A,B). Incluye A pero no B. Si X es NULL entonces el vector no es alterado.

Devuelve

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

void pds_uniform_free

(

PdsUniform *

X

)

Libera la variable aleatoria de tipo puntero PdsUniform.

Parámetros

[in]

X

La variable aleatoria a liberar.

Devuelve

No retorna valor.

void pds_uniform_destroy

(

PdsUniform **

X

)

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

Parámetros

[in]

X

La variable aleatoria a liberar.

Devuelve

No retorna valor.