Skip to content

ptfkit.lal1979

import ptfkit.lal1979;

Exported namespace: ptfkit::lal1979

Moisture retention and plasticity regressions for two groups of Nigerian soils.

Source

Lal, R. (1979). Physical properties and moisture retention characteristics of some Nigerian soils. Geoderma, 21, 209-223.

DOI: 10.1016/0016-7061(78)90028-9

Scope

Territory: Nigeria

Dataset: 119 genetic-horizon samples from 23 profiles in two parent-material groups.

PTF catalog page

Functions

calc_ptf_lal1979_group_i_water_0bar_from_clay

Estimate gravimetric moisture retention at saturation for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_0bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IV, Group I, clay predictor, water_0bar response.

calc_ptf_lal1979_group_i_water_0bar_from_sand

Estimate gravimetric moisture retention at saturation for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_0bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IV, Group I, sand predictor, water_0bar response.

calc_ptf_lal1979_group_ii_water_0bar_from_clay

Estimate gravimetric moisture retention at saturation for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_0bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IV, Group II, clay predictor, water_0bar response.

calc_ptf_lal1979_group_ii_water_0bar_from_sand

Estimate gravimetric moisture retention at saturation for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_0bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IV, Group II, sand predictor, water_0bar response.

calc_ptf_lal1979_group_i_water_01bar_from_clay

Estimate gravimetric moisture retention at 0.1 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_01bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group I, clay predictor, water_01bar response.

calc_ptf_lal1979_group_i_water_03bar_from_clay

Estimate gravimetric moisture retention at 0.3 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_03bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group I, clay predictor, water_03bar response.

calc_ptf_lal1979_group_i_water_01bar_from_sand

Estimate gravimetric moisture retention at 0.1 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_01bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group I, sand predictor, water_01bar response.

calc_ptf_lal1979_group_i_water_03bar_from_sand

Estimate gravimetric moisture retention at 0.3 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_03bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group I, sand predictor, water_03bar response.

calc_ptf_lal1979_group_ii_water_01bar_from_clay

Estimate gravimetric moisture retention at 0.1 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_01bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group II, clay predictor, water_01bar response.

calc_ptf_lal1979_group_ii_water_03bar_from_clay

Estimate gravimetric moisture retention at 0.3 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_03bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group II, clay predictor, water_03bar response.

calc_ptf_lal1979_group_ii_water_01bar_from_sand

Estimate gravimetric moisture retention at 0.1 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_01bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group II, sand predictor, water_01bar response.

calc_ptf_lal1979_group_ii_water_03bar_from_sand

Estimate gravimetric moisture retention at 0.3 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_03bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table V, Group II, sand predictor, water_03bar response.

calc_ptf_lal1979_group_i_water_15bar_from_clay

Estimate gravimetric moisture retention at 15 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_15bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VI, Group I, clay predictor, water_15bar response.

calc_ptf_lal1979_group_i_water_15bar_from_sand

Estimate gravimetric moisture retention at 15 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_15bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VI, Group I, sand predictor, water_15bar response.

calc_ptf_lal1979_group_i_water_15bar_from_silt

Estimate gravimetric moisture retention at 15 bar suction for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_water_15bar_from_silt(double silt)

Parameters

Name Description
silt Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VI, Group I, silt predictor, water_15bar response.

calc_ptf_lal1979_group_ii_water_15bar_from_clay

Estimate gravimetric moisture retention at 15 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_15bar_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VI, Group II, clay predictor, water_15bar response.

calc_ptf_lal1979_group_ii_water_15bar_from_sand

Estimate gravimetric moisture retention at 15 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_15bar_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VI, Group II, sand predictor, water_15bar response.

calc_ptf_lal1979_group_i_moisture_equivalent_from_clay

Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_moisture_equivalent_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VII, Group I, clay predictor, moisture_equivalent response.

calc_ptf_lal1979_group_i_moisture_equivalent_from_sand

Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_moisture_equivalent_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VII, Group I, sand predictor, moisture_equivalent response.

calc_ptf_lal1979_group_ii_moisture_equivalent_from_clay

Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_moisture_equivalent_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VII, Group II, clay predictor, moisture_equivalent response.

calc_ptf_lal1979_group_ii_moisture_equivalent_from_sand

Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_moisture_equivalent_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VII, Group II, sand predictor, moisture_equivalent response.

calc_ptf_lal1979_group_ii_moisture_equivalent_from_silt

Estimate gravimetric moisture equivalent measured at 1000 times gravity for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_moisture_equivalent_from_silt(double silt)

Parameters

Name Description
silt Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table VII, Group II, silt predictor, moisture_equivalent response.

calc_ptf_lal1979_group_ii_water_03bar_from_water_01bar

Estimate gravimetric moisture retention at 0.3 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_03bar_from_water_01bar(double water_01bar)

Parameters

Name Description
water_01bar Gravimetric moisture retention at 0.1 bar suction on disturbed soil. (g/g)

Returns

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

Note

Table VIII, Group II, water_01bar predictor, water_03bar response.

