Changes between Version 9 and Version 10 of Doc/Models/ORCHIDEE


Ignore:
Timestamp:
10/12/15 12:46:54 (9 years ago)
Author:
jgipsl
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Doc/Models/ORCHIDEE

    v9 v10  
    1313 
    1414 
    15 The ORCHIDEE model includes 3 components: sechiba, stomate and LPJ (dynamic vegetation). Only the 2 components sechiba and stomate are activated by default. If you are using a coupled configuration with LMDZ, you will need the sechiba component to compute the water and energy balance. You will also need the stomate component to compute the carbon balance but this component can be deactivated. You will find additional information on how to use ORCHIDEE in libIGCM-supported configurations below.  
     15The ORCHIDEE model includes 3 components: sechiba, stomate and LPJ (dynamic vegetation). Only the 2 components sechiba and stomate are activated by default. If you are using a coupled configuration with LMDZ, you will need the sechiba component to compute the water and energy balance. You will also need the stomate component to compute the carbon balance. It is possible to deactivate stomate. You will find additional information on how to use ORCHIDEE in libIGCM-supported configurations below.  
    1616---- 
    1717 
     
    2424 * All platform dependent compile options are set in modeles/ORCHIDEE/arch/ 
    2525 * Changing compile options or adding a new machine is done in modeles/ORCHIDEE/arch 
    26  * 3 different levels of optimization is available and can be changed using an argument to makeorchidee_fcm: -prod(default), -dev or -debug. These options can be changed or added in the main makefile in config/LMDZOR_v5.2 directory. 
     26 * 3 different levels of optimization are available and can be changed using an argument to makeorchidee_fcm: -prod(default), -dev or -debug. These options can be changed or added in the main makefile in modipsl/config/YOUR_CONFIG/ directory. 
    2727 
    2828 
     
    3636 
    3737## Choice of hydrology scheme ##  
    38 2 hydrology scheme are implemented in ORCHIDEE. An old 2 bucket scheme called Choisnel and a newer multilayer scheme called CWRR. In _v5 configurations only the 2-bucket Choisnel scheme could be used. In newer version in offline and _v6 configurations can choose between the two scheme. Choose the hydrology in the configuration 
    39  * _v5 and _v6 configurations by setting !DefSuffix=CWRR or !DefSuffix=Choi in the section [!UserChoices] in orchidee.card. The variable !DefSuffix will be used to copy the corresponding orchidee.def file from PARAM directory, see the line :  
     382 hydrology schemes are implemented in ORCHIDEE. An old 2 bucket scheme called Choisnel and a newer multilayer scheme called CWRR. In _v5 configurations only the 2-bucket Choisnel scheme can be used. In the _v6 configurations or newer offline versions the choice between the two schemes can be done. Choose the hydrology scheme in the following way :  
     39 * in _v5 and _v6 configurations by setting !DefSuffix=CWRR or !DefSuffix=Choi in the section [!UserChoices] in orchidee.card. The variable !DefSuffix will be used to copy the corresponding orchidee.def file from PARAM directory, see the line :  
    4040{{{ 
    4141[ParametersFiles] 
     
    4343}}} 
    4444 
    45  * ORCHIDEE_OL offline configuration by setting NEWHYDROL=y for CWRR and NEWHYDROL=n for Choisnel in sechiba.card. This variable will change the value for HYDROL_CWRR in the parameter file run.def.  
     45 * in ORCHIDEE_trunk offline configuration by setting NEWHYDROL=y for CWRR and NEWHYDROL=n for Choisnel in sechiba.card. This variable will change the value for HYDROL_CWRR in the parameter file run.def.  
    4646 
    4747 
     
    7474 
    7575 
     76## Managing output in _v6 configurations and ORCHIDEE_trunk using XIOS ## 
     77XIOS is used by default in v6 configurations. In ORCHIDEE_trunk it is possible to activate XIOS output. To do so you need first to compile with XIOS. This is done using '''gmake with_xios''' in modipsl/config/ORCHIDEE_OL directory. Before running activate XIOS in orchidee_ol.card by setting XIOS=y. This is the default and only behaviour in coupeld _v6 configurations. 
    7678 
    77   
     79The output levels in ORCHIDEE are controlled by the xml files that have to be present during run time. Following files are needed : iodef.xml, context_orchidee.xml, field_def_orchidee.xml and file_def_orchidee.xml. They are stored in the model directory ORCHIDEE/src_xml and in the configuration directory PARAM/. You can see the copy of these files and where they are stored in the orchidee.card or orchidee_ol.card. file_def_orchidee.xml contains a description of predefined files and their variable content. All variables modified by the configuration are marked with _AUTO_. These variables can be changed directly in the file if you want. Otherwise the values set in config.card and/or comp.card will be used. In config.card the choice of output file and frequency is done using the !WriteFrequency option in section [SRF] and [SBG] : 
     80   * '''[SRF]''' : The first frequency corresponds to the output frequency for the sechiba_history.nc file. The available frequencies are: xY, xM, 5D, 1D and xs, where x is an integer and s means seconds. This file is required. If you add HF, a second sechiba_out_2.nc file will be written with the 3H frequency.  
     81   * '''[SBG]''' : Only one frequency (xY, xM, 5D, 1D or xs) can be specified. The same frequency is applied to both the stomate_history.nc and stomate_ipcc_history.nc files.  
     82 
     83Read more in chapter [wiki:DocEsetup#TheATM...sectionsofthemodelcomponents Setup] about !WriteFrequency.[[BR]] 
     84Read more on the ORCHIDEE wiki about how XIOS is implemented and used in ORCHIDEE : https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/UserGuide#Historyoutputfiles 
     85 
     86The easiest way to personalise the output is to modify directly in PARAM/file_def_orchidee.xml. You can change the variables marked equal _AUTO_ as you wish. In that case you do not need to change in config.card. You can remove or modify the variables as you need which according to the rules for XIOS.   
     87 
    7888## Managing output in _v5 configurations using IOIPSL ## 
    7989The model output frequency is configured in  
    8090 * config.card 
    81    * The !WriteFrequency variable in the [SRF] section induces a change of the WRITE_STEP variable in orchidee.def. WRITE_STEP determines the output frequency for the sechiba_history.nc file. The available frequencies are: xY (x years), xM (x months), 5D(5 days), 1D (1 day), xs (x seconds). This file is mandatory. If you add HF a second sechiba_out_2.nc file will be written with the 3H frequency.  
    82    * The !WriteFrequency variable in the [SBG] section induces a change of the STOMATE_HIST_DT variable in orchidee.def. STOMATE_HIST_DT determines the output frequency for the stomate_history.nc file. The stomate_history_ipcc.nc file always has daily outputs.  
    83  * orchidee.card 
    84    * sechiba_LEVEL : mandatory variable, no default value, it varies between 0 and 11. The SECHIBA_HISTLEVEL variable is set to sechiba_LEVEL. This variable determines the number of variables written in sechiba_history.nc. 
     91   * The !WriteFrequency variable in the [SRF] section induces a change of the WRITE_STEP variable in orchidee.def. WRITE_STEP determines the output frequency for the sechiba_history.nc file. The available frequencies are: xY (x years), xM (x months), 5D(5 days), 1D (1 day), xs (x seconds). This file is mandatory. If you add HF a second sechiba_out_2.nc file will be written with a 3 hour frequency.  
     92   * The !WriteFrequency variable in the [SBG] section induces a change of the STOMATE_HIST_DT variable in orchidee.def. STOMATE_HIST_DT determines the output frequency for the stomate_history.nc file. The stomate_history_ipcc.nc file has always daily output frequency.  
     93 * orchidee.card (or sechiba.card in offline configuration) 
     94   * sechiba_LEVEL : mandatory variable, no default value, it varies between 0 and 11. This value is used in orchidee.def/run.def to set SECHIBA_HISTLEVEL variable. This variable determines the number of variables written in sechiba_history.nc. 
    8595 * stomate.card 
    86    * stomate_LEVEL : mandatory variable, no default value, it varies between 0 and 10. The STOMATE_HISTLEVEL variable is set to this value. This variable determines the number of variables written in stomate_history.nc. 
     96   * stomate_LEVEL : mandatory variable, no default value, it varies between 0 and 10. This value is used in orchidee.def/run.def to set STOMATE_HISTLEVEL variable. This variable determines the number of variables written in stomate_history.nc. 
    8797 
     98Note that in the _v5 configuration you can not change directly a variable set =_AUTO_ in orchidee.def/run.def. You need to understand how it works through the config.card and comp.card as described above. 
    8899 
    89100# Deactivate stomate in ORCHIDEE #