How to run a simple test case with ORCHIDEE

This page describes how to prepare the run directory and run ORCHIDEE interactively. You can also run using a job and launch on the batch system: Documentation/UserGuide/TestCaseBatch.

You need the following files :

• forcing_file.nc (680M)
• PFTmap.nc (13M)
• soils_param.nc (<1M)
• reftemp.nc (<1M)
• run.def
• executable orchidee_ol

Go to your run directory (for example "MYFIRSTTEST/RUN1", "MYFIRSTTEST" being at the same level as "modipsl" directory)

Get the input files :

wget http://dods.ipsl.jussieu.fr/igcmg/IGCM/SRF/METEO/NCC/ncc_for_1982.nc forcing_file.nc
wget http://dods.ipsl.jussieu.fr/igcmg/IGCM/SRF/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_1982.nc PFTmap.nc
wget http://dods.ipsl.jussieu.fr/igcmg/IGCM/SRF/soils_param.nc
wget http://dods.ipsl.jussieu.fr/igcmg/IGCM/SRF/reftemp.nc

Get xml files for running with XIOS:
Note: If you do not compile with XIOS, you do not need to copy these files but you need to adapt run.def to activate output with IOIPSL, see further below.

The xml files controls the output of the model if you use XIOS. XIOS is the default since rev 3115 in the trunk. Copy the files from the "modeles" directory. Here we suppose default compilation with XIOS 1.0 but you should copy the actual iodef*.xml that exists in your revision.

cp ../../modipsl/modeles/ORCHIDEE/src_xml/iodef_xios1.xml iodef.xml
cp ../../modipsl/modeles/ORCHIDEE/src_xml/context_orchidee.xml .
cp ../../modipsl/modeles/ORCHIDEE/src_xml/field_def_orchidee.xml .
cp ../../modipsl/modeles/ORCHIDEE/src_xml/file_def_orchidee.xml .

Edit file_def_orchidee.xml to change every instance of "_AUTO_" (two for each output file)

• enabled="_AUTO_" into enabled=".TRUE." or enabled=".FALSE."
• output_freq="_AUTO_" into output_freq="1mo" or output_freq="1d" par example
• do any other change as you wish to adapt the output to your needs

Edit field_def_orchidee.xml only if you changed the ORCHDEE source code.

Save following lines into run.def :

# Simulation lenght :
TIME_LENGTH= 365D
#TIME_LENGTH=31D

# Parameters for regional run :
# LIMIT_WEST ([Degrees] ) :  Western limit of region    {[-]}
LIMIT_WEST =  -10.
# LIMIT_EAST ([Degrees] ) :  Eastern limit of region    {[-]}
LIMIT_EAST =  0.
# LIMIT_NORTH ([Degrees]) :  Northern limit of region   {[-]}
LIMIT_NORTH =  10.
# LIMIT_SOUTH ([Degrees]) :  Southern limit of region   {[-]}
LIMIT_SOUTH =  0.

# Parameters for global run :
#LIMIT_WEST = -180.
#LIMIT_EAST =  180.
#LIMIT_NORTH =  90.
#LIMIT_SOUTH = -90.

VEGET_YEAR=1

STOMATE_OK_CO2= y
STOMATE_OK_STOMATE= y

If you want to run with IOIPSL for writing output files, then you need to deactivated XIOS and add control variables for IOIPSL in run.def. For example add following:

# Deactivate XIOS
XIOS_ORCHIDEE_OK=n

# Variables for output with IOIPSL :
WRITE_STEP= -1.
SECHIBA_HISTLEVEL= 11
SECHIBA_HISTFILE2= y
SECHIBA_HISTLEVEL2= 1
WRITE_STEP2= 10800.0
STOMATE_HIST_DT= -1.
STOMATE_HISTLEVEL= 10
STOMATE_IPCC_HIST_DT= -1.

Check you environment:
To run the model you first need to load the same netcdf library as the one used for the compilation. This depends on the machine you work at.

For example at obelix, check if you already have loaded netcdf and if yes, unload it and load netcdf/4p as follow:

module list
module unload netcdf
module load netcdf/4p

Once you've get all input files, launch the model in the same directory :

./orchidee_ol > out_orchidee_ol 2>&1

Another way to do it from a run you've already finished with libIGCM is to look at the Script_* output file. Inside this file libIGCM lists all the files that it copies to the run directory (look for the commands where the commands IGCM_sys_Cp and IGCM_sys_Get appear in the Script_* file). If you copy those files manually to a new directory, you should be able to launch the exact same simulation.