wiki:Documentation/UserGuide/Config

Version 46 (modified by jgipsl, 4 years ago) (diff)

--

  1. Introduction to the ORCHIDEE configurations using libIGCM
    1. Documentation for how to use ORCHIDEE with libIGCM and modipsl
    2. Available configurations defined in modipsl
      1. Offline configurations
      2. Coupled configurations
      3. Specific offline experiments
        1. SPINUP and SPINUP_ANALYTIC_FG1
        2. ENSEMBLE

Introduction to the ORCHIDEE configurations using libIGCM

Last revision: 2020/03/19, J. Ghattas

Documentation for how to use ORCHIDEE with libIGCM and modipsl

ORCHIDEE is distributed using modipsl and scripts for libIGCM are available for running. Theses tools are developped by the Plateforme group at IPSL-CMC. To learn how to use these tools:

In complement to the igcmg_doc documentation, you find in this wiki specific information and help to use ORCHIDEE.

libIGCM is an a System Running Environment and workflow manager. It is used to manipulate input and output files for an executable (or a set of executables in a coupled configuration). libIGCM is a library of scripts to launch simulations and post-treatment. Modularity and portability make your jobs work on a several machines(super-computer center) used at IPSL in the same way. libIGCM include a master job and auxiliary jobs for post-treatements. libIGCM is documented in the Plateforme documentation igcmg_doc mentioned above.

modipsl is used to extract a predefined configuration of a model. The model and needed tools are installed within a local version of modipsl at your account. modipsl is documented in the Plateforme documentation igcmg_doc mentioned above.

Available configurations defined in modipsl

Different predefined configurations in offline or coupled mode can be extracted by modipsl. See in this table, different versions of the source code for ORCHIDEE and there corresponding configurations.

ORCHIDEE version Offline config in modipsl Coupled config in modipsl Compilation Comments
ORCHIDEE trunk since rev 6614 ORCHIDEE_trunk LMDZOR_v6.4_work Script HEAD of version by default
ORCHIDEE_3 (in branches) ORCHIDEE_3 LMDZOR_v6.3_work Script HEAD of version by default
ORCHIDEE_2_2 (in branches) ORCHIDEE_2_2 LMDZOR_v6.2_work, IPSLCM6.2_work, ICOLMDZOR_v7 Makefile or Script Fixed revision which can be changed by contacting the Plateforme groupe.
ORCHIDEE_2_1 (in tags) ORCHIDEE_2_1 None Makefile Obsolete
ORCHIDEE_2_0 (in tags) ORCHIDEE_2_0 LMDZOR_v6.1.11, IPSLCM6.1.11 and all v6.1.x Makefile Fixed revision. Can be changed only when a new v6.1.12 is released. Contact plateforme groupe if needed.

Offline configurations

Read in the Plateforme documentation igcmg_doc about different offline configurations and the experiments they include here: ​http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Doc/Config/ORCHIDEE_OL

Coupled configurations

Read more about coupled configurations in the igcmg_doc documentation chapter Configuration here: ​http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Doc/Config Note that configurations LMDZOR_v6.3 and LMDZOR_v6.4 are new configurations under developpement. They are not yet documented but uses the same method as LMDZOR_v6.2.

Specific offline experiments

SPINUP and SPINUP_ANALYTIC_FG1

Last revision: 2020/02/28, F. Maignan

Spinup of the model is needed to find a stable initial state for historical simulations.

The equilibrium of the physics of the land surface (SECHIBA part of ORCHIDEE) should be reached in less than 10 years with a constant climatology and a prescribed LAI. You may take care of the years of the forcing files because El Niño or La Niña specific years may give bad results for a global spinup.

The equilibrium of the LAI (seasonal variation of the vegetation) takes less than two decades to converge. There is a big feedback between the LAI and the hydrology and energy budgets.

The soil passive carbon pool takes thousands of years to converge, but there is no feedback between the soil carbon pools and the LAI and the hydrology yet.

  • Recommended method: An iterative pseudo-analytical method has been implemented in ORCHIDEE to find the equilibrium for the carbon pools more quickly. The experiment directory SPINUP_ANALYTIC makes use of this method. Using this method, still the living biomass and the hydrology need time to spin up.
  • The previous method to accelerate the spinup used the programmes forcesoil and teststomate. forcesoil was used to accelerate the convergence of the soil carbon pools only and teststomate was accelerating the spinup of the living biomasse. The directory SPINUP is used to spinup with this method. IMPORTANT: SPINUP directory is not maintained. Read more about the method in directory SPINUP.

ENSEMBLE

With this experiment directory, you can change the forcing files and all parameters (by vegetation - PFTs - or not) to build all ENSEMBLE experiments you want with ORCHIDEE model.

For each experiment, this configuration will use the SPINUP configuration as a skeleton to launch a set of jobs.

This ENSEMBLE configuration can be used for setting an ensemble of simulations over different FLUXNET sites. In this case, the vegetation repartition has to be prescribed. It provides a tool to validate ORCHIDEE model on a grid of sites (one point for each simulation) all over the world. It give fast spinup and simulation on a various set of vegetation and climate distributions.

See page FluxnetValidation for a complete documentation on FLUXNET sites validations.