Changes between Version 3 and Version 4 of Documentation/UserGuide/XIOSinConfig


Ignore:
Timestamp:
2016-05-27T20:08:10+02:00 (8 years ago)
Author:
jgipsl
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentation/UserGuide/XIOSinConfig

    v3 v4  
    11= Activate XIOS in configuration ORCHIDEE_trunk using libIGCM = 
    2  
     2[[PageOutline]] 
    33Since 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.  
    4  
    5 === Activate XIOS in version older than 3109 or branches === 
    6 Compile using target with_xios, installation as usual: 
    7 {{{ 
    8 svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl 
    9 cd modipsl/util 
    10 ./model ORCHIDEE_trunk 
    11 cd ../config/ORCHIDEE_OL 
    12 gmake with_xios 
    13 }}} 
     4=== Deactivate XIOS and use IOIPSL for output === 
     5See here: [wiki:Documentation/UserGuide/DeactivateXIOS] 
    146 
    157 
    16 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: 
     8=== Running XIOS in server mode or attached mode === 
     9XIOS can be used in server mode or in attached mode.  
     10 * 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.  
     11 * 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.  
    1712 
    18 {{{ 
    19 cd OOL_SEC_STO 
    20 vi COMP/orchidee_ol.card    # Change to XIOS=y 
    21 }}} 
     13'''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.  
    2214 
    23  
    24 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: 
    25 {{{ 
    26 GatherWithInternal= (lon, lat, veget, time_counter, time_counter_bounds, Areas, Contfrac) 
    27 }}} 
    28  
    29 === Activate XIOS in server mode === 
    30 Change to run in server mode by activating the IOS component in config.card. Use the config.card.xios_server as example. You can set !RebuildFrequancy=NONE. The config.card should look like follow: 
    31  
     15The 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. 
     16See here an extract from config.card for the case with server mode activated. No rebuild is needed therefore !RebuildFrequency=NONE is possible. 
    3217{{{ 
    3318#D-- ListOfComponents - 
    … …  
    5742}}} 
    5843 
     44Server 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: 
     45{{{ 
     46#D-- ListOfComponents - 
     47[ListOfComponents] 
     48SRF= (sechiba, orchidee) 
     49SBG= (stomate, orchidee) 
     50OOL= (orchidee_ol, orchidee) 
     51 
     52#D-- Executable - 
     53[Executable] 
     54SRF= ("", "") 
     55SBG= ("", "") 
     56OOL= (orchidee_ol, orchidee_ol, 1MPI) 
     57 
     58... 
     59RebuildFrequency=NONE 
     60... 
     61}}} 
    5962 
    6063 
     64 
     65=== Activate XIOS in version older than 3109 or branches === 
     66Compile using target with_xios, installation as usual: 
     67{{{ 
     68svn co http://forge.ipsl.jussieu.fr/igcmg/svn/modipsl/trunk modipsl 
     69cd modipsl/util 
     70./model ORCHIDEE_trunk 
     71cd ../config/ORCHIDEE_OL 
     72gmake with_xios 
     73}}} 
     74 
     75 
     76Prepare 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: 
     77 
     78{{{ 
     79cd OOL_SEC_STO 
     80vi COMP/orchidee_ol.card    # Change to XIOS=y 
     81}}} 
     82 
     83 
     84The 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: 
     85{{{ 
     86GatherWithInternal= (lon, lat, veget, time_counter, time_counter_bounds, Areas, Contfrac) 
     87}}}