Skip to contents

Checks species parameter tables

Source: R/check_params.R
check_medfate_params.Rd

Checks that the input data frame has the appropriate format and data for simulations with medfate.

Usage

check_medfate_params(x, check_consistency = FALSE, verbose = TRUE)

Arguments

x

A data frame with species parameter data

check_consistency

A boolean flag to force checking ecological and physiological consistence of parameter values.

verbose

A boolean flag to prompt detailed process information.

Value

An (invisible) list with two data frames, one with missing values in strict parameters and the other with plant names whose parameters (observed or imputed) do not conform to physiological rules.

Details

The function can perform two kinds of parameter check.

A formal check is always performed with the following rules:

  • The input is a data frame.

  • All parameter names defined in SpParamsDefinition should be listed as columns.

  • Strict parameters should not contain missing values. Strict parameters are defined as such in SpParamsDefinition.

If check_consistency = TRUE, the function also performs the following consistency checks for the parameter values of each species:

  1. Rule 1. Stem hydraulic vulnerability is not larger than leaf hydraulic vulnerability (VCstem_P50 < VCleaf_P50) (Bartlett et al. 2016).

  2. Rule 2. Stem hydraulic vulnerability is not larger than root hydraulic vulnerability (VCstem_P50 < VCroot_P50).

  3. Rule 3. Stem hydraulic vulnerability curve is consistent (VCstem_P88 < VCstem_P50 < VCstem_P12).

  4. Rule 4. Leaf hydraulic vulnerability curve is consistent (VCleaf_P88 < VCleaf_P50 < VCleaf_P12).

  5. Rule 5. Root hydraulic vulnerability curve is consistent (VCroot_P88 < VCroot_P50 < VCroot_P12).

  6. Rule 6. Maximum (stomatal) conductance is larger than minimum (cuticular) stomatal conductance (Gswmax > Gswmin).

  7. Rule 7. Leaf PLC does not occur before stomatal closure (VCleaf_P50 < Gsw_P50_Baldocchi) (Bartlett et al. 2016).

  8. Rule 8. Leaf angle is not lower than 20 degrees.

Parameter consistency is conducted including imputation of missing values, according to medfate inbuilt parameter estimation.

References

Bartlett et al. (2016). The correlations and sequence of plant stomatal, hydraulic, and wilting responses to drought. PNAS 113: 13098-13103.

Examples

check_medfate_params(SpParamsES, check_consistency = FALSE)
#> ✔ The data frame is formally acceptable as species parameter table for medfate.