Here you will find how you can download and launch a job with ORCHIDEE.

== Download a version of ORCHIDEE ==

Follow these steps :

1. Create a new folder, go into it and type in a shell :
{{{
prompt > svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
}}}
2. Then go to '''modipsl/util''' and modify '''mod.def''' (see below)[[BR]]

3. After that do :
{{{
prompt > ./model ORCHIDEE_SVN_EXT
}}}
4. Execute for creating the Makefiles:
{{{
prompt > ./ins_make
}}}
5. Go to :

{{{
prompt > modipsl/modeles/ORCHIDEE_OL
}}}
and compile in the following order : 
{{{
prompt > gmake 
prompt > gmake forcesoil
prompt > gmake testomate
}}}
6. Create your own job (see the presentation of Martial Mancip) :
{{{
prompt > cd  modipsl/config/ORCHIDEE_OL 
}}}
7. Go back to '''modipsl/util''' and execute :

{{{
prompt > ./ins_job
}}}
8. It's done !
 

== Modifying the mod.def file ==

The '''mod.def''' file contains the list of all the servers for the versions of the different components of the IPSL model.(LMDZ,INCA,ORCHIDEE,NEMO...)
Here is the head of '''mod.def''' :

{{{
# Repository informations
#-
#-S- 1 cvs anonymous@cvs.ipsl.jussieu.fr:/home/ioipsl/CVSROOT
#-S- 2 cvs sechiba@cvs.ipsl.jussieu.fr:/home/ssipsl/CVSREP
#-S- 3 cvs lmdzbrowse@cvs.lmd.jussieu.fr:/home/cvsroot
#-S- 4 cvs opa@cvs.ipsl.jussieu.fr:/home/opalod/CVSROOT
#-S- 5 cvs nemo@cvs.ipsl.jussieu.fr:/home/opalod/NEMOCVSROOT
#-S- 6 cvs inca@cvs.ipsl.jussieu.fr:/home/incaipsl/CVSROOT
#-S- 7 svn http://forge.ipsl.jussieu.fr/nemo/svn
#-S- 8 svn http://forge.ipsl.jussieu.fr/igcmg/svn
#-S- 9 svn --username inca http://forge.ipsl.jussieu.fr/inca/svn
#-S- 10 svn http://forge.ipsl.jussieu.fr/libigcm/svn
#-S- 11 svn http://svn.lmd.jussieu.fr/LMDZ
#-S- 12 svn http://forge.ipsl.jussieu.fr/ioserver/svn 
#-S- 13 svn http://forge.ipsl.jussieu.fr/fcm/svn
#-S- 14 svn --username sechiba svn://forge.ipsl.jussieu.fr/orchidee
}}}
This file lists only the official versions. As the externalized version is not in the "official" version,
you have to add the following lines in '''mode.def''' for downloading it :

{{{
#-H- ORCHIDEE_EXT_SVN Modele ORCHIDEE with Externalisation of the parameters
#-H- ORCHIDEE_EXT_SVN ORCHIDEE_EXT with tag ORCHIDEE_1_9_5
#-H- ORCHIDEE_EXT_SVN IOIPSL with tag 2.2.1
#-H- ORCHIDEE_EXT_SVN libIGCM tag libIGCM_v1_9
#-H- ORCHIDEE_EXT_SVN FCM svn version PATCHED/FCM_V1.2
#-M- ORCHIDEE_EXT_SVN Didier.Solyga@lsce.ipsl.fr
#-C- ORCHIDEE_EXT_SVN IOIPSL/tags/v2_2_1/src   HEAD            8  IOIPSL/src      modeles
#-C- ORCHIDEE_EXT_SVN tags/libIGCM_v1_9        HEAD            10 libIGCM         .
#-C- ORCHIDEE_EXT_SVN PATCHED/FCM_V1.2         HEAD            13 tools/FCM/V1.2  .
#-C- ORCHIDEE_EXT_SVN branches/ORCHIDEE_EXT/ORCHIDEE                 ?       14 .
#-C- ORCHIDEE_EXT_SVN branches/ORCHIDEE_EXT/ORCHIDEE_OL              ?       14 .
#-C- ORCHIDEE_EXT_SVN trunk/ORCHIDEE_OL/OOL_SEC_STO  ?       14 config/ORCHIDEE_OL/OOL_SEC_STO .
#-C- ORCHIDEE_EXT_SVN trunk/ORCHIDEE_OL/OOL_SEC      ?       14 . config/ORCHIDEE_OL
#-C- ORCHIDEE_EXT_SVN trunk/ORCHIDEE_OL/FORCESOIL    ?       14 . config/ORCHIDEE_OL
#-C- ORCHIDEE_EXT_SVN trunk/ORCHIDEE_OL/TESTSTOMATE  ?       14 . config/ORCHIDEE_OL
#-C- ORCHIDEE_EXT_SVN trunk/ORCHIDEE_OL/SPINUP       ?       14 . config/ORCHIDEE_OL
#-C- ORCHIDEE_EXT_SVN trunk/ORCHIDEE_OL/FLUXNET      ?       14 . config/ORCHIDEE_OL
}}}

Then do :

{{{
prompt > ./model -h
}}}

It will all the versions you can download. You will see that ORCHIDEE_EXT_SVN is available to install (it was no the case before you modify '''mod.def''').
For this, replace all the :

{{{
ORCHIDEE_EXT_SVN
}}}
by :

{{{
ORCHIDEE_FM or ORCHIDEE-N 
}}}

according the version you want to download. The name doesn't mind, you can choose the name you want. After that, replace  :
{{{
branches/ORCHIDEE_EXT/ORCHIDEE
}}}
exactly by 
{{{
branches/orchidee_FM/ORCHIDEE
}}}
for the forest management model ; or exactly by
{{{
branches/orchidee-N/ORCHIDEE
}}}
for the nitrogen model.  


=== Advice ===

The last point is still valid if you want to download an other version in developpment like Orchidee-FM (forest management) or ORCHIDEE-N (Orchidee with nitrogen cycle).[[BR]]

''' Warning :''' If you can't download a version, that means that the branch of developpment is not readable. Ask a svn administrator in this case.