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
4 Versión

Autor: Fernando Pujaico Rivera

Fecha: $\mathrm{\today}$

Versión: 0.5.0

1 Descargando la biblioteca

1.1 Descargando paquete *.tar.gz

La versión 0.5.0 de la biblioteca PDS Single Neurons (libpdssn) puede ser descargado en libpdssn-0.5.0.tar.gz o usando el comando:

wget http://download.savannah.gnu.org/releases/pdsplibrary/src/libpdssn/libpdssn-0.5.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 Single Neurons puede ser descargado usando el comando:

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

Es necesario tener instalado bazaar.

2 Compilando e instalando la biblioteca

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

Crear/Compilar la biblioteca PDS Single Neurons.

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/libpdssn
cmake -DCMAKE_INSTALL_PREFIX=/usr/local  /path/of/source/libpdssn
# 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/libpdssn
# Es obligatorio usar el el directorio de instalación en /usr
cmake -DCMAKE_INSTALL_PREFIX=/usr /path/of/source/libpdssn
# Compilar y crea el paquete *.deb
make package    
# Instala la biblioteca     
sudo dpkg -i libpdssn-0.5.0_ARCHITECTURE.deb  

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

3 Usando la biblioteca para compilar un programa

Una vez instalada la biblioteca PDS Single Neurons, 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 Single Neurons.

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

#include <pds/pdssn.h>

Esto incluirá todas las definiciones de las funciones de la biblioteca PDS Single Neurons.

3.1 Código de ejemplo

#include <stdlib.h>
#include <pds/pdssn.h>
    
int main(int argc, char** argv)
{
    PdsSnReal X[4]={1.0, 0.5, -0.3, -1.7};
    PdsSnNatural N=4;
    PdsSnReal Out;
    
    // Creating an input vector of N elements
    PdsNIVector *Input=pds_nivector_new(N);
    // Creating a neuron with N inputs
    PdsNeuron *Neuron=pds_neuron_new(N);
    
    if( (Input==NULL)||(Neuron==NULL) ) return EXIT_FAILURE;
    
    // Connect the input vector with the input of neuron
    pds_neuron_connect_input_with_nivector(Neuron,Input);
    
    // Initializing weights and print the values
    pds_neuron_init_u_and_weight_rand(Neuron,-1.0,+1.0);
    pds_neuron_printf_u_and_weight(Neuron);
    
    // Copy the X array in the input vector
    pds_nivector_set_input_from_array(Input,X,N);
    
    // Iterate the neuron
    pds_neuron_iterate(Neuron);
    
    // Get the output value of neuron
    pds_neuron_get_output(Neuron,&Out);
    printf("Y=%7.3f\n",Out);
    
    // Release the memory
    pds_nivector_destroy(&Input);
    pds_neuron_destroy(&Neuron);
    
    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 -lpdssn -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 -lpdssn

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 libpdssn`

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

4 Versión

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

pkg-config --modversion libpdssn