Notes d'administration de nls2C

NLS2C Notes d'administration

Sommaire:

Sur quels systèmes fonctionne nls2C
De quoi a besoin nls2C
Comment installer nls2C
À faire avant l'installation
L'installation par le script INSTALL
Que fait le script INSTALL
Que fait le script configure
Voir aussi install.html (english ).

Sur quels systèmes fonctionne nls2C:

nls2C est configuré pour Unix et Linux.
L'installation sur d'autres systèmes nécessite l'adaptation du script configure.

De quoi a besoin nls2C

nls2C a besoin des librairies de nls2.
C'est une version de nls2 réduite à l'estimation des paramètres, qui, contrairement à celui-ci, fonctionne indépendamment de R et de Splus. Elle se présente comme une série de sous-programmes C; un programme principal d'appel est fourni.

Comment installer nls2C:

nls2C s'installe par un shell-script d'installation: INSTALL.

À faire avant l'installation:

Installer nls2.
Modifier le fichier user/suffixes si le suffixe des fichiers Fortran n'est pas "f", ou celui des fichiers C n'est pas "c".
Si c'est le cas, il faudra aussi changer le suffixe de tous les fichiers du répertoire src

L'installation par le script `INSTALL`:

Les étapes d'installation sont les suivantes:

Décompresser et dé-tarer le tar-archive dans le répertoire d'installation:
```
gunzip nls2C_2003.1.tar.gz
tar xf nls2C_2003.1.tar
```
Un répertoire nommé nls2C est alors créé.
Se positionner dans le répertoire nls2C
Appeler le script INSTALL:
```
./INSTALL <nls2-pathname>
```
<nls2-pathname>: chemin d'accès du répertoire où est installé nls2.

Que fait le script INSTALL:

Par défaut, il réalise toutes les tâches suivantes. Des options supplémentaires à celles exposées ci-dessus permettent à l'administrateur de les restreindre, mais il est supposé que l'ordre logique de leur exécution est respecté. Ces tâches sont les suivantes:

Appeler le script configure afin de modifier les fichiers selon la configuration courante (voir détails)
(option -configure)
Compiler les programmes par exécution du fichier src/Makefile.
Le fichier compilé du programme principal par défaut, main2C.o est placé au niveau supérieur de la hiérarchie, les autres étant placés dans le répertoire lib.
(option -compile)
Compiler les exemples par appel au script examples/crAllEx. Pour chacun des exemples du répertoire examples, ce script appelle user/cr2C qui:
1. si besoin, appelle le programme analDer de nls2 pour créer le programme C qui calcule le modèle à partir de sa description formelle,
2. effectue l'édition de liens avec le programme principal par défaut et les librairies de nls2.
(option -crex)
Créer le répertoire tests et y exécuter les exemples.
L'exécution des exemples est effectuée par le script examples/exAllEx (voir ci-dessous)
(uniquement si l'option -testex est positionée)
Exécuter les exemples dans le répertoire examples
L'exécution des exemples est effectuée par le script examples/exAllEx. Pour chacun des exemples du répertoire examples, ce script appelle examples/ex2C (création et compilation/édition de liens, si nécessaire, du programme de calcul du modèle par appel à user/cr2C, puis exécution avec le fichier d'entrée examples/*.input correspondant à l'exemple.
(option -exex)

Que fait le script configure:

Ce shell-script est appelé par le script INSTALL.

Il modifie les fichiers qui en ont besoin (ceux de suffixe .in) de façon à remplacer des patrons choisis conventionnellement (PATRONDIR et NLS2CDIR) par les chemins d'accès correspondant à l'implantation courante (chemin d'accès à nls2 et chemin d'accès du répertoire courant, c.à.d celui d'installation de nls2C).