Changes between Version 114 and Version 115 of DevelopmentActivities/ORCHIDEE-DOFOCO

Timestamp:

2017-06-16T14:33:15+02:00 (7 years ago)

Author:

alanso

Comment:

--

DevelopmentActivities/ORCHIDEE-DOFOCO

@@ -31 +31 @@
 === Background albedo ===
 === Single layer vs multi layer energy budget ===
+
+The 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. This can, however, be done by two different methods that gives the exact same results:
+
+A: use the energy scheme as found in the original enerbil.f90
+
+B: use the multi-layer energy scheme for a single canopy layer. This collapses the multi-layer energy scheme to the original enerbil code, but if you wish to take water stress into account in your simulation, you need to choose this method. 
+
+Several flags exist to control these choices. For simplicity, a flag has been made to automatically control several of the flags related to the multi-layering, called '''multi_layer_control'''.  Multi_layer_control has 4 possibilities
+
+1 – single layer, using the multi layer energy scheme (i.e. choice B above)
+
+2 – multi-layer energy budget
+
+3 – user specific as set in the run.def
+
+4 – single layer, using the original enerbil scheme (i.e. choice A above)
+
+The default setting of  multi_layer_control in ORHIDEE-CN-CAN is 1. This is well tested and save to use. More details of the flags controlling the multi-layer can be found below and within the model code.
+
+The flags controlled by the multi_layer_control are:
+
+'''ok_hydrol_arch:''' 
+Flag that activates the hydraulic architecture routine (true/false). The trunk version of ORCHIDEE (false) uses soil water as a proxy for water stress and applies the stress to Vcmax. When set to true the hydraulic architecture of the vegetation is accounted for to calculate the amount of water that can be transported through the plant given the soil and leaf potential and the conductivities of the roots, wood and leaves. Water supply through the plant is compared against the atmospheric demand for water. If the supply is smaller then the demand, the plant experiences water stress and the stomata will be closed (water stress is now on gs rather than Vcmax). Note that whether stomatal regulation is used or not is controled by a separate flag: ok_gs_feedback.
+'''
+ok_gs_feedback:'''
+Flag that activates water stress on stomata (true/false). This flag is for debugging only! It allows developers to calculate GPP without any water stress. If the model is used in production mode and ok_hydrol_arch is true this flag should be true as well.
+
+'''ok_mleb:'''
+Flag that activates the multilayer energy budget (true/false). The model uses 10 (default) canopy layers to calculate the albedo, transmittance, absorbance and GPP. These canopy layers can be combined with 10 (default) layers below and  9 layers above the canopy to calculate the energy budget (ok_mleb=y). If set to no, this flag will make the model use 10 layers for the canopy albedo, transmittance,  absorbance and GPP and just a single layer for the energy budget. Be aware that if you wish to run with hydraulic architechture ok_mleb needs to be se to true as well. Furthermore, if you  wish to run with the original energy scheme (enerbil), set the layers for mleb to 1.
+
+'''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.
+
+'''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.
+
+The multi_layer_control set these flags in the following manner: 
+
+1 – single layer, using the multi layer energy scheme
+       ok_hydrol_arch = .TRUE.;  
+       ok_gs_feedback = .TRUE.; 
+       ok_mleb = .TRUE.; 
+       ok_impose_can_structure = .TRUE.; 
+       ok_mleb_history_file = .FALSE.
+2 – multi-layer energy budget 
+       ok_hydrol_arch = .TRUE.; 
+       ok_gs_feedback = .TRUE.; 
+       ok_mleb = .TRUE.; 
+       ok_impose_can_structure = .FALSE.; 
+       ok_mleb_history_file = .FALSE.
+3 – user specific as set in the run.def
+       All read from the run.def
+4 – single layer, using the original enerbil scheme
+       ok_hydrol_arch = .FALSE.; 
+       ok_gs_feedback = .FALSE.; 
+       ok_mleb = .FALSE.; 
+       ok_impose_can_structure = .FALSE.; 
+       ok_mleb_history_file = .FALSE.
+
 === Plant water stress ===
 === Dynamic SLA ===