HOWTO install/compile/run ORCHIDEE-CN-P for offline use with libIGCM.

This howto is based on the information which can be found in the ORCHIDEE wiki regarding the trunk version of ORCHIDEE. Please check the wiki for information regarding the respective commands listed here.

---

---

1. install libIGCM & ORCHIDEE-CN-P

1.1 where to install

You should install the model NOT in the home directory; it is even too small to handle diagnostics like "out_execution" or "out_orchidee". You can use , for example, your work directory: curie:

/ccc/work/cont003/dsm/<userID>

or project storage; here example for the IMBALANCE-P project on obelix:

/home/surface3/dgoll

1.2 install libIGCM & trunk ORCHIDEE

I use revision 2728 of libIGCM (revision 2961 does not work):

svn -r2728 co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_trunk

1.3 Exchange the trunk ORCHIDEE with ORCHIDEE-CN-P

cd ../modeles
rm -fr ORCHIDEE
svn co svn://forge.ipsl.jussieu.fr/orchidee/branches/ORCHIDEE-CN-P ORCHIDEE
cd ../util ; ./ins_make

---

---

2. Compilation of ORCHIDEE-CN-P

2.1 modify IOIPSL

adjust IOIPSL to be able to write more variables into the output by increase the value of max_var by 50 in ../modeles/IOIPSL/src/restcom.f90

 &  max_var=550, max_file=50, max_dim=NF90_MAX_VAR_DIMS

2.2 compile orchidee

A: on obelix

First do a "normal" make to compile XIOS & IPOSL components which are needed; don't worry if the compilation of ORCHIDEE crashes

cd ../config/ORCHIDEE_OL
gmake without_xios

then compile (do compile always with "-parallel mpi" as this executable can be run in sequential mode, too. But not vice versa)

cd ../../modeles/ORCHIDEE  
./makeorchidee_fcm -driver -arch ifort_LSCE -noxios -parallel mpi

DSG: It might be needed to do it the other way round.

B: on curie

WARNING: before you do anything on curie; make sure you have copied the p86ipsl login environment to your home according to ​https://forge.ipsl.jussieu.fr/igcmg_doc/wiki/DocBenvBtgcc:

cp ~p86ipsl/.bashrc_curie  ~/.
cp ~p86ipsl/.bash_profile ~/.

Then compile the standard way:

cd ../config/ORCHIDEE_OL
gmake without_xios

I usually re-compile ORCHIDEE again with makeorchidee_fcm to set options as I need them to have (don't forget to disable xios).

cd ../../modeles/ORCHIDEE
./makeorchidee_fcm -driver -parallel mpi -arch X64_CURIE -driver -noxios

DEVELOPER INFORMATION 2.3 Re-compile after code modifications

When you re-compile ORCHIDEE after you changed the code, the compiler will only recompile the modules(?)/subroutines(?) which you modified. Sometimes this doesn't work properly and your executable will crash. You will have no indications that the crash is connected to the compilations. Thus, it is a good idea to prophylactically to a full clean before you compile the code: First to this in modeles/ORCHIDEE/:

./makeorchidee_fcm -clean

then this in config/ORCHIDEE_OL

make clean

Now, you can compile the model as described in 2.2

---

---

3. Run ORCHIDEE

3.0 minimal setup (w/o libIGCM)

​http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/howtoMINIMAL

There are different setups possible with libIGCM (​http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/Doc). Please check the documentation of libIGCM for more information, here I just tell you what you need to do.

3.1 SPINUP ANALYTIC

​http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/howtoSPINAL

3.2 FLUXNET

​http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/howtoFLUXNET

3.3 MISC

Missing history files although the run successfully finished

​https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/UserGuide/ReBuild

FLUXNET sites are not all starting

​http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/howtoFLUXNET/errors

activate 11-layer hydrology

​http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/activate11HYDRO

use site specific soil characteristics (all setups)

​http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/Sites