Skip to content

ptfkit.weber2020

ptfkit.weber2020

Weber et al. (2020), compiled international soil hydraulic data.

Reference

Weber, T. K. D., Finkel, M., da Conceicao Goncalves, M., Vereecken, H., & Diamantopoulos, E. (2020). Pedotransfer function for the Brunswick soil hydraulic property model and comparison to the van Genuchten-Mualem model. Water Resources Research, 56, e2019WR026820. DOI: 10.1029/2019WR026820

Territory

Portuguese, German, UNSODA, and Vereecken soil data collections

Dataset

A compilation of 1,729 samples with water-retention and hydraulic-conductivity data; regression data set DS1 contained 392 of the 402 retained samples, DS2 was used for tau, DS3 contained 359 samples for K_snc, and 10 samples were held out as DS4.

CLASS DESCRIPTION
Weber2020PTFResult

Results returned by the matching PTF.
FUNCTION DESCRIPTION
calc_ptf_weber2020

Convert VGM parameters to Brunswick-VGM parameters.

Weber2020PTFResult

Bases: NamedTuple, Generic[T]

Results returned by the matching PTF.

ATTRIBUTE DESCRIPTION
theta_snc_bw

Saturated water content of the Brunswick noncapillary pore space. (dimensionless)

TYPE: T

theta_sc_bw

Saturated water content of the Brunswick capillary pore space. (dimensionless)

TYPE: T

alpha_bw

Brunswick-VGM inverse pressure-head scale parameter. (cm^-1)

TYPE: T

n_bw

Brunswick-VGM pore-size distribution shape parameter. (dimensionless)

TYPE: T

tau_bw

Brunswick capillary hydraulic-conductivity shape parameter. (dimensionless)

TYPE: T

k_sc_bw

Saturated capillary hydraulic conductivity. (cm d^-1)

TYPE: T

k_snc_bw

Saturated noncapillary hydraulic conductivity. (cm d^-1)

TYPE: T

Source code in ptfkit/weber2020.py 
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
class Weber2020PTFResult(NamedTuple, Generic[T]):
    """Results returned by the matching PTF.

    Attributes:
        theta_snc_bw: Saturated water content of the Brunswick noncapillary pore space.
            (dimensionless)
        theta_sc_bw: Saturated water content of the Brunswick capillary pore space. (dimensionless)
        alpha_bw: Brunswick-VGM inverse pressure-head scale parameter. (cm^-1)
        n_bw: Brunswick-VGM pore-size distribution shape parameter. (dimensionless)
        tau_bw: Brunswick capillary hydraulic-conductivity shape parameter. (dimensionless)
        k_sc_bw: Saturated capillary hydraulic conductivity. (cm d^-1)
        k_snc_bw: Saturated noncapillary hydraulic conductivity. (cm d^-1)

    """

    theta_snc_bw: T
    theta_sc_bw: T
    alpha_bw: T
    n_bw: T
    tau_bw: T
    k_sc_bw: T
    k_snc_bw: T

calc_ptf_weber2020 

calc_ptf_weber2020(*, theta_r_vgm: float, theta_s_vgm: float, alpha_vgm: float, n_vgm: float, tau_vgm: float, k_s_vgm: float) -> Weber2020PTFResult[floating]

calc_ptf_weber2020(*, theta_r_vgm: ArrayLike, theta_s_vgm: ArrayLike, alpha_vgm: ArrayLike, n_vgm: ArrayLike, tau_vgm: ArrayLike, k_s_vgm: ArrayLike, out: Weber2020PTFResult[NDArray[floating]] | None = None) -> Weber2020PTFResult[NDArray[floating]]

Convert VGM parameters to Brunswick-VGM parameters.

PARAMETER DESCRIPTION
theta_r_vgm

VGM residual volumetric water content. (dimensionless)

TYPE: float | ArrayLike

theta_s_vgm

VGM saturated volumetric water content. (dimensionless)

TYPE: float | ArrayLike

alpha_vgm

VGM inverse pressure-head scale parameter. (cm^-1)

TYPE: float | ArrayLike

n_vgm

VGM pore-size distribution shape parameter. (dimensionless)

TYPE: float | ArrayLike

tau_vgm

VGM hydraulic-conductivity shape parameter. (dimensionless)

TYPE: float | ArrayLike

k_s_vgm

VGM saturated hydraulic conductivity. (cm d^-1)

TYPE: float | ArrayLike

out

Optional output arrays for in-place calculation.

TYPE: Weber2020PTFResult[NDArray[floating]] | None DEFAULT: None

RETURNS DESCRIPTION
Weber2020PTFResult

Results grouped by result attributes.

TYPE: Weber2020PTFResult[floating] | Weber2020PTFResult[NDArray[floating]]

Models

\(h(\theta)\): Brunswick model with the van Genuchten capillary saturation function \(k(h)\): Brunswick capillary, noncapillary, and isothermal vapor conductivity model

Notes

Prediction target: Seven Brunswick-VGM soil hydraulic model parameters from six VGM parameters. Regression coefficients are the York-regression estimates in Table 3; parenthesized standard errors are not part of the prediction. Input domains reproduce the parameter-estimation bounds in Table 1 and are not stated as a validated application domain. The source recommends the median K_snc value as a provisional parsimonious estimate requiring further research.

Warning

The DS2 inequality is treated as a source typographical error; the tau regression is interpreted as being based on nonpositive tau_vgm values.

Source code in ptfkit/weber2020.py 
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
def calc_ptf_weber2020(
    *,
    theta_r_vgm: float | ArrayLike,
    theta_s_vgm: float | ArrayLike,
    alpha_vgm: float | ArrayLike,
    n_vgm: float | ArrayLike,
    tau_vgm: float | ArrayLike,
    k_s_vgm: float | ArrayLike,
    out: Weber2020PTFResult[NDArray[floating]] | None = None,
) -> Weber2020PTFResult[floating] | Weber2020PTFResult[NDArray[floating]]:
    r"""Convert VGM parameters to Brunswick-VGM parameters.

    Arguments:
        theta_r_vgm: VGM residual volumetric water content. (dimensionless)
        theta_s_vgm: VGM saturated volumetric water content. (dimensionless)
        alpha_vgm: VGM inverse pressure-head scale parameter. (cm^-1)
        n_vgm: VGM pore-size distribution shape parameter. (dimensionless)
        tau_vgm: VGM hydraulic-conductivity shape parameter. (dimensionless)
        k_s_vgm: VGM saturated hydraulic conductivity. (cm d^-1)
        out: Optional output arrays for in-place calculation.

    Returns:
        Weber2020PTFResult: Results grouped by result attributes.

    Models:
        $h(\theta)$: Brunswick model with the van Genuchten capillary saturation function
        $k(h)$: Brunswick capillary, noncapillary, and isothermal vapor conductivity model

    Notes:
        Prediction target: Seven Brunswick-VGM soil hydraulic model parameters from six VGM
            parameters.
        Regression coefficients are the York-regression estimates in Table 3; parenthesized standard
            errors are not part of the prediction.
        Input domains reproduce the parameter-estimation bounds in Table 1 and are not stated as a
            validated application domain.
        The source recommends the median K_snc value as a provisional parsimonious estimate
            requiring further research.

    Warning:
        The DS2 inequality is treated as a source typographical error; the tau regression is
            interpreted as being based on nonpositive tau_vgm values.

    """
    values = _call(
        _calc_ptf_weber2020,
        theta_r_vgm,
        theta_s_vgm,
        alpha_vgm,
        n_vgm,
        tau_vgm,
        k_s_vgm,
        out=out,
    )

    return Weber2020PTFResult(*values)