##
Documentation de la bibliothèque MED-fichier V2.2 : Installer

Sommaire de la rubrique

- Description des livrables
- Pré-requis necessaires à l'installation
- Plates-formes
- Lancement de l'installation
- Mise à jour de l'environnement de compilation

## Description des livrables

Les livrables logiciels sont :

1. les sources :
   - De la bibliothèque,
   - Des programmes de test,
   - Des utilitaires associés à la bibliothèque.
2. Une procédure d'installation définie à partir des utilitaires "auto-conf" et "auto-make".
3. La documentation utilisateur au format HTML.

## Pré-requis nécessaire à l'installation

Avant d'installer la bibliothèque MED-fichier, il faut disposer d'un accès à une version compilée de la bibliothèque HDF V5. Pour MED-fichier V2.2, il s'agit de HDF V5-1.6.4 (version recommandée).

## Plates-formes

MED-fichier V2.2.3 a été développée et validée sous :

    Plate-forme
    INTEL-LINUX 32 bits
    INTEL-LINUX 64 bits (opteron)
    SUN-SOLARIS
    COMPAQ-OSF 1

## Lancement de l'installation

Pour désarchiver le fichier contenant les sources taper :

    gunzip med_fichier2.2.3.src.tar.gz
    tar xvf med_fichier2.2.3.src.tar

Vous trouverez dans le répertoire obtenu, l'ensemble des livrables. La procédure d'installation permet de compiler et installer :

- La bibliothèque MED-fichier,
- Sa batterie de tests (les tests peuvent également être lancés et validés),
- Ses utilitaires.

Avant de lancer l'installation,il faut au préalable préciser où se trouve la bibliothèque HDF5, pour cela il faut renseigner la variable d'environnement HDF5HOME :

    export HDF5HOME=/local/tools/hdf5-1.6.4

Il faut ensuite se placer dans le répertoire où se trouvent les livrables et lancer l'installation en tapant les commandes :

    ./configure --prefix=/local/tools/med_fichier2.2.3
    make
    make check
    make install

Vous pouvez également consulter le fichier README pour des informations complémentaires.

Dans la commande "configure", le paramètre "--prefix" permet d'indiquer là où installer la bibliothèque. Si l'installation s'effectue correctement, vous trouverez dans le répertoire cible l'arborescence suivante :

    local
    |
    ---tools
        |
        ---med_fichier2.2.3
            |
            --- bin
            |
            --- include
            |
            --- lib

Description :

- Le répertoire bin contient les utilitaires livrés avec la bibliothèque (xmdump, medimport, medconforme) ainsi que les tests unitaires C et FORTRAN.
- Le répertoire include contient les fichiers d'en-tête (notamment med.h et med.hf).
- Le répertoire lib contient la librairie MED-fichier V2.2. compilée.

La commande "make check" permet de lancer et valider les tests.

Pour plus de détails, vous pouvez consultez le fichier README.

## Mise à jour de l'environnement de compilation

Il reste à mettre à jour les variables d'environnement :

- LD_LIBRARY_PATH : pour l'accès aux fichier binaires des librairies dynamiques HDF et MED.
- PATH : pour l'accès aux exécutables des utilitaires MED.

Exemples :

    export LD_LIBRARY_PATH=/local/tools/hdf5-1.6.4/lib:/local/tools/med_fichier2.2.3/lib:${LD_LIBRARY_PATH}
    export PATH=/local/tools/med_fichier2.2.3/bin:${PATH}

L'utilisation de la bibliothèque à l'édition de lien se fait de manière classique. Voici un exemple simple d'un makefile sous LINUX :

    HDFHOME		=	/local/tools/hdf5-1.6.4
    HDFINCLUDE 	=	${HDFHOME}/include
    HDFLIB		= 	${HDFHOME}/lib

    MEDHOME		= 	/local/tools/med_fichier2.2.3
    MEDINCLUDE	=	${MEDHOME}/include
    MEDLIB		= 	${MEDHOME}/lib

    CC 		=	gcc
    CFLAGS		=	-DPCLINUX -I${HDFINCLUDE} -I${MEDINCLUDE} -I./
    LFLAGS		= 	-L${HDFLIB} -L${MEDLIB} -lmed -lhdf5 -lm -lz

    all : main.out

    main.out : main.c
    	${CC} main.c ${CFLAGS} ${LFLAGS} -o main.out

    clean :
    	rm *.out *.o