rSW2_SWRC_PTF_estimate_parameters: Estimate parameters of selected soil water retention curve...

In Burke-Lauenroth-Lab/rSOILWAT2: An Ecohydrological Ecosystem-Scale Water Balance Simulation Model

Estimate parameters of selected soil water retention curve (SWRC) using selected pedotransfer function (PTF) that are implemented in R

Description

Estimate parameters of selected soil water retention curve (SWRC) using selected pedotransfer function (PTF) that are implemented in R

Usage

rSW2_SWRC_PTF_estimate_parameters(
  ptf_name,
  sand,
  clay,
  fcoarse,
  bdensity = NULL,
  fail = TRUE,
  ...
)

Arguments

ptf_name	An character string or vector. The selected PTF name (one of ptf_names(), with default "Cosby1984AndOthers").
sand	A numeric value or vector. Sand content of the matric soil component (< 2 mm fraction; units of ⁠[g/g]⁠) of each soil layer.
clay	A numeric value or vector. Clay content of the matric soil component (< 2 mm fraction; units of ⁠[g/g]⁠) of each soil layer.
fcoarse	A numeric value or vector. Coarse fragments, e.g., gravel, (> 2 mm; units of ⁠[m3/m3]⁠) relative to the whole soil of each soil layer. fcoarse is required, for instance, to translate between values relative to the matric soil component (< 2 mm fraction) and relative to the whole soil (matric soil plus coarse fragments).
bdensity	A numeric value or vector. Density of the whole soil (matric soil plus coarse fragments; units ⁠[g/cm3]⁠).
fail	A logical value. If requested PTF fails, then issue a warning (FALSE) or throw an error (TRUE, default).
...	Additional parameters passed to selected PTF function.

Value

swrcp, i.e,. a numeric matrix where rows represent soil (layers) and columns represent a fixed number of SWRC parameters. The interpretation is dependent on the selected SWRC. However, return value is NULL only if fail is FALSE and requested PTF is not implemented in R.

Details

ptf_estimate() is the function that should be directly called; this here is an internal helper function.

Notes

See SWRC_PTF_estimate_parameters() in SOILWAT2 for PTFs implemented in C.

References

Cosby, B. J., G. M. Hornberger, R. B. Clapp, & T. R. Ginn. 1984. A statistical exploration of the relationships of soil moisture characteristics to the physical properties of soils. Water Resources Research, 20:682-690, \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1029/WR020i006p00682")}

Burke-Lauenroth-Lab/rSOILWAT2 documentation built on Dec. 9, 2023, 1:46 a.m.