'''Documentation Utilisateur''' ["DocUtilisateur"]
[[PageOutline(2,Table des matières,inline)]]

----
= Séquence d'installation pour la configuration IPSLCM4_v1_OASIS3 (figé) =

----
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n1.png
== Récupération de modipsl ==
En attendant que les modifications aient été apportées à modipsl, on procède à une récupération classique :
{{{
$ cvs -d :pserver:anonymous@cvs.ipsl.jussieu.fr:/home/ioipsl/CVSROOT checkout modipsl
}}}

----
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n2.png
== Modification du mod.def et récupération de la configuration ==
{{{
$ cd modipsl/util
$ vi mod.def                  # voir commentaires ci-dessous
$ ./model IPSLCM4_v1_OASIS3   # ou ./model ma_configuration_préférée
}}}
 /!\ '''mod.def doit être modifié pour :'''
  * extraire le module IPSLCM4_v1_OASIS3 dans la branche '''CHILI''' et non plus dans la version '''HEAD'''
  * pour cela il faut remplacer [[BR]]
 #-T- IPSLCM4_v1_OASIS3 ioipsl-2-1 orchidee_1_3_1 ? IPSL-CM4_IPCC_branch '''?''' ipsl_cm4_v1_6(...)[[BR]] par[[BR]] #-T- IPSLCM4_v1_OASIS3 ioipsl-2-1 orchidee_1_3_1 ? IPSL-CM4_IPCC_branch '''CHILI''' ipsl_cm4_v1_6(...)

----
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n3.png

== Préparation du Makefile et compilation ==
{{{
$ ./ins_make
$ cd ../config/IPSLCM4_v1_OASIS3       # ou cd ../config/ma_configuration_préférée
$ gmake ORCA2xLMD9671                  # ou la résolution de votre choix
}}}

----
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n4.png
== Préparation du job à lancer ==
Il faut déclarer en variable d'environnement la librairie libIGCM : [[BR]]
  * sur brodie : {{{ export libIGCM=/home/rech/ces/rces452/libIGCM }}} [[BR]]
  * sur mercure : {{{ export libIGCM=/home/p86denv/libIGCM }}} [[BR]]
La libIGCM est pré installée sur les centres de calcul de l'IDRIS et du CCRT.
Voir le paragraphe [#cvs_libIGCM Installation spécifique] si vous souhaitez l'utiliser sur une autre machine, votre station de travail Linux par exemple.
{{{
$ cd ../../util
$ cp ${libIGCM}/AA_job ../config/IPSLCM4_v1_OASIS3/EXP00
$ cp ${libIGCM}/run.card.init ../config/IPSLCM4_v1_OASIS3/EXP00
$ ./ins_script
}}}
/!\ '''Pour la commande ins_script ''' [[BR]] Vous pouvez également donner un nom à votre script avec la commande ./ins_script -n NOM[[BR]]  Dans ce cas il faudra aller modifier la variable '''!JobName''' dans modipsl/config/IPSLCM4_v1_OASIS3/EXP00/config.card
{{{
R_IN=/dmnfs/p86denv/IGCM
}}}
Il est possible (et ça deviendra la norme) d'associer une libIGCM à un modipsl récupéré avec la commande
{{{
cvs_ano co libIGCM
}}}
la libIGCM dans son modipsl (et donc associer une version de sources avec une version des outils de calcul et de post-traitement). Il faut (pour l'instant) installer à la main les jobs :
 * les "#-Q- mamachine" correspondant à la machine à utiliser sont à supprimer. Par exemple la ligne :

{{{
#-Q- sx8brodie #PBS-r MO2SE
}}}
deviendra
{{{
#PBS-r MO2SE
}}}
 * Ceci pour tous les jobs. C'est-à-dire :
  * le AA_job qui devient job_${!JobName} dans le ${SUBMIT_DIR}
  * les AA_atlas_* qui restent dans la racine de libIGCM et deviennent des atlas_*.job
  * les deux jobs de post-traitement AA_mo2se et AA_create_ts qui deviennent respectivement mo2se.job et create_ts.job.

----
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n5.png
== Soumission du job ==
Vérifier le fichier config.card, en particulier !DateBegin, !DateEnd et les options de redémarrage.
{{{
$ cd ../config/IPSLCM4_v1_OASIS3/EXP00
$ qsub Job_LO1    # ou qsub Job_NOM (cf modifs pour ins_script ci-dessus)
}}}
(!) Activer le mode DRYRUN en positionnant à 3 la variable correspondante dans le Job, cad dans le fichier Job_XXX.  

/!\ A noter, la description d'un redémarrage depuis une simulation rangée selon les conventions des anciens scripts est disponible dans le fichier config.card.!OldName Dans ce cas, pour un couplé IPSLCM4_v1_OASIS3, il faut aussi penser à changer les noms de fichiers Restart du Coupleur. Par exemple à l'IDRIS pour un Restart depuis VV20 à la date du 30 12 1949 :
{{{
rhodes : cd $HOMEGAYA/SORTIES_CPL_IPSL/VV20/Cpl/Restart
rhodes : ln -s VV20_flxatmos_19491230.nc VV20_19491230_flxat.nc
rhodes : ln -s VV20_sstocean_19491230.nc VV20_19491230_sstoc.nc
rhodes : ls *19491230*
lrwxr-x---    1 ...      25 Apr 24 12:09 VV20_19491230_flxat.nc -> VV20_flxatmos_19491230.nc
lrwxr-x---    1 ...      25 Apr 24 12:09 VV20_19491230_sstoc.nc -> VV20_sstocean_19491230.nc
-r--r--r--    1 ... 3131248 Apr 15 15:41 VV20_flxatmos_19491230.nc
-r--r--r--    1 ... 1519344 Apr 15 15:41 VV20_sstocean_19491230.nc
}}}