ptfkit.varallyai1982

def calc_ptf_varallyai1982_chernozem_a(
    *,
    bulk_density: float | ArrayLike,
    fine_fraction: float | ArrayLike,
    out: Varallyai1982Parameters[NDArray[floating]] | None = None,
) -> Varallyai1982Parameters[floating] | Varallyai1982Parameters[NDArray[floating]]:
    r"""Estimate equation (9) water-retention parameters for chernozem A horizons.

    Arguments:
        bulk_density: Undisturbed-soil bulk density. (g/cm^3)
        fine_fraction: Fine-particle mass fraction reported as particles smaller than 0.002 mm.
            (fraction)
        out: Optional output arrays for in-place calculation.

    Returns:
        Varallyai1982Parameters: Results grouped by result attributes.

    Territory:
        Hungary, mainly the Hungarian Plain

    Models:
        $h(\theta)$: theta = theta_0 / (1 + (psi / psi_*)^m)

    Notes:
        Prediction target: Parameters of the equation (9) water-retention model for chernozem A
            horizons.
        Equation (15) applies to chernozem A horizons.
        The source reports 95% relative errors of 10% for theta_0, 29% for m, and 18% for pF_*.

    Warning:
        Use is described as approximate by the source.
        The source does not report exact calibration ranges; avoid extrapolation beyond comparable
            Hungarian chernozem A horizons.

    """
    values = _call(
        _calc_ptf_varallyai1982_chernozem_a,
        bulk_density,
        fine_fraction,
        out=out,
    )

    return Varallyai1982Parameters(*values)

def calc_ptf_varallyai1982_chernozem_b(
    *,
    bulk_density: float | ArrayLike,
    fine_fraction: float | ArrayLike,
    out: Varallyai1982Parameters[NDArray[floating]] | None = None,
) -> Varallyai1982Parameters[floating] | Varallyai1982Parameters[NDArray[floating]]:
    r"""Estimate equation (9) water-retention parameters for chernozem B horizons.

    Arguments:
        bulk_density: Undisturbed-soil bulk density. (g/cm^3)
        fine_fraction: Fine-particle mass fraction reported as particles smaller than 0.002 mm.
            (fraction)
        out: Optional output arrays for in-place calculation.

    Returns:
        Varallyai1982Parameters: Results grouped by result attributes.

    Territory:
        Hungary, mainly the Hungarian Plain

    Models:
        $h(\theta)$: theta = theta_0 / (1 + (psi / psi_*)^m)

    Notes:
        Prediction target: Parameters of the equation (9) water-retention model for chernozem B
            horizons.
        Equation (16) applies to chernozem B horizons.
        The source reports 95% relative errors of 11% for theta_0, 34% for m, and 18% for pF_*.

    Warning:
        Use is described as approximate by the source.
        The source does not report exact calibration ranges; avoid extrapolation beyond comparable
            Hungarian chernozem B horizons.

    """
    values = _call(
        _calc_ptf_varallyai1982_chernozem_b,
        bulk_density,
        fine_fraction,
        out=out,
    )

    return Varallyai1982Parameters(*values)

def calc_ptf_varallyai1982_chernozem_c(
    *,
    bulk_density: float | ArrayLike,
    fine_fraction: float | ArrayLike,
    out: Varallyai1982Parameters[NDArray[floating]] | None = None,
) -> Varallyai1982Parameters[floating] | Varallyai1982Parameters[NDArray[floating]]:
    r"""Estimate equation (9) water-retention parameters for chernozem C horizons.

    Arguments:
        bulk_density: Undisturbed-soil bulk density. (g/cm^3)
        fine_fraction: Fine-particle mass fraction reported as particles smaller than 0.002 mm.
            (fraction)
        out: Optional output arrays for in-place calculation.

    Returns:
        Varallyai1982Parameters: Results grouped by result attributes.

    Territory:
        Hungary, mainly the Hungarian Plain

    Models:
        $h(\theta)$: theta = theta_0 / (1 + (psi / psi_*)^m)

    Notes:
        Prediction target: Parameters of the equation (9) water-retention model for chernozem C
            horizons.
        Equation (17) applies to chernozem C horizons.
        The source reports 95% relative errors of 7% for theta_0, 22% for m, and 11% for pF_*.

    Warning:
        Use is described as approximate by the source.
        The source does not report exact calibration ranges; avoid extrapolation beyond comparable
            Hungarian chernozem C horizons.

    """
    values = _call(
        _calc_ptf_varallyai1982_chernozem_c,
        bulk_density,
        fine_fraction,
        out=out,
    )

    return Varallyai1982Parameters(*values)

def calc_ptf_varallyai1982_meadow(
    *,
    bulk_density: float | ArrayLike,
    fine_sand_fraction: float | ArrayLike,
    fine_fraction: float | ArrayLike,
    out: Varallyai1982Parameters[NDArray[floating]] | None = None,
) -> Varallyai1982Parameters[floating] | Varallyai1982Parameters[NDArray[floating]]:
    r"""Estimate equation (9) water-retention parameters for meadow-series soils.

    Arguments:
        bulk_density: Undisturbed-soil bulk density. (g/cm^3)
        fine_sand_fraction: Mass fraction in the 0.25-0.05 mm particle-size class. (fraction)
        fine_fraction: Fine-particle mass fraction reported as particles smaller than 0.002 mm.
            (fraction)
        out: Optional output arrays for in-place calculation.

    Returns:
        Varallyai1982Parameters: Results grouped by result attributes.

    Territory:
        Hungary, mainly the Hungarian Plain

    Models:
        $h(\theta)$: theta = theta_0 / (1 + (psi / psi_*)^m)

    Notes:
        Prediction target: Parameters of the equation (9) water-retention model.
        Equation (14) was fitted to 68 meadow-series soil samples.
        S and C are fractions of one, while bulk density is in g/cm^3.
        The source reports 95% relative errors of 14% for theta_0, 34% for m, and 25% for pF_*.

    Warning:
        Use is described as approximate by the source.
        The source does not report exact calibration ranges; avoid extrapolation beyond comparable
            Hungarian meadow-series soils.

    """
    values = _call(
        _calc_ptf_varallyai1982_meadow,
        bulk_density,
        fine_sand_fraction,
        fine_fraction,
        out=out,
    )

    return Varallyai1982Parameters(*values)