Home | Develop | Download | Contact
PDS Real Arrays

Tabla de contenidos


Autor
Fernando Pujaico Rivera
Fecha
$\mathrm{\today}$
Versión
0.15.0

1 Descargando la biblioteca

1.1 Descargando paquete *.tar.gz

La versión 0.15.0 de la biblioteca PDS Real Arrays (libpdsra) puede ser descargado en libpdsra-0.15.0.tar.gz o usando el comando:

wget http://download.savannah.gnu.org/releases/pdsplibrary/src/libpdsra/libpdsra-0.15.0.tar.gz

Es necesario tener instalado wget.

1.2 Descargando el actual código fuente no versionado

El actual código fuente no oficial de PDS Real Arrays puede ser descargado usando el comando:

bzr branch bzr://bzr.savannah.nongnu.org/pdsplibrary/libpdsra

Es necesario tener instalado bazaar.

2 Compilando e instalando la biblioteca

Para compilar la biblioteca PDS Real Arrays es necesario tener en cuenta el siguiente diagrama de dependencias de la biblioteca.

compilar.png
Crear/Compilar la biblioteca PDS Real Arrays.

Como se puede ver, son necesarios los archivos de definiciones *.h y las bibliotecas empaquetadas en binario (*.a o *.so).

2.1 Compilando e instalando desde código

# Creando directorio de compilación
mkdir build
cd build
# Define donde se instalará la biblioteca, ejemplo: /usr/local
# Define donde está el código fuente la biblioteca, ejemplo: /path/of/source/libpdsra
cmake -DCMAKE_INSTALL_PREFIX=/usr/local /path/of/source/libpdsra
# Compila el codigo fuente
make
# Instala la biblioteca
sudo make install

2.2 Compilando e instalando desde *.deb

# Creando directorio de compilación
mkdir build
cd build
# Define donde está el código fuente la biblioteca, ejemplo: /path/of/source/libpdsra
# Es obligatorio usar el el directorio de instalación en /usr
cmake -DCMAKE_INSTALL_PREFIX=/usr /path/of/source/libpdsra
# Compilar y crea el paquete *.deb
make package
# Instala la biblioteca
sudo dpkg -i libpdsra-0.15.0_ARCHITECTURE.deb

Donde ARCHITECTURE puede ser "i386", "amd64", etc.

3 Usando la biblioteca para compilar un programa

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

enlazar.png
Usar/Enlazar dinámicamente la biblioteca PDS Real Arrays.

Para usar PDS Real Arrays en un proyecto (como example.c), se debe agregar la siguiente cabecera al inicio del código fuente.

#include <pds/pdsra.h>

Esto incluirá todas las definiciones de las funciones de la biblioteca PDS Real Arrays.

3.1 Código de ejemplo

#include <stdlib.h>
#include <pds/pdsra.h>
int main(int argc, char** argv)
{
PdsMatrix *Mat=NULL;
PdsMatrix *Mat1=NULL;
PdsMatrix *Mat2=NULL;
PdsRaNatural lin,col;
Mat1=pds_matrix_new(3,3);
Mat2=pds_matrix_new(3,3);
if((Mat1==NULL)||(Mat2==NULL))
{
printf("ERROR: The matrix Mat1 or Mat2 could not be created.\n");
return EXIT_FAILURE;
}
printf("Mat1=\n"); pds_matrix_printf(Mat1);
printf("Mat2=\n"); pds_matrix_printf(Mat2);
Mat=pds_matrix_mul_matrix_new(Mat1,Mat2);
if(Mat==NULL)
{
printf("ERROR: Matrix Mat could not be created.\n");
return EXIT_FAILURE;
}
printf("Mat=Mat1*Mat2=\n");
printf("MIN::Mat[%d][%d]=%f\n",lin,col,m);
printf("MAX::Mat[%d][%d]=%f\n",lin,col,m);
if(Mat==NULL) printf("Matrix Mat has been released and cleaned.\n");
if(Mat1==NULL) printf("Matrix Mat1 has been released and cleaned.\n");
if(Mat2==NULL) printf("Matrix Mat2 has been released and cleaned.\n");
return EXIT_SUCCESS;
}

example.c

3.2 Compilando un ejemplo

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

gcc -static -o example example.c -lpdsra -lm

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

gcc -o example example.c -lpdsra

3.3 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 example example.c `pkg-config --static --libs --cflags libpdsra`


#Dynamically linked.
gcc -o example example.c `pkg-config --libs --cflags libpdsra`

4 Versión

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

pkg-config --modversion libpdsra

Enlaces de interés

HomePage Bazaar Download Bug report Ayuda Developer Feed