PDS Real Arrays

Tabla de contenidos

• 1 Descargando la biblioteca
  • 1.1 Descargando paquete *.tar.gz
  • 1.2 Descargando el actual código fuente no versionado
• 2 Compilando e instalando la biblioteca
  • 2.1 Compilando e instalando desde código
  • 2.2 Compilando e instalando desde *.deb
• 3 Usando la biblioteca para compilar un programa
  • 3.1 Código de ejemplo
  • 3.2 Compilando un ejemplo
  • 3.3 Compilando un ejemplo : usando pkg-config
• 4 Versión

Autor

Fernando Pujaico Rivera

Fecha

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.

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.

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;
    
    PdsRaReal m;
    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;
    }
    
    pds_matrix_init_rand(Mat1);
    printf("Mat1=\n");  pds_matrix_printf(Mat1);
    
    pds_matrix_init_rand(Mat2);
    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");
    pds_matrix_printf(Mat);
    
    pds_matrix_get_min_value_and_pos(Mat,&m,&lin,&col);
    printf("MIN::Mat[%d][%d]=%f\n",lin,col,m);
    
    pds_matrix_get_max_value_and_pos(Mat,&m,&lin,&col);
    printf("MAX::Mat[%d][%d]=%f\n",lin,col,m);
    
    pds_matrix_destroy(&Mat);
    if(Mat==NULL) printf("Matrix Mat  has been released and cleaned.\n");
    
    pds_matrix_destroy(&Mat1);
    if(Mat1==NULL) printf("Matrix Mat1 has been released and cleaned.\n");
    
    pds_matrix_destroy(&Mat2);
    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