----
 . '''Documentation Utilisateur''' [[BR]] Date
["DocUtilisateur"]

 ----
 . '''Sommaire''' 
TableOfContents(5)

----
=== Configuration IPSLCM4_v2 ===
La configuration IPSLCM4_v2 est disponible. Elle est gérée sous svn (voir [http://forge.ipsl.jussieu.fr/igcmg/wiki/IPSLCM4_v2_PAR les commentaires] et [http://forge.ipsl.jussieu.fr/igcmg/browser/CONFIG/trunk/IPSLCM4_v2 les sources]) et inclut toutes les dernières modifications de l'environnement et des composantes LMDZ et ORCHIDEE y compris leur parallélisation validées à la date du 18 octobre 2007. Elle est aussi le point de départ de la version suivante IPSLCM5 qui utilise NEMO à la place d'OPA.

###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n1.png
==== Prise en compte des accès aux commandes fcm et alias utile ====
 . /!\ '''''A mettre dans les fichiers d'initialisation .kshrc (ou .cshrc ou .login ou .profile)'''''
 {{{
PATH=$PATH:/home/rech/psl/rpsl035/fcm/bin  # IDRIS only
PATH=$PATH:/home/cont003/p86ipsl/fcm/bin  # MERCURE only
}}}
 Pour simplifier la vie, nous avons utilisé les mêmes astuces/conventions que NEMO. Voir http://www.lodyc.jussieu.fr/NEMO/users/basics/index.html.
 {{{
alias svn_ano='svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl'
}}}


###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n2.png
==== Création répertoire d'expérience ====
 . {{{
$ mkdir MY_EXPER
$ cd MY_EXPER
}}}


###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n3.png
==== Récupération de modipsl (géré sous svn) ====
 . {{{
$ svn_ano
}}}

###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n4.png
==== Récupération de la configuration IPSLCM4_v2 ====
 . {{{
$ cd modipsl/util
$ ./model IPSLCM4_v2
}}}
/!\ Les mots de passe sont demandés lors des premiers accès aux différentes composantes du modèle couplé. Ils sont disponibles sur la page 25 (ou 7 de la version 4/1) du cours [http://igcmg.ipsl.jussieu.fr/ESCI/Cours/Cours-modipsl-2007.pdf accessible en pdf là]

###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n5.png
==== Compilation ====

 . {{{
$ ./ins_make
$ cd ../config/IPSLCM4_v2
$ gmake                  # ORCA2xLMD9671 par défaut 
}}}

===== Changement de résolution =====
 . {{{
$ gmake ORCA2xLMD7245    # pour autre résolution parmi : ORCA2xLMD7245 ORCA2xLMD9671 (défaut) ORCA2xLMD14496 ORCA2xLMD144142
                         # ORCA2xLMD4443 ORCA2xLMD444315 ORCA2xLMD444311 (avec 15 et 11 niveaux verticaux pour LMDZ)
                         # ORCA2lgmxLMD7245 ou ORCA2lgmxLMD9671 (pour dernier glaciaire)
}}}

===== Vérification =====
 . Pour vérifier que les 4 exécutables ont été créés :
 {{{
$ gmake verif
total 64592
-rwxr-xr-x    1 .......  ...      12540559 Jul 25 16:10 create_etat0_limit.e
-rwxr-xr-x    1 .......  ...      26661962 Jul 25 16:10 gcm.e
-rwxr-xr-x    1 .......  ...      10186294 Jul 25 15:02 oasis
-rwxr-xr-x    1 .......  ...      16743038 Jul 25 16:10 opa
}}}
 C'est actuellement fait automatiquement en fin de compilation.

###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n6.png
==== Préparation du job à lancer ====
 . {{{
$ cd EXP00
$ vi config.card      # parametrer JobName (LO1 par défaut), DateBegin, DateEnd, JobNumProcTot (si besoin, 4 par défaut) et vérifier options de Restart
$ ../../../util/ins_job
 ... informations sur le job d'execution et sur les post-traitements installés ...
}}}

===== Redémarrage depuis des résultats IPSLCM4_v1_OASIS3 (anciens scripts) =====

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.

 * Pour utiliser ce config.card.!OldName, il faut faire 
 . {{{
$ cp config.card.OldName config.card
$ vi config.card   # parametrer les restarts
}}}

 * Il faut ensuite OBLIGATOIREMENT paramétrer les options restarts de CHAQUE composantes ATM, OCE ... :
 .{{{
#========================================================================
#D-- ATM -
[ATM]
#
WriteFrequency="1M 1D HF"
# If config_Restarts_OverRule == 'n' all params are read
Restart= y
# Last day of the experience used as restart
RestartDate=1889-12-30
# Define restart simulation name
RestartJobName=2L24
RestartPath=/dmnfs/cont003/p86denv/SORTIES_CPL_IPSL
# Old component name for restart (if empty, use new name)
OldName="Atm"
}}}

 * Dans ce cas, 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
}}}

 * Les restarts de 2L24 (pré-industriel IPCC issu de IPSLCM4_v1) sont disponibles sur l'IDRiS /u/rech/ces/rces452/SORTIES_CPL_IPSL/2L24Mercure (nom d'expérience 2L24Mercure) et au CCRT /dmnfs/cont003/p86denv/SORTIES_CPL_IPSL/2L24 (nom d'expérience 2L24) pour les dates suivantes :
 {{{
1859-12-30 | 1889-12-30 | 2000-12-30 | 2359-12-30 | 2659-12-30 | 2859-12-30
}}}

===== Redémarrage depuis des résultats IPSLCM4_v1 (Oasis 2.4) =====

Il est possible d'utiliser dans le couplé IPSLCM4_v2 un état initial généré par le couplé IPSLCM4_v1 et d'assurer la continuité entre les 2 simulations. 

 * Il faut modifier le fichier start.nc généré par IPSLCM4_v1 en renommant les variables q01, q02, q03, q04 par respectivement les noms donnés dans le fichier traceur.def de LMDZ4 au moyen par exemple de l'outil ncrename. 
 * Il faut également convertir les fichiers restarts du coupleur du format binaire (restarts générés par IPSLCM4_v1) au format NetCDF (restarts nécessaires pour IPSLCM4_v2). Les 2 sous-programmes suivants doivent être compilés (options de compilation en entête des subroutines) et exécutés sur la machine SX :
http://dods.ipsl.jussieu.fr/aclsce/COUPLAGE/fichier_sst.f90 et
http://dods.ipsl.jussieu.fr/aclsce/COUPLAGE/fichier_flx.f90
 * Il faut ensuite reprendre la même méthodologie que pour le redémarrage depuis des résultats IPSLCM4_v1_OASIS3
 * Les restarts de 2L24 (pré-industriel IPCC issu de IPSLCM4_v1) sont disponibles sur l'IDRiS /u/rech/ces/rces452/SORTIES_CPL_IPSL/2L24Mercure (nom d'expérience 2L24Mercure) et au CCRT /dmnfs/cont003/p86denv/SORTIES_CPL_IPSL/2L24 (nom d'expérience 2L24) pour les dates suivantes :
 {{{
1859-12-30 | 1889-12-30 | 2000-12-30 | 2359-12-30 | 2659-12-30 | 2859-12-30
}}}

###############################################
http://dods.ipsl.jussieu.fr/chili/libIGCM_docs/images/n7.png
==== Soumission du job ====
 . {{{
$ qsub Job_JobName
}}}