wiki:Documentation/UserGuide/InstallingORCHIDEEBasic

Version 9 (modified by jgipsl, 7 years ago) (diff)

--

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.

1. 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

2. 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

3. 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

4. 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

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 branch. For running with libIGCM, we recomand 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

Note that the compiling is different:

cd modipsl/modeles/ORCHIDEE_OL
gmake orchidee_ol
gmake teststomate
gmake forcesoil