Changes between Version 31 and Version 32 of Documentation/TrunkFunctionality4


Ignore:
Timestamp:
2020-04-09T17:32:09+02:00 (4 years ago)
Author:
luyssaert
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/TrunkFunctionality4

    v31 v32  
    1212* Missing functionalities compared to ORCHIDEE-CAN: multi-layer energy budget 
    1313* Coupling: ORCHIDEE 4 has been coupled to LMDz. Given that several key parameters for the coupling have changed: albedo, roughness (through vegetation dynamics), and more landscape heterogeneity when using age classes, it is expected that lots of testing will be required to come to a satisfying results with LMDzOR. 
     14 
     15The label '''restricted use''' implies that if you are interested in setting up a study that heavily relies on this functionality you are requested to contact the developers to discuss beforehand whether your intended use is in conflict with the ongoing work of the developer. If this functionality is not the core of your study, you are free to use it. For example, if you are planning to study global gpp you can use the water stress without any further concern, if you are planning to study the response of a specific PFT to droughts, your study heavily relies on the water stress and so you are requested to contact the developer. In case of doubt contact the ORCHIDEE team.  
     16 
    1417 
    1518== How do I run this version? == 
     
    107110 
    108111 
    109 === Bark beetles (r6614) === 
     112=== Bark beetles ('''restricted use'''; r6614) === 
    110113The bark beetle module was developed such that it interacts with the windthrow module. If you want to activate it use the flag OK_PEST=y in the run.def. To specify which PFT may be affected by bark beetles use BEETLE_PFT_xxx= TRUE where XXX is the pft you interested in. Note that for the moment bark beetles in ORCHIDEE is parameterized only to work with Picea abies. 
    111114 
     
    224227 
    225228 
    226 === Litter raking (r6614) === 
     229=== Litter raking ('''restricted use'''; r6614) === 
    227230Tree litter was collected from the forest and used in the winter in stables instead of straw. In spring the litter and manure was spread on the croplands. This lateral flow of C and N between PFTS in the same pixel can be accounted for in ORCHIDEE trunk 4 by setting '''use_litter_raking''' = y. If litter raking is to be used, the model will search for annual maps. The path of these maps needs to be specified in COMP/stomate.card. Litter raking maps were prepared for Europe. Unless liter raking is your research topic set '''use_litter_raking''' = n. An example of to set up the model to make use of the historical litter raking maps can be found in config/ORCHIDEE_OL/OOL_SEC_STO_FG4 
    228231 
     
    287290 
    288291 
    289 === Plant water stress (r6614) === 
     292=== Plant water stress ('''restricted use'''; r6614) === 
    290293With ORCHIDEE trunk 4 there are two option to calculate waters stress: 
    291294* Same as in ORCHIDEE 3.0 and previous ORCHIDEE trunks, where a soil moisture stress functions limits C assimilation through constraints on the carboxylation capacity. 
     
    310313 
    311314 
    312 === Recruitment (r6614) === 
     315=== Recruitment ('''restricted use'''; r6614) === 
    313316When stands grow old the tree density decreases and under certain conditions the LAI can no longer cover the ground area. When this happens productivity will start to decrease. In nature the decrease in LAI comes with an increase in the amount of light reaching the forest floor which enables seedlings to grow and to restore the LAI. This process is known as recruitment. Note that in managed forest and forest with a lot of stand replacing disturbances (for example, fire) the forest may never reach the stage where the canopy sufficiently opens up to enable recruitment. 
    314317 
     
    341344 
    342345 
    343 === Single layer vs multi layer energy budget (r6614) === 
     346=== Single layer vs multi layer energy budget ('''restricted use'''; r6614) === 
    344347There are still some issues with the multi-layer energy budget, and it is currently only possible to run for one PFT. Thus, we suggest you use the single layer energy budget. In this can, however, be done by two different methods that in theory should give the exact same results: 
    345348A - Use the energy scheme as found in the original enerbil.f90 
     
    350353Energy_control has 5 possible settings: 
    351354* Single layer, using the multi layer energy scheme (i.e. choice B above) 
    352 * Multi-layer energy budget 
     355* Multi-layer energy budget ('''restricted use''') 
    353356* User specific as set in the run.def 
    354357* Single layer, using the original enerbil scheme (i.e. choice A above) 
     
    3563591 - DEFAULT uses the enerbil module in combination with the hydraulic architecture (ok_hydrol_arch and ok_gs_feedback true, while ok_mleb and ok_impose_canopy_structure are set to false). 
    3573602 - option to use enerbil module and original water stress (not hydraulic architecture). 
    358 3 - The energy budget is calculated using the multi-layer energy scheme with a single laye: ok_hydrol_arch, ok_gs_feedback, ok_impose_canopy_structure and ok_mleb all TRUE, but The energy budget is only calculated for a single layer (jnlvls is 1,jnlvls_under is 0,jnlvls_canopy is 1,jnlvls_over is 0). No mleb output, ok_mleb_history_file is set to FALSE. 
    359 4 - multi-layer energy budget: ok_hydrol_arch, ok_gs_feedback and ok_mleb all TRUE. ok_impose_canopy_structure is False, and the energy budget is calculated for multiple layers (jnlvls is 29,jnlvls_under is 10,jnlvls_canopy is 10,jnlvls_over is 9). No mleb output, ok_mleb_history_file is set to  FALSE. 
     3613 - The energy budget is calculated using the multi-layer energy scheme with a single layer: ok_hydrol_arch, ok_gs_feedback, ok_impose_canopy_structure and ok_mleb all TRUE, but The energy budget is only calculated for a single layer (jnlvls is 1,jnlvls_under is 0,jnlvls_canopy is 1,jnlvls_over is 0). No mleb output, ok_mleb_history_file is set to FALSE. 
     3624 - multi-layer energy budget ('''restricted use'''): ok_hydrol_arch, ok_gs_feedback and ok_mleb all TRUE. ok_impose_canopy_structure is False, and the energy budget is calculated for multiple layers (jnlvls is 29,jnlvls_under is 10,jnlvls_canopy is 10,jnlvls_over is 9). No mleb output, ok_mleb_history_file is set to  FALSE. 
    3603635 - user specific: user specific settings for these controls and layers as defined in the run.def by the user. 
    361364 
     
    408411In ORCHIDEE trunk 4 the links between sechiba and stomate have been strengthened compared to previous ORCHIDEE trunks. As in previous versions, stomate makes use of variables calculated in sechiba but in ORCHIDEE trunk 4, sechiba requires information from stomate to work properly. It is possible to prescribe the canopy structure and thus only run sechiba. Set '''lai_map''' = y, the data for a canopy structure map need to come from an ORCHIDEE trunk 4 run with stomate. All the required information is stored in the sechiba restart file to enable restarting the model without stomate. 
    409412 
    410  
    411 === Wind throw (r6614) === 
     413=== Tree ring width ('''restricted use'''; r6721) === 
     414To be completed. 
     415 
     416=== Wind throw ('''restricted use'''; r6614) === 
    412417The calculation of wind storm damage can be activated by setting '''ok_windthrow''' to y in the orchidee.def. This module calculates the critical wind speed of a stand taking stand and soil properties into account. If the stand is managed, the damaged trees are salvaged logged. If the stand is unmanaged the damaged  trees are left on-site to decompose. The default setting for ok_windthrow is n. The damaged fractions of the stands are replanted and moved to the first age class (if more than 1 age class is used).