PDS Random Variable

Tabla de contenidos

• Descarga
• Descripción
• Modo de uso:
  • New:
  • Get:
  • Destroy:
• Compilando e instalando la biblioteca Pds Random Variable
• Usando la biblioteca para compilar un programa
  • Compilando un ejemplo
  • Compilando un ejemplo - usando pkg-config
• Versión

Autor

Fernando Pujaico Rivera

Fecha

03 de noviembre del 2015

Descarga

La última versión de la biblioteca PDS Random Variable (libpdsrv) puede ser descargafa de este enlace

Descripción

"PDS Random Variable"(libdsrv) es una biblioteca escrita en C, para trabajar con variables aleatorias (o RV por sus siglas en ingles).

Usando PdsRv es posible generar RV's de tipo:

• Secuencia congruencial
• Uniformemente distribuida
• Gaussiana
• Rayleigh
• Exponencial
• Poisson

Modo de uso:

Todas las funciones para crear una variable aleatoria de tipo "tipova" siguen el siguiente formato.

New:

La función de creación de variable se llamará:

   PdsTipova *pds_tipova_new(....);

Los parámetros de esta función dependerá del tipo de RV, nótese que devuelve un puntero al tipo PdsTipova.

Get:

La función para la petición de un elemento de la RV X es:

   PdsRvReal     
   PdsRvInteger         pds_tipova_get_value(PdsTipova *X);
   PdsRvNaturalD 

Como se ve, esta función recibe un puntero a la RV X, y luego extrae un elemento de X en cada llamada a esta función. Los valores devueltos por esta función pueden ser variables de tipo PdsRvInteger, PdsRvNaturalD o PdsRvReal, según el tipo de variable aleatoria X. También es posible pedir a la RV X el último valor generado, para conseguir esto, se usan las siguientes funciones según sea el tipo de variable de X.

   PdsRvReal     
   PdsRvInteger         pds_tipova_get_last_value(PdsTipova *X);
   PdsRvNaturalD 

Destroy:

La función para liberar la RV X es:

   void    pds_tipova_free(PdsTipova *X);

Si además de liberar la memoria, se desea cargar a la RV X con un NULL, se debe usar:

   void    pds_tipova_destroy (PdsTipova **X);

Compilando e instalando la biblioteca Pds Random Variable

Para compilar la biblioteca Pds Random Variable es necesario tener en cuenta el siguiente diagrama de dependencias de bibliotecas.

Crear/Compilar la biblioteca Pds Random Variable.

Como se puede ver, son necesarios los archivos de definiciones *.h y las bibliotecas empaquetadas en binario (*.a o *.so). Para instalar la biblioteca solo es necesario:

# Define donde se instalará la biblioteca, ejemplo: /usr
./configure     --prefix=/usr
# Compilar e instalar la biblioteca
make
sudo make install

Usando la biblioteca para compilar un programa

Una vez instalada la biblioteca Pds Random Variable, para que esta pueda ser usada por algún otro proyecto, es necesario tener en cuenta el siguiente diagrama de dependencia de la biblioteca.

Usar/Enlazar la biblioteca Pds Random Variable.

Como se vé, esta solamente depende de la biblioteca estándar de C. Para usar Pds Random Variable en un proyecto (como test.c), se debe agregar la siguiente cabecera al inicio del código fuente.

#include <pds/pdsrv.h>

Esto incluirá todas las definiciones de las funciones de la biblioteca Pds Random Variable.

Compilando un ejemplo

Luego para compilar enlazando estaticamente (Statically linked) un archivo de código fuente llamado test.c, debe ser usado el siguiente comando

gcc -static -o test test.c -lpdsrv

Por otro lado si se desea compilar enlazando dinamicamente (Dynamically linked) un archivo de código fuente llamado test.c, debe ser usado el siguiente comando

gcc -o test test.c -lpdsrv

Compilando un ejemplo - usando pkg-config

Adicionalmente es posible usar pkg-config para obtener los datos de configuración del proceso de compilación.

Atención

Es necesario tener instalado pkg-config

#Statically linked.

       gcc -static -o test test.c `pkg-config --libs  --cflags libpdsrv`

#Dynamically linked.

       gcc -o test test.c `pkg-config --libs  --cflags libpdsrv`

Versión

Es posible conocer la version instalada de la biblioteca libpdsrv usando el siguiente comando

pkg-config --modversion libpdsrv