wiki:Documentation/UserGuide/XIOSinConfig

Version 4 (modified by jgipsl, 5 years ago) (diff)

--

Activate XIOS in configuration ORCHIDEE_trunk using libIGCM

Since rev [3109] on the ORCHIDEE/trunk, XIOS is the default in the model and in the ORCHIDEE_OL libIGCM configuration. The default run mode is in attached mode. Use following description to to activate XIOS in an older version or a branch. See below how to activate XIOS in server mode.

Deactivate XIOS and use IOIPSL for output

See here: Documentation/UserGuide/DeactivateXIOS

Running XIOS in server mode or attached mode

XIOS can be used in server mode or in attached mode.

  • Attached mode: only the XIOS library linked in the orchidee executable is used. This is the case that is used to run on single process or on small region.
  • Server mode: the executable for the server XIOS (xios_server.exe) and the executable orchidee(orchidee_ol) should both be launched in multiple program mode. Normally only 1MPI is used for the server and several for the orchidee executable.

Note: Server mode can not be used on a single pixel or when running ORCHIDEE in sequential mode. See below how to change to attached mode.

The choice when running with the libIGCM configuration is done in config.card. The server mode is activated when the component IOS is set in [ListOfComponents] and in [Executable] section in config.card. See here an extract from config.card for the case with server mode activated. No rebuild is needed therefore RebuildFrequency=NONE is possible.

#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, 31MPI)
IOS= (xios_server.exe, xios.x, 1MPI)

...
RebuildFrequency=NONE
...
#D-- IOS -
[IOS]
WriteFrequency=""
Restart= n
RestartDate=
RestartJobName=
RestartPath=

Server mode must be deactivated to run on a single pixel or on a small domain using only 1MIP for orchidee. To deactivate server mode(=running in attached mode), remove IOS from [ListOfComponents] and [Executable] section in config.card. The last section [IOS] can be kept. See here an example of config.card for attached mode:

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

#D-- Executable -
[Executable]
SRF= ("", "")
SBG= ("", "")
OOL= (orchidee_ol, orchidee_ol, 1MPI)

...
RebuildFrequency=NONE
...

Activate XIOS in version older than 3109 or branches

Compile using target with_xios, installation as usual:

svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl
cd modipsl/util
./model ORCHIDEE_trunk
cd ../config/ORCHIDEE_OL
gmake with_xios

Prepare your simulation set up as usual. Choose for example OOL_SEC_STO experiment. Activate XIOS by setting XIOS=y in orchidee_ol.card, IOIPSL output will be deactivated automatically:

cd OOL_SEC_STO
vi COMP/orchidee_ol.card    # Change to XIOS=y

The bounds for the time step changed name from time_counter_bnds to time_counder_bounds. This needs to be changed in sechiba.card. Change time_counter_bnds at 2 places in sechiba.card to have:

GatherWithInternal= (lon, lat, veget, time_counter, time_counter_bounds, Areas, Contfrac)