From 38e2a64a861f8b109f38f54de032950ea398d34d Mon Sep 17 00:00:00 2001 From: Ramzi Kutteh Date: Mon, 20 May 2024 21:34:48 +1000 Subject: [PATCH 1/2] Update content of pft_params.nml options under User Guide --- .../docs/user_guide/inputs/pft_params_nml.md | 218 +++++++++++++----- 1 file changed, 157 insertions(+), 61 deletions(-) diff --git a/documentation/docs/user_guide/inputs/pft_params_nml.md b/documentation/docs/user_guide/inputs/pft_params_nml.md index b95773bc5..08e9d0bfe 100644 --- a/documentation/docs/user_guide/inputs/pft_params_nml.md +++ b/documentation/docs/user_guide/inputs/pft_params_nml.md @@ -1,5 +1,162 @@ # pft_params.nml options +In CABLE the characteristics of the vegetation cover are parametrised and generally remain constant throughout the simulation. These **vegetation parameters** in general vary by **vegetation type**. +CABLE supports tiling of vegetation, i.e. multiple vegetation types with specified area fractions for a single location/grid-cell (also referred to as patches in CABLE). +Altogether CABLE considers the 17 distinct types of vegetation cover listed in Table 1. +Eleven of those are plant functional types (PFT), two are generally unoccupied, and the remaining four are not vegetated. + +## Table 1: CABLE vegetation types + +| Number | Type | +|--------|----------------------| +| 1 | Evergreen Needleleaf | +| 2 | Evergreen Broadleaf | +| 3 | Deciduous Needleleaf | +| 4 | Deciduous Broadleaf | +| 5 | Shrub | +| 6 | C3 Grassland | +| 7 | C4 Grassland | +| 8 | Tundra | +| 9 | C3 Cropland | +| 10 | C4 Cropland | +| 11 | Wetland | +| 12 | empty | +| 13 | empty | +| 14 | Barren | +| 15 | Urban | +| 16 | Lakes | +| 17 | Ice | + +The CABLE vegetation parameters are listed in Table 2 along with their value ranges, units, and descriptions. All parameters in Table 2 are of type real and dimension 17, corresponding to the number of vegetation types in Table 1. +The ranges listed are “physically possible” and mostly correspond to the optional checks in the CABLE offline code. +## Table 2: CABLE vegetation parameters + +| Name (vegin%) | Range | Units | Description | +|-----------------------|------------------|-----------------------------------------------------------------------------------------------------|-------------| +| a1gs | >=0.0 | \( (-) \) | a1 parameter in stomatal conductance model. Represents the sensitivity of stomatal conductance to the assimilation rate | +| alpha | >=0.0 | \( (mol (electrons) \cdot mol^{-1} (photons) (C3) \cdot mol (CO2) \cdot mol^{-1} (photons) (C4)) \) | Initial slope of J-Q response curve | +| canst1 | 0.05 – 0.15 | \( (mm \cdot LAI^{-1}) \) | Maximum intercepted water by canopy | +| cfrd | >=0.0 | \( (-) \) | Ratio of day respiration to vcmax | +| clitt | >=0.0 | \( (tC \cdot ha^{-1}) \) | Leaf litter (alters resistance to soil evaporation) | +| conkc0 | >=0.0 | \( (bar) \) | Michaelis-Menton constant for carboxylase | +| conko0 | >=0.0 | \( (bar) \) | Michaelis-Menton constant for oxygenase | +| convex | >=0.0 | \( (-) \) | Convexity of J-Q response curve | +| cplant1 | >=0.0 | \( (gC \cdot m^{-2}) \) | Plant carbon in 1st vegetation carbon store | +| cplant2 | >=0.0 | \( (gC \cdot m^{-2}) \) | Plant carbon in 2nd vegetation carbon store | +| cplant3 | >=0.0 | \( (gC \cdot m^{-2}) \) | Plant carbon in 3rd vegetation carbon store | +| csoil1 | >=0.0 | \( (gC \cdot m^{-2}) \) | Soil carbon in 1st soil carbon store | +| csoil2 | >=0.0 | \( (gC \cdot m^{-2}) \) | Soil carbon in 2nd soil carbon store | +| d0gs | >=0.0 | \( (kPa) \) | d0 in stomatal conductance model | +| ejmax | 0 – 3.0E-4 | \( (mol \cdot m^{-2} \cdot s^{-1}) \) | Maximum potential electron transp rate top leaf | +| ekc | >=0.0 | \( (J \cdot mol^{-1}) \) | Activation energy for carboxylase | +| eko | >=0.0 | \( (J \cdot mol^{-1}) \) | Activation energy for oxygenase | +| extkn | 0.0 – 10.0 | \( (-) \) | Extinction coeficient for vertical profile of N | +| frac4 | 0.0 – 1.0 | \( (-) \) | Fraction of c4 plants | +| froot1 | 0.0 – 1.0 | \( (-) \) | Fraction of root in soil layer 1 | +| froot2 | 0.0 – 1.0 | \( (-) \) | Fraction of root in soil layer 2 | +| froot3 | 0.0 – 1.0 | \( (-) \) | Fraction of root in soil layer 3 | +| froot4 | 0.0 – 1.0 | \( (-) \) | Fraction of root in soil layer 4 | +| froot5 | 0.0 – 1.0 | \( (-) \) | Fraction of root in soil layer 5 | +| froot6 | 0.0 – 1.0 | \( (-) \) | Fraction of root in soil layer 6 | +| g0 | -0.5 – 0.5 | \( (mol \cdot m^{-2} \cdot s^{-1}) \) | Belinda's stomatal model intercept. Residual stomatal conductance as net assimilation rate reaches zero | +| g1 | 0.0 – 20.0 | \( (kPa) \) | Belinda's stomatal model slope. Sensitivity of stomatal conductance to the assimilation rate | +| gswmin | >=0.0 | \( (mol \cdot m^{-2} \cdot s^{-1}) \) | Minimal stomatal conductance | +| hc | 0.0 – 100.0 | \( (m) \) | Roughness height of canopy (veg - snow) | +| lai | 0.0 – 8.0 | \( (-) or (m^{2} \cdot m^{-2} ) \) | Leaf area index of each plant functional type | +| length | >=0.0 | \( (m) \) | Leaf length | +| ratecp1 | 0.01 – 3.0 | \( (year^{-1}) \) | Plant carbon pool rate constant in 1st vegetation carbon store | +| ratecp2 | 0.01 – 3.0 | \( (year^{-1}) \) | Plant carbon pool rate constant in 2nd vegetation carbon store | +| ratecp3 | 0.01 – 3.0 | \( (year^{-1}) \) | Plant carbon pool rate constant in 3rd vegetation carbon store | +| ratecs1 | 0.01 – 3.0 | \( (year^{-1}) \) | Soil carbon pool rate constant in 1st soil carbon store | +| ratecs2 | 0.01 – 3.0 | \( (year^{-1}) \) | Soil carbon pool rate constant in 2nd soil carbon store | +| refl1 | 0.0 – 0.5 | \( (-) \) | Leaf reflectance in 1st radiation band | +| refl2 | 0.0 – 0.5 | \( (-) \) | Leaf reflectance in 2nd radiation band | +| refl3 | 0.0 – 0.5 | \( (-) \) | Leaf reflectance in 3rd radiation band | +| rootbeta | 0.0 – 1.0 | \( (-) \) | Beta parameter to calculate froot (Jackson et al. 1996) | +| rp20 | 0.0 – 10.0 | \( (-) \) | Plant respiration coefficient at 20 C | +| rpcoef | 0.05 – 1.5 | \( (^{\circ}C^{-1}) \) | Temperature coefficient non-leaf plant respiration | +| rs20 | 0.0 – 10.0 | \( (mol \cdot m^{-2} \cdot s^{-1} ) \) | Soil respiration at 20 C | +| shelrb | 1.0 – 3.0 | \( (-) \) | Sheltering factor | +| taul1 | 0.0 – 0.3 | \( (-) \) | Leaf transmittance in 1st radiation band | +| taul2 | 0.0 – 0.3 | \( (-) \) | Leaf transmittance in 2nd radiation band | +| taul3 | 0.0 – 0.3 | \( (-) \) | Leaf transmittance in 3rd radiation band | +| tmaxvj | -15.0 – 30.0 | \( (^{\circ}C) \) | Maximum temperature of the start of photosynthesis | +| tminvj | -20.0 – 15.0 | \( (^{\circ}C) \) | Minimum temperature of the start of photosynthesis | +| vbeta | -999999 – 999999 | \( (-) \) | Stomatal sensitivity to soil water | +| vcmax | 5.0E-6 – 1.5E-4 | \( ( mol \cdot m^{-2} \cdot s^{-1} ) \) | Maximum RuBP carboxylation rate top leaf | +| vegcf | 0.0 – 100.0 | \( (-) \) | Scaling on soil respiration (place-holder scheme) | +| width | >=0.0 | \( (m) \) | Leaf width | +| xfang | -1.0 – 0.5 | \( (-) \) | Leaf angle | +| zr | >=0.0 | \( (cm) \) | Maximum rooting depth | + + + +The CABLE default values of the vegetation parameters in Table 2 for the vegetation types in Table 1 are listed in Table 3. + +## Table 3: Default vegetation parameter values + +| | Evergreen Needleleaf | Evergreen Broadleaf | Deciduous Needleleaf | Deciduous Broadleaf | Shrub | C3 Grassland | C4 Grassland | Tundra | C3 Cropland | C4 Cropland | Wetland | empty | empty | Barren | Urban | Lakes | Ice | +|----------------|----------------------|---------------------|----------------------|---------------------|-------|--------------|--------------|--------|-------------|-------------|---------|-------|-------|--------|-------|-------|-----| +| a1gs | 9 | 9 | 9 | 9 | 9 | 9 | 4 | 9 | 9 | 4 | 9 | 9 | 9 | 9 | 9 | 9 | 9 | +| alpha | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | 0.05 | 0.2 | 0.2 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | 0.2 | +| canst1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | 0.1 | +| cfrd | 0.015 | 0.015 | 0.015 | 0.015 | 0.015 | 0.025 | 0.015 | 0.015 | 0.025 | 0.015 | 0.015 | 0.015 | 0.015 | 0.015 | 0.015 | 0.015 | 0.015 | +| clitt | 20 | 6 | 10 | 13 | 2 | 2 | 0.3 | 0.3 | 0 | 0 | 2 | 2 | 0 | 0 | 0 | 0 | 0 | +| conkc0 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | 0.000302 | +| conko0 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | 0.256 | +| convex | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.8 | 0.01 | 0.01 | 0.8 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | +| cplant1 | 200 | 300 | 200 | 300 | 159 | 250 | 250 | 250 | 150 | 150 | 250 | 1 | 0.1 | 0 | 1 | 1 | 0 | +| cplant2 | 10217 | 16833 | 5967 | 12000 | 5000 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| cplant3 | 876 | 1443 | 511 | 1029 | 500 | 500 | 500 | 500 | 607 | 607 | 500 | 1 | 0.1 | 0 | 1 | 1 | 0 | +| csoil1 | 184 | 303 | 107 | 216 | 100 | 275 | 275 | 275 | 149 | 149 | 275 | 1 | 0.1 | 1 | 1 | 1 | 1 | +| csoil2 | 367 | 606 | 214 | 432 | 250 | 314 | 314 | 314 | 300 | 300 | 314 | 1 | 0.1 | 1 | 1 | 1 | 1 | +| d0gs | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | 1500 | +| ejmax | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| ekc | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | 59430 | +| eko | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | 36000 | +| extkn | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | 0.001 | +| frac4 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0| +| froot1 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.15 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| froot2 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.15 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| froot3 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.15 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| froot4 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.15 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| froot5 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.15 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| froot6 | 0.05 | 0.2 | 0.2 | 0.2 | 0.2 | 0.15 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| g0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| g1 | 2.346064 | 4.114762 | 2.346064 | 4.447321 | 4.694803 | 5.2485 | 1.616178 | 2.222156 | 5.789377 | 1.616178 | 5.2485 | 5.2485 | 0 | 5.2485 | 5.2485 | 5.2485 | 5.2485 | +| gswmin | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.04 | 0.01 | 0.01 | 0.04 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | +| hc | 17 | 35 | 15.5 | 20 | 0.6 | 0.567 | 0.567 | 0.567 | 0.55 | 0.55 | 0.567 | 0.2 | 6.017 | 0.2 | 0.2 | 0.2 | 0.2 | +| lai | 4 | 5 | 0 | 0 | 0 | 0.2 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | +| length | 0.055 | 0.1 | 0.04 | 0.15 | 0.1 | 0.3 | 0.3 | 0.3 | 0.3 | 0.3 | 0.3 | 0.03 | 0.242 | 0.03 | 0.03 | 0.03 | 0.03 | +| ratecp1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | +| ratecp2 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | 0.03 | +| ratecp3 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | 0.14 | +| ratecs1 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | +| ratecs2 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | +| refl1 | 0.09 | 0.09 | 0.075 | 0.09 | 0.09 | 0.11 | 0.11 | 0.075 | 0.11 | 0.11 | 0.108 | 0.055 | 0.091 | 0.238 | 0.143 | 0.143 | 0.159 | +| refl2 | 0.3 | 0.29 | 0.3 | 0.29 | 0.3 | 0.34 | 0.34 | 0.32 | 0.34 | 0.34 | 0.343 | 0.19 | 0.31 | 0.457 | 0.275 | 0.275 | 0.305 | +| refl3 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | +| rootbeta | 0.943 | 0.962 | 0.966 | 0.961 | 0.964 | 0.943 | 0.943 | 0.943 | 0.961 | 0.961 | 0.943 | 0.975 | 0.961 | 0.961 | 0.961 | 0.961 | 0.961 | +| rp20 | 3 | 0.6 | 3 | 2.2 | 1 | 1.5 | 2.8 | 2.5 | 1.5 | 1 | 1.5 | 1 | 1 | 1 | 1 | 1 | 1 | +| rpcoef | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | 0.0832 | +| rs20 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 0 | 1 | 0 | 0 | 0 | 0 | +| shelrb | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | 2 | +| taul1 | 0.09 | 0.09 | 0.075 | 0.09 | 0.09 | 0.11 | 0.11 | 0.075 | 0.11 | 0.11 | 0.075 | 0.023 | 0.059 | 0.039 | 0.023 | 0.023 | 0.026 | +| taul2 | 0.3 | 0.29 | 0.3 | 0.29 | 0.3 | 0.34 | 0.34 | 0.32 | 0.34 | 0.34 | 0.146 | 0.198 | 0.163 | 0.189 | 0.113 | 0.113 | 0.113 | +| taul3 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | +| tmaxvj | -10 | -10 | 10 | 15 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | -10 | +| tminvj | -15 | -15 | 5 | 5 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | -15 | +| vbeta | 2 | 2 | 2 | 2 | 4 | 4 | 4 | 4 | 2 | 2 | 4 | 4 | 2 | 4 | 4 | 4 | 4 | +| vcmax | 4E-05 | 5.5E-05 | 4E-05 | 6E-05 | 4E-05 | 6E-05 | 1E-05 | 4E-05 | 8E-05 | 8E-05 | 6E-05 | 1.7E-05 | 1E-06 | 1.7E-05 | 1.7E-05 | 1.7E-05 | 1.7E-05 | +| vegcf | 9 | 14 | 9 | 8 | 5 | 7 | 7 | 5 | 7 | 1 | 7 | 1 | 1 | 1 | 1 | 1 | 1 | +| width | 0.001 | 0.05 | 0.001 | 0.08 | 0.005 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.01 | 0.003 | 0.015 | 0.001 | 0.001 | 0.001 | 0.001 | +| xfang | 0.01 | 0.1 | 0.01 | 0.25 | 0.01 | -0.3 | -0.3 | -0.3 | -0.3 | -0.3 | -0.3 | 0.1 | 0 | 0 | 0 | 0 | 0| +| zr | 1.8 | 3 | 2 | 2 | 2.5 | 0.5 | 0.5 | 0.5 | 0.5 | 0.5 | 1.8 | 3.1 | 3 | 1 | 1 | 1 | 1 | + + + +The CABLE distribution provides the default vegetation parameter values from Table 3 in the namelist file pft_params.nml, including the vegetation types from Table 1 in the top part. +The chosen parameter values in offline cases can be checked against the pre-defined realistic parameter value ranges using the CABLE namelist variable check%ranges=.true. in cable.nml. ## Example pft_params.nml file !!! Note "Namelist file format explanation" @@ -71,67 +228,6 @@ vegin%zr=1.800000,3.000000,2.000000,2.000000,2.500000,5*0.500000,1.800000,3.1000 / ``` -## Descriptive table of parameters - -| Namelist variable| Type | Available values | Default values | Description | -|------------------|------|------------------|----------------|-------------| -| vegin%a1gs | real | >=0.0 | 9, 9, 9, 9, 9, 9, 4, 9, 9, 4, 9, 9, 9, 9, 9, 9, 9 | a1 parameter in stomatal conductance model. Represents the sensitivity of stomatal conductance to the assimilation rate \( (-) \) | -| vegin%alpha | real | >=0.0 | 0.2, 0.2, 0.2, 0.2, 0.2, 0.2, 0.05, 0.2, 0.2, 0.05, 0.2, 0.2, 0.2, 0.2, 0.2, 0.2, 0.2 | Initial slope of J-Q response curve \( (mol (electrons) \cdot mol^{-1} (photons) (C3) \cdot mol (CO2) \cdot mol^{-1} (photons) (C4)) \) | -| vegin%canst1 | real | 0.05 – 0.15 | 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1 | Maximum intercepted water by canopy \( (mm \cdot LAI^{-1}) \) | -| vegin%cfrd | real | >=0.0 | 0.015, 0.015, 0.015, 0.015, 0.015, 0.025, 0.015, 0.015, 0.025, 0.015, 0.015, 0.015, 0.015, 0.015, 0.015, 0.015, 0.015 | Ratio of day respiration to vcmax \( (-) \) | -| vegin%clitt | real | >=0.0 | 20, 6, 10, 13, 2, 2, 0.3, 0.3, 0, 0, 2, 2, 0, 0, 0, 0, 0 | Leaf litter (alters resistance to soil evaporation) \( (tC \cdot ha^{-1}) \) | -| vegin%conkc0 | real | >=0.0 | 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302, 0.000302 | Michaelis-Menton constant for carboxylase \( (bar) \) | -| vegin%conko0 | real | >=0.0 | 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256, 0.256 | Michaelis-Menton constant for oxygenase \( (bar) \) | -| vegin%convex | real | >=0.0 | 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.8, 0.01, 0.01, 0.8, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01 | Convexity of J-Q response curve \( (-) \) | -| vegin%cplant1 | real | >=0.0 | 200, 300, 200, 300, 159, 250, 250, 250, 150, 150, 250, 1, 0.1, 0, 1, 1, 0 | Plant carbon in 1st vegetation carbon store \( (gC \cdot m^{-2}) \) | -| vegin%cplant2 | real | >=0.0 | 10217, 16833, 5967, 12000, 5000, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Plant carbon in 2nd vegetation carbon store \( (gC \cdot m^{-2}) \) | -| vegin%cplant3 | real | >=0.0 | 876, 1443, 511, 1029, 500, 500, 500, 500, 607, 607, 500, 1, 0.1, 0, 1, 1, 0 | Plant carbon in 3rd vegetation carbon store \( (gC \cdot m^{-2}) \) | -| vegin%csoil1 | real | >=0.0 | 184, 303, 107, 216, 100, 275, 275, 275, 149, 149, 275, 1, 0.1, 1, 1, 1, 1 | Soil carbon in 1st soil carbon store \( (gC \cdot m^{-2}) \) | -| vegin%csoil2 | real | >=0.0 | 367, 606, 214, 432, 250, 314, 314, 314, 300, 300, 314, 1, 0.1, 1, 1, 1, 1 | Soil carbon in 2nd soil carbon store \( (gC \cdot m^{-2}) \) | -| vegin%d0gs | real | >=0.0 | 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500, 1500 | d0 in stomatal conductance model \( (kPa) \) | -| vegin%desc | character | | 'Evergreen Needleleaf', 'Evergreen Broadleaf', 'Deciduous Needleleaf', 'Deciduous Broadleaf', 'Shrub', 'C3 Grassland', 'C4 Grassland', 'Tundra', 'C3 Cropland', 'C4 Cropland', 'Wetland', 'empty', 'empty', 'Barren', 'Urban', 'Lakes', 'Ice' | Description of plant functional type | -| vegin%ejmax | real | 0 – 3.0E-4 | 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Maximum potential electron transp rate top leaf \( (mol \cdot m^{-2} \cdot s^{-1}) \) | -| vegin%ekc | real | >=0.0 | 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430, 59430 | Activation energy for carboxylase \( (J \cdot mol^{-1}) \) | -| vegin%eko | real | >=0.0 | 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000, 36000 | Activation energy for oxygenase \( (J \cdot mol^{-1}) \) | -| vegin%extkn | real | 0.0 – 10.0 | 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001, 0.001 | Extinction coeficient for vertical profile of N \( (-) \) | -| vegin%frac4 | real | 0.0 – 1.0 | 0, 0, 0, 0, 0, 0, 1, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0| Fraction of c4 plants \( (-) \) | -| vegin%froot1 | real | 0.0 – 1.0 | 0.05, 0.2, 0.2, 0.2, 0.2, 0.15, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Fraction of root in soil layer 1 \( (-) \) | -| vegin%froot2 | real | 0.0 – 1.0 | 0.05, 0.2, 0.2, 0.2, 0.2, 0.15, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Fraction of root in soil layer 2 \( (-) \) | -| vegin%froot3 | real | 0.0 – 1.0 | 0.05, 0.2, 0.2, 0.2, 0.2, 0.15, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Fraction of root in soil layer 3 \( (-) \) | -| vegin%froot4 | real | 0.0 – 1.0 | 0.05, 0.2, 0.2, 0.2, 0.2, 0.15, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Fraction of root in soil layer 4 \( (-) \) | -| vegin%froot5 | real | 0.0 – 1.0 | 0.05, 0.2, 0.2, 0.2, 0.2, 0.15, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Fraction of root in soil layer 5 \( (-) \) | -| vegin%froot6 | real | 0.0 – 1.0 | 0.05, 0.2, 0.2, 0.2, 0.2, 0.15, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Fraction of root in soil layer 6 \( (-) \) | -| vegin%g0 | real | -0.5 – 0.5 | 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Belinda's stomatal model intercept. Residual stomatal conductance as net assimilation rate reaches zero \( (mol \cdot m^{-2} \cdot s^{-1}) \) | -| vegin%g1 | real | 0.0 – 20.0 | 2.346064, 4.114762, 2.346064, 4.447321, 4.694803, 5.2485, 1.616178, 2.222156, 5.789377, 1.616178, 5.2485, 5.2485, 0, 5.2485, 5.2485, 5.2485, 5.2485 | Belinda's stomatal model slope. Sensitivity of stomatal conductance to the assimilation rate \( (kPa) \) | -| vegin%gswmin | real | >=0.0 | 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.04, 0.01, 0.01, 0.04, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01 | Minimal stomatal conductance \( (mol \cdot m^{-2} \cdot s^{-1}) \) | -| vegin%hc | real | 0.0 – 100.0 | 17, 35, 15.5, 20, 0.6, 0.567, 0.567, 0.567, 0.55, 0.55, 0.567, 0.2, 6.017, 0.2, 0.2, 0.2, 0.2 | Roughness height of canopy (veg - snow) \( (m) \) | -| vegin%lai | real | 0.0 – 8.0 | 4, 5, 0, 0, 0, 0.2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 | Leaf area index of each plant functional type \( (-) or (m^{2} \cdot m^{-2} ) \) | -| vegin%length | real | >=0.0 | 0.055, 0.1, 0.04, 0.15, 0.1, 0.3, 0.3, 0.3, 0.3, 0.3, 0.3, 0.03, 0.242, 0.03, 0.03, 0.03, 0.03 | Leaf length \( (m) \) | -| vegin%ratecp1 | real | 0.01 – 3.0 | 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 | Plant carbon pool rate constant in 1st vegetation carbon store \( (year^{-1}) \) | -| vegin%ratecp2 | real | 0.01 – 3.0 | 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03, 0.03 | Plant carbon pool rate constant in 2nd vegetation carbon store \( (year^{-1}) \) | -| vegin%ratecp3 | real | 0.01 – 3.0 | 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14, 0.14 | Plant carbon pool rate constant in 3rd vegetation carbon store \( (year^{-1}) \) | -| vegin%ratecs1 | real | 0.01 – 3.0 | 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2 | Soil carbon pool rate constant in 1st soil carbon store \( (year^{-1}) \) | -| vegin%ratecs2 | real | 0.01 – 3.0 | 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5 | Soil carbon pool rate constant in 2nd soil carbon store \( (year^{-1}) \) | -| vegin%refl1 | real | 0.0 – 0.5 | 0.09, 0.09, 0.075, 0.09, 0.09, 0.11, 0.11, 0.075, 0.11, 0.11, 0.108, 0.055, 0.091, 0.238, 0.143, 0.143, 0.159 | Leaf reflectance in 1st radiation band \( (-) \) | -| vegin%refl2 | real | 0.0 – 0.5 | 0.3, 0.29, 0.3, 0.29, 0.3, 0.34, 0.34, 0.32, 0.34, 0.34, 0.343, 0.19, 0.31, 0.457, 0.275, 0.275, 0.305 | Leaf reflectance in 2nd radiation band \( (-) \) | -| vegin%refl3 | real | 0.0 – 0.5 | 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01 | Leaf reflectance in 3rd radiation band \( (-) \) | -| vegin%rootbeta | real | 0.0 – 1.0 | 0.943, 0.962, 0.966, 0.961, 0.964, 0.943, 0.943, 0.943, 0.961, 0.961, 0.943, 0.975, 0.961, 0.961, 0.961, 0.961, 0.961 | Beta parameter to calculate froot (Jackson et al. 1996) \( (-) \) | -| vegin%rp20 | real | 0.0 – 10.0 | 3, 0.6, 3, 2.2, 1, 1.5, 2.8, 2.5, 1.5, 1, 1.5, 1, 1, 1, 1, 1, 1 | Plant respiration coefficient at 20 C \( (-) \) | -| vegin%rpcoef | real | 0.05 – 1.5 | 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832, 0.0832 | Temperature coefficient non-leaf plant respiration \( (^{\circ}C^{-1}) \) | -| vegin%rs20 | real | 0.0 – 10.0 | 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 0, 0, 0, 0 | Soil respiration at 20 C \( (mol \cdot m^{-2} \cdot s^{-1} ) \) | -| vegin%shelrb | real | 1.0 – 3.0 | 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2 | Sheltering factor \( (-) \) | -| vegin%taul1 | real | 0.0 – 0.3 | 0.09, 0.09, 0.075, 0.09, 0.09, 0.11, 0.11, 0.075, 0.11, 0.11, 0.075, 0.023, 0.059, 0.039, 0.023, 0.023, 0.026 | Leaf transmittance in 1st radiation band \( (-) \) | -| vegin%taul2 | real | 0.0 – 0.3 | 0.3, 0.29, 0.3, 0.29, 0.3, 0.34, 0.34, 0.32, 0.34, 0.34, 0.146, 0.198, 0.163, 0.189, 0.113, 0.113, 0.113 | Leaf transmittance in 2nd radiation band \( (-) \) | -| vegin%taul3 | real | 0.0 – 0.3 | 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01 | Leaf transmittance in 3rd radiation band \( (-) \) | -| vegin%tmaxvj | real | -15.0 – 30.0 | -10, -10, 10, 15, -10, -10, -10, -10, -10, -10, -10, -10, -10, -10, -10, -10, -10 | Maximum temperature of the start of photosynthesis \( (^{\circ}C) \) | -| vegin%tminvj | real | -20.0 – 15.0 | -15, -15, 5, 5, -15, -15, -15, -15, -15, -15, -15, -15, -15, -15, -15, -15, -15 | Minimum temperature of the start of photosynthesis \( (^{\circ}C) \) | -| vegin%vbeta | real | -999999 – 999999 | 2, 2, 2, 2, 4, 4, 4, 4, 2, 2, 4, 4, 2, 4, 4, 4, 4 | Stomatal sensitivity to soil water \( (-) \) | -| vegin%vcmax | real | 5.0E-6 – 1.5E-4 | 4E-05, 5.5E-05, 4E-05, 6E-05, 4E-05, 6E-05, 1E-05, 4E-05, 8E-05, 8E-05, 6E-05, 1.7E-05, 1E-06, 1.7E-05, 1.7E-05, 1.7E-05, 1.7E-05 | Maximum RuBP carboxylation rate top leaf \( ( mol \cdot m^{-2} \cdot s^{-1} ) \) | -| vegin%vegcf | real | 0.0 – 100.0 | 9, 14, 9, 8, 5, 7, 7, 5, 7, 1, 7, 1, 1, 1, 1, 1, 1 | Scaling on soil respiration (place-holder scheme) \( (-) \) | -| vegin%width | real | >=0.0 | 0.001, 0.05, 0.001, 0.08, 0.005, 0.01, 0.01, 0.01, 0.01, 0.01, 0.01, 0.003, 0.015, 0.001, 0.001, 0.001, 0.001 | Leaf width \( (m) \) | -| vegin%xfang | real | -1.0 – 0.5 | 0.01, 0.1, 0.01, 0.25, 0.01, -0.3, -0.3, -0.3, -0.3, -0.3, -0.3, 0.1, 0, 0, 0, 0, 0| Leaf angle \( (-) \) | -| vegin%zr | real | >=0.0 | 1.8, 3, 2, 2, 2.5, 0.5, 0.5, 0.5, 0.5, 0.5, 1.8, 3.1, 3, 1, 1, 1, 1 | Maximum rooting depth \( (cm) \) | - ## Unused parameters | Name | Type | Available | Default | Description | From d5acf4222d506ff15d6350229cd73f538991a1a5 Mon Sep 17 00:00:00 2001 From: rkutteh <98803952+rkutteh@users.noreply.github.com> Date: Sun, 2 Jun 2024 22:08:48 +1000 Subject: [PATCH 2/2] Update documentation/docs/user_guide/inputs/pft_params_nml.md Co-authored-by: Claire Carouge --- documentation/docs/user_guide/inputs/pft_params_nml.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/docs/user_guide/inputs/pft_params_nml.md b/documentation/docs/user_guide/inputs/pft_params_nml.md index 08e9d0bfe..b57cdea96 100644 --- a/documentation/docs/user_guide/inputs/pft_params_nml.md +++ b/documentation/docs/user_guide/inputs/pft_params_nml.md @@ -34,7 +34,7 @@ The ranges listed are “physically possible” and mostly correspond to the opt | Name (vegin%) | Range | Units | Description | |-----------------------|------------------|-----------------------------------------------------------------------------------------------------|-------------| | a1gs | >=0.0 | \( (-) \) | a1 parameter in stomatal conductance model. Represents the sensitivity of stomatal conductance to the assimilation rate | -| alpha | >=0.0 | \( (mol (electrons) \cdot mol^{-1} (photons) (C3) \cdot mol (CO2) \cdot mol^{-1} (photons) (C4)) \) | Initial slope of J-Q response curve | +| alpha | >=0.0 | \( (mol (electrons) \cdot mol^{-1} (photons) (C3) \cdot \)
\( mol (CO2) \cdot mol^{-1} (photons) (C4)) \) | Initial slope of J-Q response curve | | canst1 | 0.05 – 0.15 | \( (mm \cdot LAI^{-1}) \) | Maximum intercepted water by canopy | | cfrd | >=0.0 | \( (-) \) | Ratio of day respiration to vcmax | | clitt | >=0.0 | \( (tC \cdot ha^{-1}) \) | Leaf litter (alters resistance to soil evaporation) |