[[PageOutline]] = 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: [[BR]] * Follow the training course given once a year [http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Train] * Read the documentation [http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Doc] In complement to the igcmg_doc documentation, you find in this wiki specific information and help to use ORCHIDEE. [[BR]] ''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 [[BR]] === 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 === ==== [wiki:Scripts/SpinUpJobs SPINUP and SPINUP_ANALYTIC_FG1] ==== Last revision: 2020/02/28, F. Maignan[[BR]] 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 [wiki:Scripts/SpinUpJobs SPINUP]. ==== [wiki:Scripts/Ensemble 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 [wiki:Scripts/FluxnetValidation FluxnetValidation] for a complete documentation on FLUXNET sites validations.