= 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
}}}

=== 1.4.1 Exchange IOIPSL for ORCHIDEE-CNP r4512 and later ===
for ORCHIDEE newer than r4512 you need to use a modified version of IOIPSL.
Follow the description here:

[https://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/Branches/ORCHIDEE-MICT-IMBALANCE-P/Compile#After8.4.0rev4057]

=== 1.4.2 Modify IOIPSL for ORCHIDEE-CNP before r4512) ===
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. Compilation of ORCHIDEE-CN-P ==

=== 2.1 compile orchidee ===
==== A: on obelix ====

Compile ORCHIDEE (without XIOS):
{{{
cd ../config/ORCHIDEE_OL
gmake without_xios
}}}

==== 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
}}}


=== 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]
==== information to the configuration of soil hydrology for (sub)tropical regions ====
[https://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/hydrology]

==== use site specific soil characteristics (all setups) ====
[http://forge.ipsl.jussieu.fr/orchidee/wiki/DevelopmentActivities/ORCHIDEE-CNP/Sites]