= How to install ORCHIDEE with modipsl and libIGCM for offline use =

Here I describe how to install a version of ORCHIDEE created after the re-organization of driver sources, this means all versions of ORCHIDEE containg the src_driver directory. If the branch or personal version you want to use contains both ORCHIDEE and ORCHIDEE_OL directories, then you can extract using the script '''recup_my_ORCHIDEE'''. Otherwise if you have only ORCHIDEE directory, extract using the script '''model''' as below. The configuration files will then be the latest trunk version.


== For ORCHIDEE/trunk ==
To extract and compile the latest trunk version of ORCHIDEE and configuration files for offline simulations :
{{{
svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_trunk
cd ../modeles/ORCHIDEE/
gmake driver
}}}

== For ORCHIDEE latest tag (1.9.6) ==
To extract and compile the latest tagged version of ORCHIDEE and configuration files for offline simulations :
{{{
svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_TAG
cd ../modeles/ORCHIDEE_OL
gmake orchidee_ol
}}}



== For branche other version on svn ==
If you want another version of ORCHIDEE, before compiling change the version of ORCHIDEE, in this case you will keep the configuration files from the trunk version : 
{{{
svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_trunk
cd ../modeles
rm -fr ORCHIDEE
svn co svn://forge.ipsl.jussieu.fr/orchidee/branches/xxxxxxx/ORCHIDEE ORCHIDEE     # or a copy from a local version of ORCHIDEE
cd ../util ; ./ins_make      # Create makefiles
cd ../modeles/ORCHIDEE
gmake driver
}}}

== For branche or other version on svn : methode 2 ==
Do as method 1 but modifiy the file mod.def to extract a specific version of ORCHIDEE. The file mod.def specifices all componentes to be extracted with the script model for each configuration predefined. Set for exemple mybranch=ORCHIDEE-MICT or mybranch=ORCHIDEE-DOFOCO.

{{{
svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
vi mod.def                  # Edit the line corresponding to extraction of ORCHIDEE sources for target ORCHIDEE_trunk

Change following line :
#-C- ORCHIDEE_trunk  trunk/ORCHIDEE                           HEAD   14 ORCHIDEE         modeles
into, with correct path to your branch or perso directory, HEAD can also be changed to a specific revision number :
#-C- ORCHIDEE_trunk  branches/mybranch/ORCHIDEE               HEAD   14 ORCHIDEE         modeles

./model ORCHIDEE_trunk
cd ../modeles/ORCHIDEE
gmake driver
}}}

== NB! For old branches with fortran code in ORCHIDEE_OL directory ==
''For exemple orchidee_FM''[[BR]][[BR]]

In the trunk and in the newer branches, the directory ORCHIDEE/src_driver contain the source code for the driver. In older versions, these files were stored in ORCHIDEE_OL directory. Therefor for these older branches, you have to extract ORCHIDEE and ORCHIDEE_OL from the branche. For running with libIGCM, we recomande to use the trunk version of the scripts in ORCHIDEE_OL. Extract the trunk/ORCHIDEE_OL and save it in ORCHIDEE_OL.trunk. In mod.def, the lines corresponding to extraction of ORCHIDEE becomes the following : 

{{{
#-C- ORCHIDEE_trunk  branches/MYOLDBRANCHE/ORCHIDEE           HEAD    14 ORCHIDEE           modeles
#-C- ORCHIDEE_trunk  branches/MYOLDBRANCHE/ORCHIDEE_OL        HEAD    14 ORCHIDEE_OL        modeles
#-C- ORCHIDEE_trunk  trunk/ORCHIDEE_OL                        HEAD    14 ORCHIDEE_OL.trunk  config
}}}