ptfkit.lal1979

def calc_ptf_lal1979_group_i_lower_plastic_limit_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate lower plastic limit for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        lower_plastic_limit: Lower plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Lower plastic limit
        Table IX, Group I, clay predictor, lower_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_lower_plastic_limit_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_lower_plastic_limit_from_organic_carbon(
    *,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate lower plastic limit for Group I.

    Arguments:
        organic_carbon: Organic carbon measured by Walkley and Black wet combustion; percentage of
            the fine earth. Full calibration bounds are not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        lower_plastic_limit: Lower plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Lower plastic limit
        Table IX, Group I, organic_carbon predictor, lower_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_lower_plastic_limit_from_organic_carbon,
        organic_carbon,
        out=out,
    )

def calc_ptf_lal1979_group_i_lower_plastic_limit_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate lower plastic limit for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        lower_plastic_limit: Lower plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Lower plastic limit
        Table IX, Group I, sand predictor, lower_plastic_limit response.

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

def calc_ptf_lal1979_group_i_moisture_equivalent_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        moisture_equivalent: Gravimetric moisture equivalent measured at 1000 times gravity
            expressed per unit dry soil mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture equivalent measured at 1000 times gravity
        Table VII, Group I, clay predictor, moisture_equivalent response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_moisture_equivalent_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_moisture_equivalent_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        moisture_equivalent: Gravimetric moisture equivalent measured at 1000 times gravity
            expressed per unit dry soil mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture equivalent measured at 1000 times gravity
        Table VII, Group I, sand predictor, moisture_equivalent response.

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

def calc_ptf_lal1979_group_i_plasticity_index_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate plasticity index (upper minus lower plastic limit) for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        plasticity_index: Plasticity index (upper minus lower plastic limit) expressed as percentage
            of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Plasticity index (upper minus lower plastic limit)
        Table IX, Group I, clay predictor, plasticity_index response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_plasticity_index_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_plasticity_index_from_organic_carbon(
    *,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate plasticity index (upper minus lower plastic limit) for Group I.

    Arguments:
        organic_carbon: Organic carbon measured by Walkley and Black wet combustion; percentage of
            the fine earth. Full calibration bounds are not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        plasticity_index: Plasticity index (upper minus lower plastic limit) expressed as percentage
            of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Plasticity index (upper minus lower plastic limit)
        Table IX, Group I, organic_carbon predictor, plasticity_index response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_plasticity_index_from_organic_carbon,
        organic_carbon,
        out=out,
    )

def calc_ptf_lal1979_group_i_plasticity_index_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate plasticity index (upper minus lower plastic limit) for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        plasticity_index: Plasticity index (upper minus lower plastic limit) expressed as percentage
            of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Plasticity index (upper minus lower plastic limit)
        Table IX, Group I, sand predictor, plasticity_index response.

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

def calc_ptf_lal1979_group_i_upper_plastic_limit_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate upper plastic limit for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        upper_plastic_limit: Upper plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Upper plastic limit
        Table IX, Group I, clay predictor, upper_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_upper_plastic_limit_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_upper_plastic_limit_from_organic_carbon(
    *,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate upper plastic limit for Group I.

    Arguments:
        organic_carbon: Organic carbon measured by Walkley and Black wet combustion; percentage of
            the fine earth. Full calibration bounds are not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        upper_plastic_limit: Upper plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Upper plastic limit
        Table IX, Group I, organic_carbon predictor, upper_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_upper_plastic_limit_from_organic_carbon,
        organic_carbon,
        out=out,
    )

def calc_ptf_lal1979_group_i_water_01bar_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.1 bar suction for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_01bar: Gravimetric moisture retention at 0.1 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.1 bar suction
        Table V, Group I, clay predictor, water_01bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_water_01bar_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_water_01bar_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.1 bar suction for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_01bar: Gravimetric moisture retention at 0.1 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.1 bar suction
        Table V, Group I, sand predictor, water_01bar response.

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

