SWRCs: Functionality for Soil Water Retention Curves ('SWRC')

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

Functionality for Soil Water Retention Curves (SWRC)

Description

SWRCs convert between soil water content and soil water potential using a set of parameters, see swrc_swp_to_vwc() and swrc_vwc_to_swp().

The SWRC parameters may be estimated from soil properties with suitable pedotransfer functions PTFs, see ptf_estimate().

The SWRC parameters can be checked for consistency with check_swrcp().

Arguments

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]⁠).
layer_width	A numeric value or vector. Depth interval, width, of each soil layer (units of cm). layer_width is required to translate between soil water content of a soil layer and volumetric water content.
swrc_name	An character string or vector. The selected SWRC name (one of swrc_names(), with default "Campbell1974").
ptf_name	An character string or vector. The selected PTF name (one of ptf_names(), with default "Cosby1984AndOthers").
swrcp	A numeric vector or matrix. The parameters of a selected SWRC; each row represents one SWRC, e.g., one per soil layer.
swrc	A named list. Contains all necessary elements of a SWRC, i.e., name (short for swrc_name) and swrcp, or all necessary elements to estimate parameters of a SWRC given soil parameters, i.e., swrc_name and ptf_name.
fail	A logical value. Issue a warning (FALSE, default) or throw an error (TRUE) if request fails.
verbose	A logical value. If TRUE, then display SOILWAT2 internal warnings and other messages.
...	Additional function arguments passed on or ignored.

Details

swrc_names() lists implemented SWRCs; ptf_names() lists implemented PTFs.

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")}

See Also

swrc_names(), ptf_names(), check_ptf_availability(), ptf_estimate(), check_swrcp(), swrc_swp_to_vwc(), swrc_vwc_to_swp()

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