Creates a list with global default parameters for simulation models.
defaultControl()
A list, with the following options (default values in parentheses):
General:
verbose (=TRUE)
: Boolean flag to indicate console output during calculations.
subdailyResults (=FALSE)
: Boolean flag to force subdaily results to be stored (as a list called 'subdaily' of spwb_day
objects, one by simulated date) in calls to spwb
.
soilFunctions (="SX")
: Soil water retention curve and conductivity functions, either 'SX' (for Saxton) or 'VG' (for Van Genuchten).
defaultWindSpeed (= 2.5)
: Default wind speed value (in m/s) to be used when missing from data.
Water balance:
snowpack (=TRUE)
: Boolean flag to indicate the simulation of snow accumulation and melting.
rockyLayerDrainage (=TRUE)
: Boolean flag to indicate the simulation of drainage from rocky layers (> 95% of rocks).
unlimitedSoilWater (=FALSE)
: Boolean flag to indicate the simulation of plant transpiration assuming that soil water is always at field capacity.
leafPhenology (=TRUE)
: Boolean flag to indicate the simulation of leaf phenology for winter-deciduous species.
unfoldingDD (=300)
: Degree-days for complete leaf unfolding after budburst has occurred.
plantWaterPools (=FALSE)
: Boolean flag to indicate the simulation of water balance assuming that each cohort has its own water pools.
transpirationMode (="Granier")
: Transpiration model (either 'Granier' or 'Sperry'). See spwbInput
.
verticalLayerSize (= 100)
: The size of vertical layers (in cm) for photosynthesis calculation.
cavitationRefill (= "total")
: A string indicating how refilling of embolized conduits is done ("none" - no refilling, "annual" - every first day of the year, "rate" - following a rate of new sapwood formation, "total" - instantaneous complete refilling).
refillMaximumRate (= 0.05)
: Maximum rate of daily refilling of embolized conduits as sapwood area per leaf area (in cm2<U+00B7>m-2<U+00B7>day-1).
Water balance with 'Sperry':
gainModifier, costModifier (= 1)
: Modifiers (exponents) of the gain and cost functions defined in Sperry et al. (2016).
cochard (=FALSE)
: Boolean flag to indicate the stomatal closure when leaf water potential is below turgor loss point so that transpiration depends on cuticular properties (Martin-StPaul et al. 2017).
ndailysteps (= 24)
: Number of steps into which each day is divided for determination of stomatal conductance, transpiration and photosynthesis (24 equals 1-hour intervals).
capacitance (=FALSE)
: Whether the effect of plant water compartments is considered in simulations.
klatstem (= 0.01)
: Stem symplastic-apoplastic lateral conductance (in mmol<U+00B7>s-1<U+00B7>m-2<U+00B7>MPa-1). Only relevant when capacitance = TRUE
.
klatleaf (= 0.01)
: Leaf symplastic-apoplastic lateral conductance (in mmol<U+00B7>s-1<U+00B7>m-2<U+00B7>MPa-1). Only relevant when capacitance = TRUE
.
taper (= TRUE)
: Whether taper of xylem conduits is accounted for when calculating aboveground stem conductance from xylem conductivity.
numericParams
: A list with the following elements:
maxNsteps (= 400)
: Maximum number of steps in supply function.
ntrial (= 200)
: Number of iteration trials when finding root of equation system.
psiTol (= 0.0001)
: Tolerance value for water potential.
ETol (= 0.0001)
: Tolerance value for flow.
thermalCapacityLAI (=1000000)
: Thermal canopy capacitance per LAI unit.
Catm (=386)
: Atmospheric CO2 concentration (in micromol<U+00B7>mol-1 = ppm).
fracLeafResistance (= NA)
: Fraction of plant total resistance (leaf+stem+root) that corresponds to leaves. This fraction is used if VCleaf_kmax = NA
.
fracRootResistance (=0.40)
: Fraction of plant total resistance (leaf+stem+root) that corresponds to root system.
averageFracRhizosphereResistance (=0.15)
: Fraction to total continuum (leaf+stem+root+rhizosphere) resistance that corresponds to rhizosphere (averaged across soil water potential values).
Growth:
allocationStrategy (="Plant_kmax")
: Strategy for allocation (either "Plant_kmax", for constant maximum plant conductance, or "Al2As" for constant Huber value).
nonStomatalPhotosynthesisLimitation (=TRUE)
: A flag to apply limitations of pho-tosynthesis when leaf sugar levels become too high.
floemConductanceFactor (= 0.2))
: Factor to transform stem xylem conductance to stem floem conductance (only for transpirationMode = "Sperry").
nonSugarConcentration (= 0.3)
: Non-sugar (inorganic) solute concentration (mol<U+00B7>l-1) in cells.
equilibriumOsmoticConcentration [= c(leaf = 0.8, sapwood = 0.6)]
: Equilibrium osmotic concentrations (mol<U+00B7>l-1) for leaf and sapwood cells. The difference helps floem transport.
minimumSugarForGrowth [= c(leaf = 0.25, sapwood=0.25, fineroot = 0.25)]
: Minimum concentration of sugars (mol<U+00B7>l-1) for growth to occur in different tissues.
respirationRates [= c(leaf = 0.00260274, sapwood = 6.849315e-05, fineroot = 0.002054795)]
: Maintenance respiration rates for different tissues (g gluc <U+00B7> g dry-1 <U+00B7> day-1).
turnoverRates [= c(sapwood = 0.0001261398, fineroot = 0.001897231)]
: Turnover rates (day-1) for sapwood and fineroots. Default are equivalent to 4.5% and 50% annual turnover for sapwood and fine roots, respectively.
constructionCosts [= c(leaf = 1.5, sapwood = 1.47, fineroot = 1.30)]
: Construction costs, including respiration and structural carbon, per dry weight of new tissue (g gluc <U+00B7> g dry -1).
maximumRelativeGrowthRates [= c(leaf = 0.01, sapwood = 0.001, fineroot = 0.1)]
: Maximum relative growth rates for leaves (m2 leaf <U+00B7>cm-2 sapwood<U+00B7> day-1), sapwood (cm2 sapwood <U+00B7>cm-2 sapwood<U+00B7> day-1) and fine roots (g dw <U+00B7> g dw -1 <U+00B7> day -1). Values for leaves and fine roots are used for all species, whereas the value for sapwood is the default used when relative growth rate is not specified via SpParams.
The function returns a list with default parameters. Users can change those defaults that need to be set to other values and use the list as input for model functions. The relevant parameters are different for each model function.