def calc_ptf_lal1979_group_i_water_03bar_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.3 bar suction for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_03bar: Gravimetric moisture retention at 0.3 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.3 bar suction
        Table V, Group I, clay predictor, water_03bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_water_03bar_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_water_03bar_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.3 bar suction for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_03bar: Gravimetric moisture retention at 0.3 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.3 bar suction
        Table V, Group I, sand predictor, water_03bar response.

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

def calc_ptf_lal1979_group_i_water_0bar_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at saturation for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_0bar: Gravimetric moisture retention at saturation expressed per unit dry soil mass.
            (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at saturation
        Table IV, Group I, clay predictor, water_0bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_water_0bar_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_water_0bar_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at saturation for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_0bar: Gravimetric moisture retention at saturation expressed per unit dry soil mass.
            (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at saturation
        Table IV, Group I, sand predictor, water_0bar response.

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

def calc_ptf_lal1979_group_i_water_15bar_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 15 bar suction for Group I.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_15bar: Gravimetric moisture retention at 15 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 15 bar suction
        Table VI, Group I, clay predictor, water_15bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_water_15bar_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_i_water_15bar_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 15 bar suction for Group I.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_15bar: Gravimetric moisture retention at 15 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 15 bar suction
        Table VI, Group I, sand predictor, water_15bar response.

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

def calc_ptf_lal1979_group_i_water_15bar_from_silt(
    *,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 15 bar suction for Group I.

    Arguments:
        silt: Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_15bar: Gravimetric moisture retention at 15 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group I: 11 well-drained upland profiles in western Nigeria developed over pre-Cambrian
            basement complex rocks, mainly biotite-muscovite paragneisses.

    Notes:
        Prediction target: Gravimetric moisture retention at 15 bar suction
        Table VI, Group I, silt predictor, water_15bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_i_water_15bar_from_silt,
        silt,
        out=out,
    )

def calc_ptf_lal1979_group_ii_lower_plastic_limit_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate lower plastic limit for Group II.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        lower_plastic_limit: Lower plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Lower plastic limit
        Table IX, Group II, clay predictor, lower_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_lower_plastic_limit_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_ii_lower_plastic_limit_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate lower plastic limit for Group II.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        lower_plastic_limit: Lower plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Lower plastic limit
        Table IX, Group II, sand predictor, lower_plastic_limit response.

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

def calc_ptf_lal1979_group_ii_lower_plastic_limit_from_silt(
    *,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate lower plastic limit for Group II.

    Arguments:
        silt: Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        lower_plastic_limit: Lower plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Lower plastic limit
        Table IX, Group II, silt predictor, lower_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_lower_plastic_limit_from_silt,
        silt,
        out=out,
    )

def calc_ptf_lal1979_group_ii_moisture_equivalent_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group II.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        moisture_equivalent: Gravimetric moisture equivalent measured at 1000 times gravity
            expressed per unit dry soil mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture equivalent measured at 1000 times gravity
        Table VII, Group II, clay predictor, moisture_equivalent response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_moisture_equivalent_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_ii_moisture_equivalent_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group II.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        moisture_equivalent: Gravimetric moisture equivalent measured at 1000 times gravity
            expressed per unit dry soil mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture equivalent measured at 1000 times gravity
        Table VII, Group II, sand predictor, moisture_equivalent response.

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

def calc_ptf_lal1979_group_ii_moisture_equivalent_from_silt(
    *,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group II.

    Arguments:
        silt: Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        moisture_equivalent: Gravimetric moisture equivalent measured at 1000 times gravity
            expressed per unit dry soil mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture equivalent measured at 1000 times gravity
        Table VII, Group II, silt predictor, moisture_equivalent response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_moisture_equivalent_from_silt,
        silt,
        out=out,
    )

def calc_ptf_lal1979_group_ii_plasticity_index_from_organic_carbon(
    *,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate plasticity index (upper minus lower plastic limit) for Group II.

    Arguments:
        organic_carbon: Organic carbon measured by Walkley and Black wet combustion; percentage of
            the fine earth. Full calibration bounds are not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        plasticity_index: Plasticity index (upper minus lower plastic limit) expressed as percentage
            of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Plasticity index (upper minus lower plastic limit)
        Table IX, Group II, organic_carbon predictor, plasticity_index response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_plasticity_index_from_organic_carbon,
        organic_carbon,
        out=out,
    )

def calc_ptf_lal1979_group_ii_plasticity_index_from_silt(
    *,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate plasticity index (upper minus lower plastic limit) for Group II.

    Arguments:
        silt: Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        plasticity_index: Plasticity index (upper minus lower plastic limit) expressed as percentage
            of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Plasticity index (upper minus lower plastic limit)
        Table IX, Group II, silt predictor, plasticity_index response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_plasticity_index_from_silt,
        silt,
        out=out,
    )

def calc_ptf_lal1979_group_ii_upper_plastic_limit_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate upper plastic limit for Group II.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        upper_plastic_limit: Upper plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Upper plastic limit
        Table IX, Group II, clay predictor, upper_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_upper_plastic_limit_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_ii_upper_plastic_limit_from_organic_carbon(
    *,
    organic_carbon: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate upper plastic limit for Group II.

    Arguments:
        organic_carbon: Organic carbon measured by Walkley and Black wet combustion; percentage of
            the fine earth. Full calibration bounds are not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        upper_plastic_limit: Upper plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Upper plastic limit
        Table IX, Group II, organic_carbon predictor, upper_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_upper_plastic_limit_from_organic_carbon,
        organic_carbon,
        out=out,
    )

def calc_ptf_lal1979_group_ii_upper_plastic_limit_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate upper plastic limit for Group II.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        upper_plastic_limit: Upper plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Upper plastic limit
        Table IX, Group II, sand predictor, upper_plastic_limit response.

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

def calc_ptf_lal1979_group_ii_upper_plastic_limit_from_silt(
    *,
    silt: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate upper plastic limit for Group II.

    Arguments:
        silt: Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        upper_plastic_limit: Upper plastic limit expressed as percentage of oven-dry soil mass. (%)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Upper plastic limit
        Table IX, Group II, silt predictor, upper_plastic_limit response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_upper_plastic_limit_from_silt,
        silt,
        out=out,
    )

def calc_ptf_lal1979_group_ii_water_01bar_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.1 bar suction for Group II.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_01bar: Gravimetric moisture retention at 0.1 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.1 bar suction
        Table V, Group II, clay predictor, water_01bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_water_01bar_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_ii_water_01bar_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.1 bar suction for Group II.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_01bar: Gravimetric moisture retention at 0.1 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.1 bar suction
        Table V, Group II, sand predictor, water_01bar response.

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

def calc_ptf_lal1979_group_ii_water_03bar_from_clay(
    *,
    clay: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.3 bar suction for Group II.

    Arguments:
        clay: Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are
            not reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_03bar: Gravimetric moisture retention at 0.3 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.3 bar suction
        Table V, Group II, clay predictor, water_03bar response.

    """
    return _call(
        _calc_ptf_lal1979_group_ii_water_03bar_from_clay,
        clay,
        out=out,
    )

def calc_ptf_lal1979_group_ii_water_03bar_from_sand(
    *,
    sand: float | ArrayLike,
    out: NDArray[floating] | None = None,
) -> floating | NDArray[floating]:
    """Estimate gravimetric moisture retention at 0.3 bar suction for Group II.

    Arguments:
        sand: Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not
            reported. (%)
        out: Optional output arrays for in-place calculation.

    Returns:
        water_03bar: Gravimetric moisture retention at 0.3 bar suction expressed per unit dry soil
            mass. (g g⁻¹)

    Territory:
        Group II: 12 profiles in Nigeria developed from arenaceous sedimentary rocks, partly
            Cretaceous and partly Lower Pleistocene.

    Notes:
        Prediction target: Gravimetric moisture retention at 0.3 bar suction
        Table V, Group II, sand predictor, water_03bar response.

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