Changes between Version 151 and Version 152 of Documentation/TrunkFunctionality4


Ignore:
Timestamp:
2024-04-23T15:51:41+02:00 (4 weeks ago)
Author:
jgipsl
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentation/TrunkFunctionality4

    v151 v152  
    1313 
    1414== Fair use policy == 
    15 Before downloading and using the trunk, please, read and adhere to the [https://forge.ipsl.jussieu.fr/orchidee/wiki/GroupActivities/UseOfORCHIDEEpolicy/InternalFair-use-policy '''FAIR USE POLICY'''].  
     15Before downloading and using the trunk, please, read and adhere to the [https://forge.ipsl.fr/orchidee/wiki/GroupActivities/UseOfORCHIDEEpolicy/InternalFair-use-policy '''FAIR USE POLICY'''].  
    1616 
    1717== Warranty == 
    18 ORCHIDEE (milestone 4) comes with a 12 month warranty (starting on March 10th 2020)! This warranty is valid for the head of the trunk if no code changes were made and for the default configurations (analytical spinup, FG1, FG2, FG4 and FG5). The warranty applies to model crashes, ipsl errors and obvious bugs (e.g., spikes, sudden changes on January 1st, crazy values, …). Following the establishment of the problem, you need to extract a 1 pixel or 3x3 pixel test case that reproduces the crash on Obelix. A script to extract the restart files for this kind of restricted test cases can be downloaded from svn ( [https://forge.ipsl.jussieu.fr/orchidee/browser/trunk/TOOLS/Utilitaire/Regrid_restart/extract_restart.pysvn download here]). Once the TRUNK FORCE has received the test case, the first response time is 5 working days (outside the holiday period). If your problem falls outside the warranty we can still give assistance and advice. 
     18ORCHIDEE (milestone 4) comes with a 12 month warranty (starting on March 10th 2020)! This warranty is valid for the head of the trunk if no code changes were made and for the default configurations (analytical spinup, FG1, FG2, FG4 and FG5). The warranty applies to model crashes, ipsl errors and obvious bugs (e.g., spikes, sudden changes on January 1st, crazy values, …). Following the establishment of the problem, you need to extract a 1 pixel or 3x3 pixel test case that reproduces the crash on Obelix. A script to extract the restart files for this kind of restricted test cases can be downloaded from svn ( [https://forge.ipsl.fr/orchidee/browser/trunk/TOOLS/Utilitaire/Regrid_restart/extract_restart.pysvn download here]). Once the TRUNK FORCE has received the test case, the first response time is 5 working days (outside the holiday period). If your problem falls outside the warranty we can still give assistance and advice. 
    1919 
    2020== How do I run the trunk? == 
    … …  
    137137 
    138138=== Bare soil === 
    139 Describes r6783. The flag '''ok_bare_soil_new''' controls how the bare soil is perceived and calculated. If set to FALSE the total bare soil is still calculated veget_max_1 + sum(veget_max_i - veget_i) with i from 2 to the number of PFTs. When a deciduous PFT sheds its leaves, the gaps in the forest will thus contribute to the bare soil fraction in the grid. Although this approach was introduced a long time ago to get acceptable evaporation estimates from forest, the approach also resulted in using the albedo of PFT1 deserts as the background albedo of forest gaps. In ORCHIDEE v2.1 the background albedo has been reparameterized and this issue may have been largely resolved now if '''alb_bg_modis''' = y ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/TrunkFunctionality4#Albedobackgroundr6614 more details]). From many points of view a dynamic bare soil fraction is strange, e.g., bare soil has its own water column so when moving the forest gaps from to forest to PFT1 the soil water content, soil carbon content, litter layer, etc all changes temporary. If '''ok_bare_soil_new''' is set to TRUE, canopy gaps no longer contribute to the bare soil. The new albedo scheme (see Albedo and Background albedo) considers a specific background albedo for each PFT and calculates the albedo of the PFT including the canopy gaps but the calculation of bare soil evaporation underneath a canopy would be problematic. For that reason ok_bare_soil_new is recommended only to be used with the multi-layer energy budget (when run with more than 1 layer). The multi-layer energy budget accounts for within canopy turbulence and can therefore deal with evaporation from beneath a canopy. At present the settings for ok_bare_soil_new are included in the energy_control flag ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/TrunkFunctionality4#Singlevsmultilayerenergybudgetr6614 more details]). The default settings combine the new albedo scheme with the single layer energy budget (enerbil) and '''ok_bare_soil_new''' = n. 
     139Describes r6783. The flag '''ok_bare_soil_new''' controls how the bare soil is perceived and calculated. If set to FALSE the total bare soil is still calculated veget_max_1 + sum(veget_max_i - veget_i) with i from 2 to the number of PFTs. When a deciduous PFT sheds its leaves, the gaps in the forest will thus contribute to the bare soil fraction in the grid. Although this approach was introduced a long time ago to get acceptable evaporation estimates from forest, the approach also resulted in using the albedo of PFT1 deserts as the background albedo of forest gaps. In ORCHIDEE v2.1 the background albedo has been reparameterized and this issue may have been largely resolved now if '''alb_bg_modis''' = y ([https://forge.ipsl.fr/orchidee/wiki/Documentation/TrunkFunctionality4#Albedobackgroundr6614 more details]). From many points of view a dynamic bare soil fraction is strange, e.g., bare soil has its own water column so when moving the forest gaps from to forest to PFT1 the soil water content, soil carbon content, litter layer, etc all changes temporary. If '''ok_bare_soil_new''' is set to TRUE, canopy gaps no longer contribute to the bare soil. The new albedo scheme (see Albedo and Background albedo) considers a specific background albedo for each PFT and calculates the albedo of the PFT including the canopy gaps but the calculation of bare soil evaporation underneath a canopy would be problematic. For that reason ok_bare_soil_new is recommended only to be used with the multi-layer energy budget (when run with more than 1 layer). The multi-layer energy budget accounts for within canopy turbulence and can therefore deal with evaporation from beneath a canopy. At present the settings for ok_bare_soil_new are included in the energy_control flag ([https://forge.ipsl.fr/orchidee/wiki/Documentation/TrunkFunctionality4#Singlevsmultilayerenergybudgetr6614 more details]). The default settings combine the new albedo scheme with the single layer energy budget (enerbil) and '''ok_bare_soil_new''' = n. 
    140140 
    141141=== Bare soil evaporation === 
    … …  
    198198=== Experiments === 
    199199Describes r8017. The model comes with the following well-tested offline experiments found in folder config/ORCHIDEE_OL. Well-tested means that these set up of experiment have been tested on different servers and some of the experiments are part of the trusting:  
    200 * FG_CRUJRA_SPIN: 2x2 degrees CRU-JRA forcing cycles over 1901-1910 between 1901 and 2240 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs, no land cover changes, nitrogen input for 1850, 1860 or 1900 depending on the species, and fixed CO2 concentrations ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/UserGuide/SpinUpCarbon details and context]).  
    201 * FG_CRUJRA_TRANS: 2x2 degrees CRU-JRA forcing cycles over 1901-1910 between 1861 and 1900 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Restart from FG_CRUJRA_SPIN. 15 PFTs, no land cover changes, nitrogen input for 1900, and annual CO2 concentrations. 
    202 * FG_CRUJRA_HIST: 2x2 degrees annual CRU-JRA forcing between 1901 and 2010 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Restart from FG_CRUJRA_TRANS. 15 PFTs, annual land cover changes, annual nitrogen input and annual CO2 concentrations. 
     200* FG_CRUJRA_SPIN: 2x2 degrees CRU-JRA forcing cycles over 1901-1910 between 1901 and 2240 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs, no land cover changes, nitrogen input for 1850, 1860 or 1900 depending on the species, and fixed CO2 concentrations ([https://forge.ipsl.fr/orchidee/wiki/Documentation/UserGuide/SpinUpCarbon details and context]).  
     201* FG_CRUJRA_TRANS: 2x2 degrees CRU-JRA forcing cycles over 1901-1910 between 1861 and 1900 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Restart from FG_CRUJRA_SPIN. 15 PFTs, no land cover changes, nitrogen input for 1900, and annual CO2 concentrations. 
     202* FG_CRUJRA_HIST: 2x2 degrees annual CRU-JRA forcing between 1901 and 2010 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Restart from FG_CRUJRA_TRANS. 15 PFTs, annual land cover changes, annual nitrogen input and annual CO2 concentrations. 
    203203* FR_SAFRAN_SPIN, FR_SAFRAN_TRANS, FR_SAFRAN_HIST: [wiki:Documentation/FrenchConfiguration experiement set up for more detailed studies over France].   
    204 * FG_CRUJRA_SECHIBA_OD_HIST: 2x2 degrees annual CRU-JRA forcing between 1901 and 2010 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs prescribed by reading in a biomass map. Land cover changes, input deposition, CO2 concentrations, and all other biogeochemical and ecological processes are deactivated. This configuration is under development, waiting for a global LAI map (in case of CN-CAN this has become biomass map) to be tested. 
     204* FG_CRUJRA_SECHIBA_OD_HIST: 2x2 degrees annual CRU-JRA forcing between 1901 and 2010 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs prescribed by reading in a biomass map. Land cover changes, input deposition, CO2 concentrations, and all other biogeochemical and ecological processes are deactivated. This configuration is under development, waiting for a global LAI map (in case of CN-CAN this has become biomass map) to be tested. 
    205205 
    206206Experiments that are used but only on specific servers: 
    … …  
    209209 
    210210Experiments that are no longer used or removed: 
    211 * OOL_SEC_STO_FG3 (removed in r8012): 0.5x0.5 degrees annual WFDEI_GPCC forcing between 1979-2009 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs, annual land cover changes, annual nitrogen input and annual CO2 concentrations. 
    212 * OOL_SEC_STO_FG3nd (removed in r8012): 0.5x0.5 degrees annual WFDEI_GPCC forcing between 1979-2013 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs, annual land cover changes, annual nitrogen input and annual CO2 concentrations. 
     211* OOL_SEC_STO_FG3 (removed in r8012): 0.5x0.5 degrees annual WFDEI_GPCC forcing between 1979-2009 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs, annual land cover changes, annual nitrogen input and annual CO2 concentrations. 
     212* OOL_SEC_STO_FG3nd (removed in r8012): 0.5x0.5 degrees annual WFDEI_GPCC forcing between 1979-2013 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 15 PFTs, annual land cover changes, annual nitrogen input and annual CO2 concentrations. 
    213213* FORCESOIL: was restored for ORCHIDEE trunk 3 but was not maintained for ORCHIDEE trunk (see ticket #684). 
    214214* SPINUP_ANALYTIC_FG0(nd): removed in r7671 because better results were obtained by using recruitment for unmanaged forests in the spinup ([https://docs.google.com/document/d/1mw3XIL5X3xVLxtcfzGGNVXKz2T__STZKMggxZvTMU80/edit Read more about the new challenge to spinup a model with stand structure and abrupt mortality.]). SPINUP_ANALYTIC_FG0(nd): 2x2 degrees CRU-JRA forcing cycles over 1901-1910 between 1801 and 1900. Start from scratch. 15 PFTs, no land cover changes, nitrogen input for 1850, 1860 or 1900 depending on the species, and fixed CO2 concentrations. During this pre-spinup each forested PFT is clear cut once. This makes the age structure more heterogeneous. Clear cutting is prescribed according to a map such that the process is reproducible. When FG0 was used, the final files of FG0 were to be used as restart files for FG1.   
    215 * OOL_SEC_STO_FG4 (can be found in svn before tag 4.1 or r7686): ~0.5x0.5 degrees annual CRU-JRA forcing between 1901 and 2010 ([https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 64 PFTs, European forest are defined at the species level with 4 age classes, forests outside of Europe are defined at the MTC level with 1 age class, annual land cover and tree species changes, annual  input deposition, annual CO2 concentrations, annual forest management, and annual litter raking. 
     215* OOL_SEC_STO_FG4 (can be found in svn before tag 4.1 or r7686): ~0.5x0.5 degrees annual CRU-JRA forcing between 1901 and 2010 ([https://forge.ipsl.fr/orchidee/wiki/Documentation/Forcings about the forcing]). Start from scratch. 64 PFTs, European forest are defined at the species level with 4 age classes, forests outside of Europe are defined at the MTC level with 1 age class, annual land cover and tree species changes, annual  input deposition, annual CO2 concentrations, annual forest management, and annual litter raking. 
    216216* OOL_SEC_STO_FG5 (can be found in svn before tag 4.1 or r7686): 1x1 degrees annual IPSL RCP 4.5 forcing between 1911 and 2100. Start from OOL_SEC_STO_FG4. 64 PFTs, no land cover and changes, annual input deposition, annual CO2 concentrations, prescribed species and management changes following annual a stand replacing disturbance, litter raking for 2010. 
    217217 
    … …  
    610610* '''ok_impose_can_structure:''' This flag is for debugging only! It allows developers to use a prescribed canopy structure rather then the structure calculate by ORCHIDEE. The flag activates the sections of code which directly link the energy budget scheme to the the size and LAI profile of the canopy for the respective PFT and age class that is calculated in stomate, for the albedo. If set to TRUE and the multi-layer budget is activated the model takes LAI profile information and canopy level heights from the run.def. If set to FALSE, and the multi-layer energy budget is used the profile information and canopy levels heights comes from the PGap-based processes for calculation of stand profile information in stomate. 
    611611* '''ok_mleb_history_file:''' Flag that controls the writing of an output file with the multi-layer energy simulations (true/false). Note that this is a large file and writing slows down the code. 
    612 * '''ok_bare_soil_new: ''' This flag is described in a separate [https://forge.ipsl.jussieu.fr/orchidee/wiki/Documentation/TrunkFunctionality4#Baresoilr6783 section]. 
     612* '''ok_bare_soil_new: ''' This flag is described in a separate [https://forge.ipsl.fr/orchidee/wiki/Documentation/TrunkFunctionality4#Baresoilr6783 section]. 
    613613 
    614614