||'''[wiki:Documentation Documentation]'''||[wiki:Configurations Configurations]||[wiki:Tags Main Version]||[wiki:Branches Other Versions]||[wiki:Evaluation Evaluation]||[wiki:Drivers Drivers]||[wiki:Reports Reports]||[wiki:Meetings Meetings]||[wiki:Contact Contact]||


= Documentation = 

Here below are some links towards presentations of ORCHIDEE model and related papers of reference.
In a near future, a dynamic documentation will be written based on Doxygen software. 
 * OrchideeDocumentation using Doxygen to prepare the scientific and technical documentation 

 * CMIP5 METAFOR MetaforOrc questions. 

== Main Presentations ==
 * Technical notes from G. Krinner that give the main equations of STOMATE and LPJ components. [http://www.ipsl.jussieu.fr/~ssipsl/doc/note.technique_krinner99.ps note.technique_krinner99.ps][[BR]]
 * A presentation that gives the structure in which ORCHIDEE was coded. [http://dods.ipsl.jussieu.fr/orchidee/WEBORCHIDEE/orchidee.pdf orchidee.pdf]
 * A presentation that gives a brief overview of the processes, structure and inputs/outputs structure of ORCHIDEE [http://dods.ipsl.jussieu.fr/orchidee/WIKI/cours_orchidee_sept2011.pdf cours_orchidee_sept2011.pdf]

== Papers of reference ==
 * Ducoudré, Nathale I., Laval, Katia, et Perrier, Alain (1993). '''SECHIBA, a New Set of Parameterizations of the Hydrologic Exchanges at the Land-Atmosphere Interface within the LMD Atmospheric General Circulation Model.''' Journal of Climate, 6(2), 248--273.[http://journals.ametsoc.org/doi/abs/10.1175/1520-0442%281993%29006%3C0248%3ASANSOP%3E2.0.CO%3B2 link]
 * Polcher, J., Laval, K., Dümenil, L., Lean, J., et Rowntree, P. R. (1996). '''Comparing three land surface schemes used in general circulation models.''' Journal of Hydrology, 180(1-4), 373--394. [http://www.sciencedirect.com/science/article/pii/0022169495028862  link]
 * Ducharne, A., Laval, K., et Polcher, J. (1998). '''Sensitivity of the hydrological cycle to the parametrization of soil hydrology in a GCM.''' Climate Dynamics, 14, 307--327. [http://www.springerlink.com/content/6kcrkqp1vdeu2lm9/ link]
 * Rosnay, P. de et Polcher, J. (1999). '''Modelling root water uptake in a complex land surface scheme coupled to a GCM.''' Hydrol. Earth Syst. Sci., 2(2/3), 239--255. [http://www.hydrol-earth-syst-sci.net/2/239/1998/hess-2-239-1998.html link]
 * Krinner, G., Viovy, N., Noblet-Ducoudre, N. de, Ogee, J., Polcher, J., Friedlingstein, P., Ciais, P., Sitch, S., and Prentice, I. C (2005). '''A dynamic global vegetation model for studies of the coupled atmosphere-biosphere system.''' Global Biogeochem. Cycles, 19, GB1015. [http://europa.agu.org/?view=article&uri=/journals/gb/gb0501/2003GB002199/2003GB002199.xml&t=2005,krinner link]
 * d'Orgeval, T. et Polcher, J. (2008). '''Impacts of precipitation events and land-use changes on West African river discharges during the years 1951--2000.''' Climate Dynamics, 31(2), 249--262. [http://www.springerlink.com/content/k221658437u00qj8/ link]


== Documentation for ORCHIDEE_OL scripts ==

When you have installed ORCHIDEE and ORCHIDEE_OL source code for trunk version as
described in the [http://dods.ipsl.jussieu.fr/orchidee/Cours-ORCHIDEE-mai2011.pdf course], 
you will find in "modipsl"/config/ORCHIDEE_OL tree some directories for
scripts used to run ORCHIDEE in an off-line mode. 

We strongly invite you to read other wiki and pdf documentation in addition of this
one :
 1. [http://forge.ipsl.jussieu.fr/igcmg/wiki/ModipslBeginner ModipslBeginner]
 1. [http://forge.ipsl.jussieu.fr/igcmg/wiki/igcmg/Documentation Documentation for IPSLCM5 current release of IPSL coupled model] 
    gives a lot of links on other documentations. 
 1. [http://forge.ipsl.jussieu.fr/libigcm libIGCM] users and developpers documentation.
Some of those documentations are still in french and deal with the global couple
model of IPSL (namly IPSLCM5 for CMIP5 exercise). But ORCHIDEE scripts use the same
philosophy for executions, tree of directories, etc...

Remark : there is a copy of all ORCHIDEE script directories in model/ORCHIDEE_OL.
This is for subversion management and it won't work correctly if you use those
directories. You must use ones in config/ORCHIDEE_OL.

== libIGCM scripts ==

libIGCM scripts are used as an SRE (Sytem Running Environment). They are used to
manipulate input and output files for an executable (or a set of executables in the
couple configuration).
• libIGCM : Set of scripts to launch simulations and posttreat. Modularity and
portability make you jobs work on a lot of machine (super-computer) in the same way. 
• Include a master job and a lot of auxilary jobs for post-treatements.
• Documentation : http://forge.ipsl.jussieu.fr/libigcm