ptfkit.gunarathna2019

def calc_ptf_gunarathna2019_vwc10_set1(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -10 kPa using Set 1.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_10: Volumetric water content at -10 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -10 kPa.
        Equation evidence: Table 3, VWC10, Set 1.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.
        Section 3.1 reports slight overprediction above 64% sand at this pressure.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc10_set1,
        sand,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc10_set2(
    *,
    sand: float | ArrayLike,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -10 kPa using Set 2.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        silt: Silt percentage measured by the pipette method. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_10: Volumetric water content at -10 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -10 kPa.
        Equation evidence: Table 3, VWC10, Set 2.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc10_set2,
        sand,
        silt,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc10_set3(
    *,
    sand: float | ArrayLike,
    silt: float | ArrayLike,
    bulk_density: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -10 kPa using Set 3.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        silt: Silt percentage measured by the pipette method. (%)
        bulk_density: Bulk density measured using undisturbed cores. (g/cm3)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_10: Volumetric water content at -10 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -10 kPa.
        Equation evidence: Table 3, VWC10, Set 3.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc10_set3,
        sand,
        silt,
        bulk_density,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc10_set4(
    *,
    sand: float | ArrayLike,
    silt: float | ArrayLike,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -10 kPa using Set 4.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        silt: Silt percentage measured by the pipette method. (%)
        organic_carbon: Organic carbon percentage measured by the Walkley-Black method. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_10: Volumetric water content at -10 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -10 kPa.
        Equation evidence: Table 3, VWC10, Set 4.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc10_set4,
        sand,
        silt,
        organic_carbon,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc1500_set1(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -1500 kPa using Set 1.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_1500: Volumetric water content at -1500 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -1500 kPa.
        Equation evidence: Table 3, VWC1500, Set 1.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.
        Section 3.1 reports slight overprediction above 66% sand at this pressure.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc1500_set1,
        sand,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc1500_set3(
    *,
    sand: float | ArrayLike,
    bulk_density: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -1500 kPa using Set 3.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        bulk_density: Bulk density measured using undisturbed cores. (g/cm3)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_1500: Volumetric water content at -1500 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -1500 kPa.
        Equation evidence: Table 3, VWC1500, Set 3.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc1500_set3,
        sand,
        bulk_density,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc1500_set4(
    *,
    sand: float | ArrayLike,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -1500 kPa using Set 4.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        organic_carbon: Organic carbon percentage measured by the Walkley-Black method. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_1500: Volumetric water content at -1500 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -1500 kPa.
        Equation evidence: Table 3, VWC1500, Set 4.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc1500_set4,
        sand,
        organic_carbon,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc33_set1(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -33 kPa using Set 1.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_33: Volumetric water content at -33 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -33 kPa.
        Equation evidence: Table 3, VWC33, Set 1.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.
        Section 3.1 reports slight overprediction above 66% sand at this pressure.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc33_set1,
        sand,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc33_set2(
    *,
    sand: float | ArrayLike,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -33 kPa using Set 2.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        silt: Silt percentage measured by the pipette method. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_33: Volumetric water content at -33 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -33 kPa.
        Equation evidence: Table 3, VWC33, Set 2.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc33_set2,
        sand,
        silt,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc33_set3(
    *,
    sand: float | ArrayLike,
    silt: float | ArrayLike,
    bulk_density: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -33 kPa using Set 3.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        silt: Silt percentage measured by the pipette method. (%)
        bulk_density: Bulk density measured using undisturbed cores. (g/cm3)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_33: Volumetric water content at -33 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -33 kPa.
        Equation evidence: Table 3, VWC33, Set 3.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc33_set3,
        sand,
        silt,
        bulk_density,
        out=out,
    )

def calc_ptf_gunarathna2019_vwc33_set4(
    *,
    sand: float | ArrayLike,
    silt: float | ArrayLike,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate volumetric water content at -33 kPa using Set 4.

    Arguments:
        sand: Sand percentage measured by sieve analysis. (%)
        silt: Silt percentage measured by the pipette method. (%)
        organic_carbon: Organic carbon percentage measured by the Walkley-Black method. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        theta_33: Volumetric water content at -33 kPa matric potential. (mm/mm)

    Notes:
        Prediction target: Volumetric water content at -33 kPa.
        Equation evidence: Table 3, VWC33, Set 4.
        Input ranges describe the study observations, not enforced validity limits.

    Warning:
        Predictions are empirical and are not clipped to physical bounds.

    """
    return _call(
        _calc_ptf_gunarathna2019_vwc33_set4,
        sand,
        silt,
        organic_carbon,
        out=out,
    )