= Ensemble functionnality =

[[PageOutline]]

=> '''Lancement et suivi de simulations couplées d'ensemble par perturbation'''

Il s'agit de lancer ''n'' runs à partir d'une même date de restart mais en appliquant un bruit blanc sur l'une des variables de couplage, au premier pas de temps du run. 
Pour l'exercice décennal de CMPI5, il s'est agit de la SST reçue par NEMO, et donc du restart d'OASIS.

Il doit être également possible de faire des ensembles d'ensembles.

Les différentes simu réalisées sont regroupés dans un répertoire commun : il ne s'agit pas de ''n'' expériences, mais de ''n'' membres d'une seule et unique expérience.

Pour cela, il faut : 

  * Générer les fichiers de restart perturbés => exécutable indépendant / `ensemble.driver` ;
  * Préparer les répertoires de soumission pour les ''n'' membres => `ensemble.driver` / `ensemble.card` ;
  * Modifier de la même façon l'arborescence de sortie => modif dans les scripts libIGCM, run + post-traitement ;
  * Adapter les outils de soumission, suivi, post-traitement, debug, ... et éventuellement en créer de nouveaux.

== Modif des scripts ==

=== Fichiers impactés ===

  * Lecture de la section `[Ensemble]` du `config.card`
  * Modif des variables `$R_SAVE`, `$R_BUFR`, `$R_FIGR` et `$R_DODS`

||   '''Job'''           || '''R_SAVE''' || '''R_BUFR''' || '''R_FIGR''' || '''R_DODS''' ||
|| AA_atlas_LMDZ         ||      X       ||      X       ||      X       ||      X       ||
|| AA_atlas_ORCA_LIM     ||      X       ||      X       ||      X       ||      X       ||
|| AA_atlas_ORCHIDEE     ||      X       ||      X       ||      X       ||      X       ||
|| AA_atlas_PISCES       ||      X       ||      X       ||      X       ||      X       ||
|| AA_clean_month        ||      X       ||      X       ||              ||              ||
|| AA_create_multi_se    ||      X       ||      X       ||              ||      X       ||
|| AA_create_se          ||      X       ||      X       ||              ||      X       ||
|| AA_create_ts          ||      X       ||      X       ||              ||      X       ||
|| AA_monitoring         ||      X       ||      X       ||      X       ||      X       ||
|| AA_pack_debug         ||      X       ||      X       ||              ||              ||
|| AA_pack_output        ||      X       ||      X       ||              ||              ||
|| AA_pack_restart       ||      X       ||      X       ||              ||              ||
|| AA_SE_Checker         ||      X       ||      X       ||              ||      X       ||
|| AA_TimeSeries_Checker ||      X       ||      X       ||              ||      X       ||

'''=> Commit le 18/04/2012 : [658]'''  

Problème de rétro-compatibilité : plante si la section `[Ensemble]` n'est pas trouvée : modif [660] par Sébastien Denvil 

=== To do ===

  * Ajout de la section `[Ensemble]` dans le `config.card` du couplé (et autres ?)

== `ensemble.driver` ==

  * Création d'un répertoire `libIGCM_ens` et d'un `libIGCM_ens.ksh` pour définir les fonctions utilisées dans le driver
    * `IGCM_ensemble_FilesUpdate`
    * `IGCM_ensemble_DirectoryName`
    * `IGCM_ensemble_PerturbFile`

== Outils annexes ==