calc_ptf_lal1979_group_ii_water_15bar_from_water_01bar

Estimate gravimetric moisture retention at 15 bar suction for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_water_15bar_from_water_01bar(double water_01bar)

Parameters

Name Description
water_01bar Gravimetric moisture retention at 0.1 bar suction on disturbed soil. (g/g)

Returns

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

Note

Table VIII, Group II, water_01bar predictor, water_15bar response.

calc_ptf_lal1979_group_i_upper_plastic_limit_from_organic_carbon

Estimate upper plastic limit for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_upper_plastic_limit_from_organic_carbon(double organic_carbon)

Parameters

Name Description
organic_carbon Organic carbon measured by Walkley and Black wet combustion; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, organic_carbon predictor, upper_plastic_limit response.

calc_ptf_lal1979_group_i_lower_plastic_limit_from_organic_carbon

Estimate lower plastic limit for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_lower_plastic_limit_from_organic_carbon(double organic_carbon)

Parameters

Name Description
organic_carbon Organic carbon measured by Walkley and Black wet combustion; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, organic_carbon predictor, lower_plastic_limit response.

calc_ptf_lal1979_group_i_plasticity_index_from_organic_carbon

Estimate plasticity index (upper minus lower plastic limit) for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_plasticity_index_from_organic_carbon(double organic_carbon)

Parameters

Name Description
organic_carbon Organic carbon measured by Walkley and Black wet combustion; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, organic_carbon predictor, plasticity_index response.

calc_ptf_lal1979_group_i_upper_plastic_limit_from_clay

Estimate upper plastic limit for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_upper_plastic_limit_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, clay predictor, upper_plastic_limit response.

calc_ptf_lal1979_group_i_lower_plastic_limit_from_clay

Estimate lower plastic limit for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_lower_plastic_limit_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, clay predictor, lower_plastic_limit response.

calc_ptf_lal1979_group_i_plasticity_index_from_clay

Estimate plasticity index (upper minus lower plastic limit) for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_plasticity_index_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, clay predictor, plasticity_index response.

calc_ptf_lal1979_group_i_lower_plastic_limit_from_sand

Estimate lower plastic limit for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_lower_plastic_limit_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, sand predictor, lower_plastic_limit response.

calc_ptf_lal1979_group_i_plasticity_index_from_sand

Estimate plasticity index (upper minus lower plastic limit) for Group I.

[[nodiscard]]
inline double calc_ptf_lal1979_group_i_plasticity_index_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group I, sand predictor, plasticity_index response.

calc_ptf_lal1979_group_ii_upper_plastic_limit_from_organic_carbon

Estimate upper plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_upper_plastic_limit_from_organic_carbon(double organic_carbon)

Parameters

Name Description
organic_carbon Organic carbon measured by Walkley and Black wet combustion; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, organic_carbon predictor, upper_plastic_limit response.

calc_ptf_lal1979_group_ii_plasticity_index_from_organic_carbon

Estimate plasticity index (upper minus lower plastic limit) for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_plasticity_index_from_organic_carbon(double organic_carbon)

Parameters

Name Description
organic_carbon Organic carbon measured by Walkley and Black wet combustion; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, organic_carbon predictor, plasticity_index response.

calc_ptf_lal1979_group_ii_upper_plastic_limit_from_clay

Estimate upper plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_upper_plastic_limit_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, clay predictor, upper_plastic_limit response.

calc_ptf_lal1979_group_ii_lower_plastic_limit_from_clay

Estimate lower plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_lower_plastic_limit_from_clay(double clay)

Parameters

Name Description
clay Clay smaller than 0.002 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, clay predictor, lower_plastic_limit response.

calc_ptf_lal1979_group_ii_upper_plastic_limit_from_sand

Estimate upper plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_upper_plastic_limit_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, sand predictor, upper_plastic_limit response.

calc_ptf_lal1979_group_ii_lower_plastic_limit_from_sand

Estimate lower plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_lower_plastic_limit_from_sand(double sand)

Parameters

Name Description
sand Sand from 0.02 to 2 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, sand predictor, lower_plastic_limit response.

calc_ptf_lal1979_group_ii_upper_plastic_limit_from_silt

Estimate upper plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_upper_plastic_limit_from_silt(double silt)

Parameters

Name Description
silt Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, silt predictor, upper_plastic_limit response.

calc_ptf_lal1979_group_ii_lower_plastic_limit_from_silt

Estimate lower plastic limit for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_lower_plastic_limit_from_silt(double silt)

Parameters

Name Description
silt Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, silt predictor, lower_plastic_limit response.

calc_ptf_lal1979_group_ii_plasticity_index_from_silt

Estimate plasticity index (upper minus lower plastic limit) for Group II.

[[nodiscard]]
inline double calc_ptf_lal1979_group_ii_plasticity_index_from_silt(double silt)

Parameters

Name Description
silt Silt from 0.002 to 0.02 mm; percentage of the fine earth. Full calibration bounds are not reported. (%)

Returns

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

Note

Table IX, Group II, silt predictor, plasticity_index response.