Author: J. Ghattas
Last revision: 2022/01/17: Added

Simple test case using ORCHIDEE_2_0

In this section you'll see how to set up a test case to run the ORCHIDEE_2_0 tagged version. For this version of the model, you need at least the following files in the run directory (you'll see further below how to get them):

• orchidee_ol : ORCHIDEE executable
• run.def : parameter text file
• forcing_file.nc : climate forcing variables
• PFTmap.nc : vegetation map
• woodharvest.nc : woodharvest map
• soils_param.nc : initialization of soil parameters
• alb_bg.nc : background albedo from Modis
• iodef.xml, context_orchidee.xml, context_input\_orchidee.xml, field_def_orchidee.xml, file_def_orchidee.xml: parameter files for output and input settings using XIOS
• Optional: routing.nc, floodplains.nc, soils_param_usda.nc

Install and compile

Install the model using target ORCHIDEE_2_0 as the following:

svn co http://forge.ipsl.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_2_0
cd ../config/ORCHIDEE_OL
gmake

Prepare input files and launch the model

Set up a simple test case and run in sequential mode without using libIGCM. Create a new directory outside modipsl to run the model and copy or link the ORCHIDEE executable:

mkdir RUN_2_0; cd RUN_2_0
ln -s /pathtoyourinstallation/modipsl/bin/orchidee_ol .

Create the parameter file by saving the following lines into a file named run.def:

TIME_LENGTH=31D
NVM=15
PFT_TO_MTC=1,2,3,4,5,6,7,8,9,10,11,12,13,10,10
LIMIT_WEST = -10.  
LIMIT_EAST =  30.
LIMIT_NORTH = 70.
LIMIT_SOUTH = 30.

Copy xml files from modipsl/models/ORCHIDEE/src_xml directory into the run directory:

cp /pathtoyourinstallation/modipsl/modeles/ORCHIDEE/src_xml/* .
vi file_def_orchidee.xml   # => change all AUTO, see below 

file_def_orchidee.xml describes the output files, frequencies and variable contents. Change all occurences of _AUTO_ according to the comments in the beginning of the file. Using libIGCM, these variables marqued with _AUTO_ are modified by the drivers. We suggest for these exercises to set daily output frequency. You can activate all files. Read more about the xml files in the appendix.

Copy or link the netcdf files from the shared repository IGCM into your run directory. The location of the shared repository IGCM depends on the machine but the content is synchronized between the different repositories. You can use export if your shell is bash (for tcsh shell: replace export by set):

# At Jean-Zay:
export R_IN=/gpfswork/rech/psl/commun/IGCM
# At irene:
export R_IN=/ccc/work/cont003/igcmg/igcmg/IGCM
# At obelix: 
export R_IN=/home/orchideeshare/igcmg/IGCM
# At ciclad/Climserv:
export R_IN=/projsu/igcmg/IGCM

If the shell in the terminal you use is csh or tcsh, change export into set.

ln -s $R_IN/SRF/METEO/CRU-NCEP/v5.3.2/twodeg/cruncep_twodeg_1901.nc forcing_file.nc
ln -s $R_IN/SRF/PFTMAPS/CMIP6/ESA-LUH2v2/historical/15PFT.v1/PFTmap_1901.nc PFTmap.nc
ln -s $R_IN/SRF/WOODHARVEST/LUH2v2/historical/woodharvest_1901.nc woodharvest.nc
ln -s $R_IN/SRF/cartepente2d_15min.nc .
ln -s $R_IN/SRF/SOIL/soils_param.nc .
ln -s $R_IN/SRF/albedo/alb_bg_modisopt_2D_ESA_v2.nc alb_bg.nc
ln -s $R_IN/SRF/reftemp.nc .
ln -s $R_IN/SRF/ROUTING/routing.nc .

You can use ncdump to see what is in the netcdf files. For example:

ncdump -h forcing_file.nc

Now launch the model:

./orchidee_ol      # or ./orchidee_ol > out_exec

When the execution is completed correctly, following log message is found in the output text file out_orchidee_0000:

 END of dim2_driver