Changes between Version 14 and Version 15 of Doc/Models/ORCHIDEE


Ignore:
Timestamp:
10/10/19 17:05:30 (5 years ago)
Author:
jgipsl
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Doc/Models/ORCHIDEE

    v14 v15  
    5454{{{ 
    5555[BoundaryFiles] 
    56 List=  (${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year}.nc, PFTmap.nc) 
     56List=  (${R_IN}/SRF/PFTMAPS/CMIP5/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year}.nc, PFTmap.nc) 
    5757}}} 
    5858 
     
    6464{{{ 
    6565[SmoothFiles] 
    66 List=(${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year_p1}.nc, PFTmap.nc, 12:12:) 
     66List=(${R_IN}/SRF/PFTMAPS/CMIP5/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year_p1}.nc, PFTmap.nc, 12:12:) 
    6767}}} 
    6868   * With yearly period length, note for this case you can not have PFTmap.nc also in the [!InitialStateFiles] section: 
    6969{{{ 
    7070[BoundaryFiles] 
    71 List=  (${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year_p1}.nc, PFTmap.nc) 
     71List=  (${R_IN}/SRF/PFTMAPS/CMIP5/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year_p1}.nc, PFTmap.nc) 
    7272}}} 
    7373 
    7474 
    7575## Manage output in _v6 configurations and ORCHIDEE_trunk using XIOS ## 
    76 XIOS 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 coupled _v6 configurations. 
     76XIOS is used by default in v6 configurations.  
    7777 
    78 The 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] : 
    79    * '''[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.  
    80    * '''[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.  
     78The output levels in ORCHIDEE are controlled by the xml files that have to be present during run time. All files in folder modipsl/modeles/ORCHIDEE/src_xml are needed. Following files are needed : iodef.xml, context_orchidee.xml, field_def_orchidee.xml and file_def_orchidee.xml. Depending on the version, the files context_input_orchidee.xml or field_def_input_orchidee.def is also needed. 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.  
    8179 
    82 Read more in chapter [wiki:DocEsetup#TheATM...sectionsofthemodelcomponents Setup] about !WriteFrequency.[[BR]] 
    83 Read more on the ORCHIDEE wiki about how XIOS is implemented and used in ORCHIDEE : https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/UserGuide#Historyoutputfiles 
     80In orchidee.card (sechiba.card in offline) and in stomate.card, each predefined output file can be activated or deactivated, the output level and the output frequency can be set.  
     81For each predefined file, output_level and output_freq are set as follow (filename is the true name of the file, it can not be changed): 
     82{{{ 
     83output_level_filename=[0-12, NONE]              : the number of variables written to the file, where  
     84                                                  0 is the lowest level writing only variables needed for the monitoring 
     85                                                  12 is the highest level 
     86                                                  NONE deactivates the file.  
     87output_freq_filename=[1y, 1mo, 1d, 10800s, 1ts] : the write frequency of the variables 
     88}}} 
     89For example 
     90{{{ 
     91output_level_sechiba_history = 2 
     92output_freq_sechiba_history = 1mo 
     93}}} 
    8494 
    85 The 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.   
     95See also comments in the corresponding comp.card. 
     96Read more on the ORCHIDEE wiki about how XIOS is implemented and used in ORCHIDEE : https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/UserGuide 
     97 
     98To personalise the output, modify directly in modeles/ORCHIDEE/src_xml/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 according to the rules for XIOS.   
    8699 
    87100## Manage output in _v5 configurations using IOIPSL ##