wiki:DocScripts

Version 1 (modified by mmaipsl, 13 years ago) (diff)

--

Documentation for ORCHIDEE_OL scripts

When you have installed ORCHIDEE and ORCHIDEE_OL source code for trunk version as described in the [http://dods.ipsl.jussieu.fr/orchidee/Cours-ORCHIDEE-mai2011.pdf course], you will find in "modipsl"/config/ORCHIDEE_OL tree some directories for scripts used to run ORCHIDEE in an off-line mode.

We strongly invite you to read other wiki and pdf documentation in addition of this one :

  1. ModipslBeginner
  2. Documentation for IPSLCM5 current release of IPSL coupled model
  3. libIGCM users and developpers documentation.

Some of those documentations are still in french and deal with the global couple model of IPSL (namly IPSLCM5 for CMIP5 exercise). But ORCHIDEE scripts use the same philosophy for executions, tree of directories, etc...

Other documentations can be found in other page of this wiki site :

Remark : there is a copy of all ORCHIDEE script directories in model/ORCHIDEE_OL. This is for subversion management and it won't work correctly if you use those directories. You must use ones in config/ORCHIDEE_OL.

libIGCM scripts

libIGCM scripts are used as an SRE (Sytem Running Environment). They are used to manipulate input and output files for an executable (or a set of executables in the couple configuration).

  • libIGCM : Set of scripts to launch simulations and posttreat. Modularity and

portability make you jobs work on a lot of machine (super-computer) in the same way.

Basic ORCHIDEE scripts

ORCHIDEE for CMIP5 and trunk (beginning of 2011) has three off-line drivers :

  1. orchidee_ol that use all ORCHIDEE source (dim2_driver, SECHIBA, STOMATE and LPJ) and may run the full ORCHIDEE model or just a part of (juste the driver and SECHIBA with prescibe LAI).
  2. teststomate is the driver to run only STOMATE and LPJ part of the model (daily). It is used to accelerate the SPINUP of the vegetation (but without feedback to the physic : soil temperature, hydrology).
  3. forcesoil is the driver to accelerate the convergence of the soil carbon pools only.

There are four basic directories (configuration) to run ORCHIDEE in a simple mode :

  1. OOL_SEC : used to run orchidee_ol without STOMATE and LPJ (SECHIBA with prescibe LAI).
  2. OOL_SEC_STO : run orchidee_ol with the full ORCHIDEE model.
  3. TESTSTOMATE : run teststomate and only STOMATE and LPJ part of the model
  4. FORCESOIL : run forcesoil to converge the soil carbon pools.

Each of those directories contains :

  • a config.card file to describe the configuration (see JobName, LongName, TagName, CalendarType, ListOfComponents), the experiment specifications (!Restarts and !Post) and informatic parameters (parallelization, WriteFrequency).
  • in COMP directory, you may find "card" and "driver" files for each components list in ListOfComponents section of config.card.

Some important remarks :

  • The type of the calendar (CalendarType) and the dates (DateBegin and DateEnd) are only use by the scripts to get the right input (forcings, maps ...) files, but they are not passed to the model. For ORCHIDEE model, the forcing file must give all informations on the calendar.
  • The options in the cards are always prioritary (????) on those of the parameter files because the driver use those card options to overwrite the parameter value in the last input parameter files in the RUN_DIR directory.

SPINUP job

Spin-up are the algorithms to get the convergence of a part of the surface model. They are used to give correct initial state for historical simulations.

The equilibrium of the physic (SECHIBA) of the land surface should be reach in less than 10 years with a fix climatology and a prescribe LAI. You may take care of the year of the forcing file because Nino or Nina specific year may give bad results for global spin-up.

See page SpinUpJobs? for additionnal informations.

FLUXNET job

ENSEMBLE job