diff --git a/user_guide/doc/source/namelists/jules_vegetation.nml.rst b/user_guide/doc/source/namelists/jules_vegetation.nml.rst index d257a40..8a62a37 100644 --- a/user_guide/doc/source/namelists/jules_vegetation.nml.rst +++ b/user_guide/doc/source/namelists/jules_vegetation.nml.rst @@ -650,23 +650,6 @@ This file sets the vegetation options. It contains one namelist called :nml:lst: FALSE Do not use vegetative drag scheme. -.. nml:member:: l_red - - :type: logical - :default: F - - Switch to use the Robust Ecosystem Demography (RED). - This is based on :ref:`Argles, Arthur PK, et al. - (2020)`. - - Only use if any :nml:mem:`l_triffid` = TRUE. - - TRUE - Use the Robust Ecosystem Demography. - - FALSE - Do not use the Robust Ecosystem Demography. - .. nml:member:: l_rsl_scalar :type: logical diff --git a/user_guide/doc/source/namelists/red_params.nml.rst b/user_guide/doc/source/namelists/red_params.nml.rst new file mode 100644 index 0000000..1ee5e3e --- /dev/null +++ b/user_guide/doc/source/namelists/red_params.nml.rst @@ -0,0 +1,121 @@ +``red_params.nml`` +================== + +This file contains a single namelist called :nml:lst:`JULES_RED` that sets parameters relevant to the `Robust Ecosystem Demography submodel (RED version 1.0) `_. +Activate RED using the :nml:mem:`JULES_VEGETATION::l_red` switch in :nml:lst:`JULES_VEGETATION`. + +``JULES_RED`` namelist members +---------------------------------- + +.. nml:namelist:: JULES_RED + +This namelist is used to read PFT parameters that are only needed by the Robust Ecosystem Demography (RED). Values are not used if RED is not selected. + +.. note:: Where a quantity is said to have units of "/360days", this means that it is an amount per 360 days. + +.. nml:group:: Only used when :nml:mem:`JULES_VEGETATION::l_red` = TRUE. + + .. nml:member:: alpha_recrt + + :type: real(npft) + :default: None + + The fraction of PFT carbon assimilate devoted to reproduction. + + + .. nml:member:: crwn_area0 + + :type: real(npft) + :default: None + + The lowest PFT crown area, value corresponds to the mass0 class (m\ :sup:`2`). + + + .. nml:member:: dom_order + + :type: integer(npft) + :default: None + + The value that describes the competitive hierarchy of PFTs competition in + JULES-RED, the higher the value the more dominant: 3 (trees), 2 (shrubs), 1 (grass). + + + .. nml:member:: height0 + + :type: real(npft) + :default: None + + The lowest PFT height, value corresponds to the mass0 class (m). + + + .. nml:member:: lai_bal0 + + :type: real(npft) + :default: None + + The lowest PFT balanced LAI, which corresponds to the mass0 class (m\ :sup:`2`/m\ :sup:`2`). + + + .. nml:member:: mass0 + + :type: real(npft) + :default: None + + The lowest PFT mass class (kg C). + + + .. nml:member:: massi + + :type: real(npft) + :default: None + + The highest PFT mass class (kg C). + + + .. nml:member:: mclass + + :type: integer(npft) + :default: None + + Number of mass classes for each PFT. + + + .. nml:member:: mort_base + + :type: real(npft) + :default: None + + The baseline PFT mortality rate (/360 days). + + + .. nml:member:: phi_a + + :type: real(npft) + :default: 0.50 + + The allometric/power scaling of PFT mass to PFT crown area (`West, G. B., et al 2009 `_). + + + .. nml:member:: phi_g + + :type: real(npft) + :default: 0.75 + + The allometric/power scaling of PFT mass to PFT mass growth rate (`West, G. B., et al., 1997 `_). + + + .. nml:member:: phi_h + + :type: real(npft) + :default: 0.25 + + The allometric/power scaling of PFT mass to PFT height (`Niklas, K. J., et al., 2001 `_). + + + .. nml:member:: phi_l + + :type: real(npft) + :default: 0.25 + + The allometric/power scaling of PFT mass to PFT leaf area index. + diff --git a/user_guide/doc/source/namelists/red_parms.nml.rst b/user_guide/doc/source/namelists/red_parms.nml.rst deleted file mode 100644 index b36c27f..0000000 --- a/user_guide/doc/source/namelists/red_parms.nml.rst +++ /dev/null @@ -1,120 +0,0 @@ - - -This file contains a single namelist called :nml:lst:`JULES_RED` that sets parameters relevant to the Robust Ecosystem Demography submodel (RED version 1.0) `_. -Activate RED in the :nml:mem:`JULES_VEGETATION::l_red. - -``JULES_RED`` namelist members ----------------------------------- - -.. nml:namelist:: RED_PARMS - -This namelist is used to read PFT parameters that are only needed by the Robust Ecosystem Demography (RED). Values are not used if RED is not selected. - -.. note:: Where a quantity is said to have units of "/360days", this means that it is an amount per 360 days. - -.. nml:group:: Only used when :nml:mem:`JULES_VEGETATION::l_red = TRUE - -.. nml:member:: alpha_recrt - - :type: real(npft) - :default: None - - The fraction of PFT carbon assimilate devoted to reproduction. - - -.. nml:member:: crwn_area0 - - :type: real(npft) - :default: None - - The lowest PFT crown area, value corresponds to the mass0 class (m\ :sup:`2`). - - -.. nml:member:: dom_order - - :type: integer(npft) - :default: None - - The value that describes the competitive hierarchy of PFTs competition in - JULES-RED, the higher the value the more dominant: 3 (trees), 2 (shrubs), 1 (grass). - - -.. nml:member:: height0 - - :type: real(npft) - :default: None - - The lowest PFT height, value corresponds to the mass0 class (m). - - -.. nml:member:: lai_bal0 - - :type: real(npft) - :default: None - - The lowest PFT balanced LAI, which corresponds to the mass0 class (m\ :sup:`2`/m\ :sup:`2`). - - -.. nml:member:: mass0 - - :type: real(npft) - :default: None - - The lowest PFT mass class (kg C). - - -.. nml:member:: massi - - :type: real(npft) - :default: None - - The highest PFT mass class (kg C). - - -.. nml:member:: mclass - - :type: integer(npft) - :default: None - - Number of mass classes for each PFT. - - -.. nml:member:: mort_base - - :type: real(npft) - :default: None - - The baseline PFT mortality rate (/360 days). - - -.. nml:member:: phi_a - - :type: real(npft) - :default: 0.50 - - The allometric/power scaling of PFT mass to PFT crown area (West, G. B., et al 2009 `_). - - -.. nml:member:: phi_g - - :type: real(npft) - :default: 0.75 - - The allometric/power scaling of PFT mass to PFT mass growth rate (West, G. B., et al., 1997 `_). - - -.. nml:member:: phi_h - - :type: real(npft) - :default: 0.25 - - The allometric/power scaling of PFT mass to PFT height (Niklas, K. J., et al., 2001 `_). - - -.. nml:member:: phi_l - - :type: real(npft) - :default: 0.25 - - The allometric/power scaling of PFT mass to PFT leaf area index. - diff --git a/user_guide/doc/source/release_notes/JULES7-1.rst b/user_guide/doc/source/release_notes/JULES7-1.rst index a035785..522843f 100644 --- a/user_guide/doc/source/release_notes/JULES7-1.rst +++ b/user_guide/doc/source/release_notes/JULES7-1.rst @@ -18,7 +18,7 @@ General/Technical changes ------------------------- * Added a switch to allow interpretation of times in the model and the driving data as local solar time - see :nml:mem:`JULES_TIME::l_local_solar_time`. (#1327) - * Added a switch :nml:mem:`IMOGEN_RUN_LIST::l_drive_with_global_temps` so that JULES can be driven with global temperatures and climate patterns. (#1322) + * Added a switch ``l_drive_with_global_temps`` so that JULES can be driven with global temperatures and climate patterns. (#1322) * Made Medlyn stomatal conductance, Farquhar C\ :sub:`3` photosynthesis, and thermal acclimation available in the UM. (#1246) * Further work towards allowing layered soil carbon (:nml:mem:`JULES_SOIL_BIOGEOCHEM::l_layeredc` = TRUE ) in the UM. (#1237) * A varying grey tile emissivity has been passed in to JULES - currently only available if selected in LFRic. (#1247)