= How to install ORCHIDEE without XIOS =

XIOS or IOIPSL can be used to write output files in ORCHIDEE. The default method since revision [3109] in ORCHIDEE trunk is by using XIOS. It is still possible to work without XIOS. IOIPSL is then used for the output instead of XIOS. Note that IOIPSL must be installed in all cases because it is still used for reading/writing of restart files and reading of input files.


2 modifications are needed while using ORCHIDEE without XIOS in offline configuration: 
 * Compile using '''gmake without_xios''' in config/ORCHIDEE_OL directory or compile directly with makeorchidee_fcm without adding -xios in the argument list. XIOS will be installed by modipsl but it'll not be compiled.
 * Run with '''XIOS_ORCHIDEE_OK=n''' in run.def. If using the libIGCM configuration ORCHIDEE_OL, set instead XIOS=n in COMP/orchidee_ol.card.

The configuration LMDZOR_v6 is not prepared to be used without XIOS.

== Example of installing the trunk without XIOS ==

==== Install and compile ====
{{{
svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_trunk
cd ../config/ORCHIDEE_OL
gmake without_xios
}}}

==== Run ====
The flag '''XIOS_ORCHIDEE_OK=n''' must be set to run without XIOS. This is done directly in run.def or in '''orchidee_ol.card''' by setting :
{{{
# Use XIOS as output library instead of IOIPSL
XIOS=n
}}}



The bounds for the time step has the name time_counter_bnds with IOIPSL and time_counder_bounds with XIOS. Therefore it is needed to change this in sechiba.card. Change time_counter_bounds at 2 places in '''sechiba.card''' to have:
{{{
GatherWithInternal= (lon, lat, veget, time_counter, time_counter_bnds, Areas, Contfrac)
}}}

'''The server mode must be deactivated from config.card.''' This is done by removing or comment IOS in the [!ListOfComponents] and [Executable] section in config.card. Following should be set :

{{{
#D-- ListOfComponents -
[ListOfComponents]
SRF= (sechiba, orchidee)
SBG= (stomate, orchidee)
OOL= (orchidee_ol, orchidee)
#IOS= (xios, XIOS)

#D-- Executable -
[Executable]
SRF= ("", "")
SBG= ("", "")
OOL= (orchidee_ol, orchidee_ol, 32MPI)
#IOS= (xios_server.exe, xios.x, 1MPI)
}}}

== How to use an old branch ==
If your branch do not contain interface to XIOS, then you have to compile and run without XIOS as described above. If you use an experiment in a recent version of config/ORCHIDEE_OL (OOL_SEC_STO, OOL_SEC or SPINUP_ANALYTIC), then you'll also have to remove the copy of the *.xml files as they do not exist. Remove the corresponding lines from COMP/orchidee_ol.card; change following:
{{{
[ParametersFiles]
List=   (${SUBMIT_DIR}/PARAM/run.def, .) ,\
        (${SUBMIT_DIR}/PARAM/iodef.xml, .)   ,\
        (${MODIPSL}/modeles/ORCHIDEE/src_xml/file_def_orchidee.xml, .)  ,\
        (${MODIPSL}/modeles/ORCHIDEE/src_xml/context_orchidee.xml, .)   ,\
        (${MODIPSL}/modeles/ORCHIDEE/src_xml/field_def_orchidee.xml, .)
}}}

into 
{{{
[ParametersFiles]
List=   (${SUBMIT_DIR}/PARAM/run.def, .) ,\
        (${SUBMIT_DIR}/PARAM/iodef.xml, .)
}}}