
===================================================================
I. What this tutorial does and not
===================================================================

This tutorial can only be used on jean-zay computer at idris so far.
    However, extension to ciclad or curie will be done soon.

It proposes a light automatic setup of LMDZ long chained climate simulations
   including intstallation of the model itself.

It consists in running LMDZ coupled to Orchidee for land surface (optional)
   but with imposed sea surface temperature.

The basic default configuration makes use of the IPSL-CM6A grid configuration
   and tuning and runs a multi annual simulation on "climatological"
   amip sea surface temperature (with a mean annual cycle) using
   a calendar with 360 days.

Optionally : the configuration includes the ability to use interannually
   varying SST and to activate "nudgning" by reanalysis.
   In both cases, the calendar is then a real one.
   When nudging is activated, the simulation must be run on a monthly
   bases while otherwise, it can be either monthly or yearly.

Since the tutorial automatically generates its own initial file, it
   can be run with zoom configurations by juste changing the number
   of grid points and the DEF/gcm.def file (see bellow).

As for radiative forcing, aerosols can be read for the decade 2000 
  and forcing with respect to 1850 can be computed as well.



===================================================================
II. Files and scripts
===================================================================
----------------------------------------------------------------
CAREFUL: these scripts MUST be run from arch:
untar the tutorial.tar file in /arch/home/rech/$groupe/$login/
rename the TESTADA directory if you want to;
then run everything from this newly created directory
----------------------------------------------------------------

main.sh : a scrip written to pass options to the main script setup.sh

setup.sh : seting up one simulation editing the "job" script_SIMU
    When run with -init 1 options, creates INIT and LIMIT directories
    Run ./setup.sh -h   for options

script_SIMU : script for the simulations
    Automatically edited by setup.sh

reb.sh : to rebuild splitted outputfiles (parallelism with IOISPL)
    automatically run by script_SIMU

era2gcm.sh : to interpollate reanalysis onto the GCM grid. For nudging
   to be run manually after the first use of setup.sh

season.sh : computing seasonal means and dayly time series

interp_aerosols.sh : interpolating aerosols on the GCM grid.
    Automatically run by setup.sh

post_season.sh : post processing a series of simulations with season.sh

DEF: .def files for simulations


============================================================
III. Known problems
============================================================

Running zoomed or coarse grid simulations
    May cause problems with routing and aerosols
    Suggesting to put in DEF/config.def
    ok_cdnc=n
    ok_ade=n
    ok_aie=n
    flag_aerosol=0
    and in DEF/orchidee*.def
    RIVER_ROUTING=n : because of this, it is set to n by default
    Be carefull, depending on the version of orchidee used, the job will
       use either DEF/orchidee.def or DEF/orchidee_6.*.def

============================================================
IV. Updates
============================================================

24/03/2020 (FH): corrections for use with AMIP SSTs and monthly freq


============================================================
V. TBD
============================================================

A faire :
faire en sorte que ca fonctionne avec aerosols et avec la derniere version
d'orchidee.
Pour les aerosols, on a besoin de ferret pour l'interpollation.
Pour orchidee, il faut recuperer un fichier.




