PDS Real Arrays in C++

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

2021-11-28

Versión

0.1.1

1 Descargando la biblioteca

1.1 Descargando paquete *.tar.gz

La versión 0.1.1 de la biblioteca PDS Real Arrays in C++ (libpdsramm) puede ser descargado en libpdsramm-0.1.1.tar.gz o usando el comando:

wget https://sourceforge.net/projects/libpdsmm/files/sources/libpdsramm/libpdsramm-0.1.1.tar.gz/download

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 in C++ puede ser descargado usando el comando:

git clone ssh://trucomanx@git.code.sf.net/p/libpdsmm/libpdsramm libpdsramm

Es necesario tener instalado bazaar.

2 Compilando e instalando la biblioteca

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

Crear/Compilar la biblioteca PDS Real Arrays in C++.

Como se puede ver, son necesarios los archivos de definiciones *.hpp 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/libpdsramm
cmake -DCMAKE_INSTALL_PREFIX=/usr/local  /path/of/source/libpdsramm
 
# 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/libpdsramm
# Es obligatorio usar el el directorio de instalación en /usr
cmake -DCMAKE_INSTALL_PREFIX=/usr /path/of/source/libpdsramm
 
# Compilar y crea el paquete *.deb
make package    
 
# Instala la biblioteca     
sudo dpkg -i libpdsramm-0.1.1_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 in C++, 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 in C++.

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

#include <Pds/Ra>

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

3.1 Código de ejemplo

#include <Pds/Ra>
 
int main(void)
{
    Pds::Matrix P =Pds::X3D();
    Pds::Matrix P0=Pds::Y3D();
    Pds::Matrix J =Pds::RotX(Pds::Ra::Pi/2.0);
    
    Pds::Matrix F=P0 + J*(P-P0);
 
    F.Print("\nF:\n");
    
    Pds::Ra::PrintVersion("Version:\t");
    Pds::Ra::PrintPackage("Package:\t");
    
    return 0;
}

example.cpp

3.2 Compilando un ejemplo

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

g++ -static -o example example.cpp -lpdsramm 

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

g++ -o example example.cpp -lpdsramm 

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.
 
   g++ -static -o example example.cpp `pkg-config --static --libs --cflags libpdsramm`

#Dynamically linked.
 
   g++ -o example example.cpp `pkg-config --libs --cflags libpdsramm`

4 Versión

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

pkg-config --modversion libpdsramm