MODIPSL for beginner

MODIPSL pour les débutants

MODIPSL est l'interface d'accès aux modèles de l'IPSL. Cette page résume ce qu'un nouvel utilisateur de MODIPSL doit connaître.
Cette page veut rassembler les informations pour les nouveaux utilisateurs et pointer vers les pages plus complètes de chaque configuration ou de chaque outil quand nécessaire.
N'hésitez pas à consulter la présentation du cours "modipsl" ppt (ou pdf). Les transparents 24 à 48 reprennent avec des schémas une grande partie des informations qui vous seront données ci-dessous.

• Accès à modipsl
  • Lecture seule (accès anonyme)
  • Mode administrateur
  • Pour en savoir plus sur SVN
• Présentation des répertoires de Modipsl
• Liste des configurations
• Travailler avec une configuration
  • Extraction
  • Compilation
  • Lancement d'une simulation
    • Cas général (description des répertoires COMP et PARAM et du fichier config.card)
    • Cas particuliers :
      • La configuration LMDZ4_OR_v2
      • La configuration LMDZINCA_v2
  • Suivi de la simulation (Monitoring)
  • Post-traitements systématiques (atlas)
• Plus d'informations :
  • Comment connaitre l'état de la simulation en cours?
  • Comment sont rangés les fichiers de sortie?
  • Où est le script de sortie dans tous les cas (normal ou anormal)?
  • Où trouver le journal de sortie?
• Questions/Réponses? :
  • Extraction :
    • Mots de passe
  • Compilation :
    • A qui signaler quand cela ne marche pas?
  • Execution :
    • Comment relancer?
    • Comment poursuivre?
  • Post-traitements :
    • Comment vérifier les post-traitements?
    • Comment relancer les post-traitements seulement?

Extraire modipsl

Lecture seule

svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl

Mode administrateur

svn co svn+ssh://yourlogin@forge.ipsl.jussieu.fr/ipsl/forge/projets/igcmg/svn/modipsl/trunk modipsl

D'autres commandes en bas de cette page : ​http://forge.ipsl.jussieu.fr/igcmg/wiki/WikiStart

Pour en savoir plus sur SVN

• Le site officiel de subversion : ​http://subversion.tigris.org/
• Quelques commandes de base pour SVN : ​http://forge.ipsl.jussieu.fr/inca/wiki/InstSvnInca

Presentation des repertoires

Après avoir extrait Modipsl vous avez un répertoire contenant 7 sous-répertoires :

• bin/
• config/
• doc/
• lib/
• modeles/
• tmp/
• util/

Tous ces répertoires sont vides excepté le répertoire doc/ contenant le texte de la licence CECILL (license sous laquelle sont placés les modèles de l'IPSL) et le répertoire util/ qui contient les scripts nécessaire à une installation complète de n'importe quelle configuration disponible des modèles de l'IPSL.

mod.def         >>>>>> Définition pour chaque configuration de leurs composantes et de leurs tags
model           >>>>>> Extraction des modèles validés disponibles
ins_make        >>>>>> Installation et configuration des Makefiles 
ins_job         >>>>>> Installation et configuration des scripts de lancement

Voir le transparent 26 de la présentation suivante ppt

Liste des configurations

Via modipsl vous pouvez avoir accès à un grand nombre de configurations regroupant différents modèles de l'IPSL. Pour connaître cette liste il vous suffit dans le répertoire util/ de passer la commande suivante :

cd modipsl/util
./model -h 

Pour avoir plus d'informations sur une configuration en particulier (modèles utilisés, versions CVS ou SVN utilisées ...) il vous suffit d'ouvrir le fichier modipsl/util/mod.def
Exemple avec LMDZ4OR_v2 :
Dans mod.def faites une recherche sur le nom de la configuration qui vous interesse (ici LMDZ4OR_v2), vous trouvez les lignes suivantes :

#-H- LMDZ4OR_v2  LMDZ4OR_v2 configuration with parallel LMDZ4 and ORCHIDEE
#-H- LMDZ4OR_v2  working configuration
#-H- LMDZ4OR_v2  Official beta release
#-H- LMDZ4OR_v2  IOIPSL/src svn tags/v2_1_1
#-H- LMDZ4OR_v2  LMDZ4 tag LMDZ4_V3_1
#-H- LMDZ4OR_v2  ORCHIDEE tag orchidee_1_9_1
#-H- LMDZ4OR_v2  LMDZ4OR_v2 svn trunk
#-H- LMDZ4OR_v2  libIGCM HEAD
#-M- LMDZ4OR_v2  Abderrahmane.Idelkadi@lmd.jussieu.fr
#-C- LMDZ4OR_v2  IOIPSL/tags/v2_1_1/src HEAD 8 IOIPSL/src modeles
#-C- LMDZ4OR_v2  ORCHIDEE               orchidee_1_9_1 2 . modeles
#-C- LMDZ4OR_v2  LMDZ4                  LMDZ4_V3_1     3 . modeles
#-C- LMDZ4OR_v2  CONFIG/trunk/LMDZ4OR_v2 HEAD 8 LMDZ4OR_v2 config
#-C- LMDZ4OR_v2  libIGCM                ?              1 . .

• les lignes pré-fixées #-H- sont des informations générales
• la ligne pré-fixée #-M- vous indique l'email du responsable de cette configuration
• les lignes pré-fixées #-C- sont les commandes pour extraires dans les archives CVS et SVN les codes

Travailler avec une configuration

Dans ce paragraphe nous prendrons comme exemple le modèle couplé IPSLCM4_v2. Les autres configurations utilisant le nouveau modipsl (IPSL_ESM_V1, LMDZ4OR_v2, LMDZINCA_v2, LMDZORINCA) suivent le même principe. Quand des cas particuliers existent nous vous les indiquerons.

Extraction

cd modipsl/util
./model -h               >>>> indique toutes les configurations dispo
./model IPSLCM4_v2       >>>> on choisi d'extraire la configuration IPSLCM4_v2

Lors de cette extraction plusieurs logins et mots de passe vous seront demandés. Pour les récupérer adressez vous au responsable de la configuration (voir ci-dessus)
Cette commande récupère sur CVS et/ou SVN les différents modèles composant la configuration demandée. Les sources de ces modèles sont installées dans le répertoire modipsl/modeles/. Pour notre exemple vous obtenez les répertoires suivants :

• modipsl/modeles/IOIPSL/
• modipsl/modeles/LMDZ4/
• modipsl/modeles/OPA/
• modipsl/modeles/ORCHIDEE/
• modipsl/modeles/UTIL/

Modipsl installe également ce que l'on appelle une configuration. Elle est dans le répertoire modipsl/config/ (ici modipsl/config/IPSLCM4_v2/).
Cette configuration vous permettra de compiler l'ensemble des modèles, puis de lancer une simulation.

Compilation

Avant la première compilation des différents modèles de votre configuration vous devez créer les makefiles adaptés à la machine sur laquelle vous travaillez.

cd modipsl/util
./ins_make

Lancer une simulation