Skip to content

ptfkit.puckett1985

ptfkit.puckett1985

Puckett et al. (1985), Alabama Lower Coastal Plain Ultisols.

Reference

Puckett, W. E., Dane, J. H., & Hajek, B. F. (1985). Physical and mineralogical data to determine soil hydraulic properties. Soil Science Society of America Journal, 49, 831-836.

Territory

Lower Coastal Plain of Alabama, USA

Dataset

Seven pedons at seven locations representing six Ultisol series with similar genesis and clay mineralogy.

CLASS DESCRIPTION
Puckett1985PTFResult

Results returned by the matching PTF.
FUNCTION DESCRIPTION
calc_ptf_puckett1985

Estimate a point water-retention curve and saturated hydraulic conductivity.

Puckett1985PTFResult

Bases: NamedTuple, Generic[T]

Results returned by the matching PTF.

ATTRIBUTE DESCRIPTION
theta_0

Volumetric water content at 0 kPa. (cm^3/cm^3)

TYPE: T

theta_1

Volumetric water content at -1 kPa. (cm^3/cm^3)

TYPE: T

theta_5

Volumetric water content at -5 kPa. (cm^3/cm^3)

TYPE: T

theta_10

Volumetric water content at -10 kPa. (cm^3/cm^3)

TYPE: T

theta_30

Volumetric water content at -30 kPa. (cm^3/cm^3)

TYPE: T

theta_60

Volumetric water content at -60 kPa. (cm^3/cm^3)

TYPE: T

theta_100

Volumetric water content at -100 kPa. (cm^3/cm^3)

TYPE: T

theta_500

Volumetric water content at -500 kPa. (cm^3/cm^3)

TYPE: T

theta_1000

Volumetric water content at -1000 kPa. (cm^3/cm^3)

TYPE: T

theta_1500

Volumetric water content at -1500 kPa. (cm^3/cm^3)

TYPE: T

k_sat

Saturated hydraulic conductivity. (m/s)

TYPE: T

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

    Attributes:
        theta_0: Volumetric water content at 0 kPa. (cm^3/cm^3)
        theta_1: Volumetric water content at -1 kPa. (cm^3/cm^3)
        theta_5: Volumetric water content at -5 kPa. (cm^3/cm^3)
        theta_10: Volumetric water content at -10 kPa. (cm^3/cm^3)
        theta_30: Volumetric water content at -30 kPa. (cm^3/cm^3)
        theta_60: Volumetric water content at -60 kPa. (cm^3/cm^3)
        theta_100: Volumetric water content at -100 kPa. (cm^3/cm^3)
        theta_500: Volumetric water content at -500 kPa. (cm^3/cm^3)
        theta_1000: Volumetric water content at -1000 kPa. (cm^3/cm^3)
        theta_1500: Volumetric water content at -1500 kPa. (cm^3/cm^3)
        k_sat: Saturated hydraulic conductivity. (m/s)

    """

    theta_0: T
    theta_1: T
    theta_5: T
    theta_10: T
    theta_30: T
    theta_60: T
    theta_100: T
    theta_500: T
    theta_1000: T
    theta_1500: T
    k_sat: T

calc_ptf_puckett1985 

calc_ptf_puckett1985(*, sand: float, fine_sand: float, clay: float, bulk_density: float, porosity: float) -> Puckett1985PTFResult[floating]

calc_ptf_puckett1985(*, sand: ArrayLike, fine_sand: ArrayLike, clay: ArrayLike, bulk_density: ArrayLike, porosity: ArrayLike, out: Puckett1985PTFResult[NDArray[floating]] | None = None) -> Puckett1985PTFResult[NDArray[floating]]

Estimate a point water-retention curve and saturated hydraulic conductivity.

PARAMETER DESCRIPTION
sand

Sand content, 0.05-2 mm. (%)

TYPE: float | ArrayLike

fine_sand

Fine sand content, 0.106-0.25 mm. (%)

TYPE: float | ArrayLike

clay

Clay content, <0.002 mm. (%)

TYPE: float | ArrayLike

bulk_density

Oven-dry bulk density. (Mg/m^3)

TYPE: float | ArrayLike

porosity

Porosity calculated from measured bulk and particle densities. (cm^3/cm^3)

TYPE: float | ArrayLike

out

Optional output arrays for in-place calculation.

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

RETURNS DESCRIPTION
Puckett1985PTFResult

Results grouped by result attributes.

TYPE: Puckett1985PTFResult[floating] | Puckett1985PTFResult[NDArray[floating]]

Models

\(h(\theta)\): Point water-retention estimates from 0 to -1500 kPa \(k(h)\): Saturated hydraulic conductivity

Notes

Prediction target: Volumetric water contents at ten pressure heads and saturated hydraulic conductivity. The regressions were developed for soils with similar genesis and clay mineralogy.

Warning

Use outside Lower Coastal Plain Ultisols requires independent validation.

Source code in ptfkit/puckett1985.py 
 89
 90
 91
 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
def calc_ptf_puckett1985(
    *,
    sand: float | ArrayLike,
    fine_sand: float | ArrayLike,
    clay: float | ArrayLike,
    bulk_density: float | ArrayLike,
    porosity: float | ArrayLike,
    out: Puckett1985PTFResult[NDArray[floating]] | None = None,
) -> Puckett1985PTFResult[floating] | Puckett1985PTFResult[NDArray[floating]]:
    r"""Estimate a point water-retention curve and saturated hydraulic conductivity.

    Arguments:
        sand: Sand content, 0.05-2 mm. (%)
        fine_sand: Fine sand content, 0.106-0.25 mm. (%)
        clay: Clay content, <0.002 mm. (%)
        bulk_density: Oven-dry bulk density. (Mg/m^3)
        porosity: Porosity calculated from measured bulk and particle densities. (cm^3/cm^3)
        out: Optional output arrays for in-place calculation.

    Returns:
        Puckett1985PTFResult: Results grouped by result attributes.

    Models:
        $h(\theta)$: Point water-retention estimates from 0 to -1500 kPa
        $k(h)$: Saturated hydraulic conductivity

    Notes:
        Prediction target: Volumetric water contents at ten pressure heads and saturated hydraulic
            conductivity.
        The regressions were developed for soils with similar genesis and clay mineralogy.

    Warning:
        Use outside Lower Coastal Plain Ultisols requires independent validation.

    """
    values = _call(
        _calc_ptf_puckett1985,
        sand,
        fine_sand,
        clay,
        bulk_density,
        porosity,
        out=out,
    )

    return Puckett1985PTFResult(*values)