geotech.lab.index.get_liquid_limit

DataFrame.geotech.lab.index.get_liquid_limit(trials=3)

Calculate and return the liquid limit according to ASTM D4318 Method A Multipoint Method.

This method computes the liquid limit by interpolating the moisture content at 25 drops using the logarithm of the number of drops and the corresponding moisture content values.

Requires:

liquid_limit_{n}_drops

liquid_limit_{n}_moisture_content

Parameters:

trials: int, default 3

The number of trials to be considered for interpolation.

Returns:

Series

Series with liquid limit values, calculated by interpolating the moisture content at 25 drops.

References

[1]

ASTM International. (2018). Standard test methods for liquid limit, plastic limit, and plasticity index of soils (ASTM D4318-17e1). https://doi.org/10.1520/D4318-17E01

Examples

>>> df = pd.DataFrame(
...     {
...         "point_id": ["BH-1"],
...         "bottom": [1.0],
...         "liquid_limit_1_drops": [23],
...         "liquid_limit_1_moisture_content": [48.1],
...         "liquid_limit_2_drops": [28],
...         "liquid_limit_2_moisture_content": [46.7],
...         "liquid_limit_3_drops": [33],
...         "liquid_limit_3_moisture_content": [46.1],
...     }
... )
>>> df.geotech.lab.index.get_liquid_limit(trials=3)
0    47.539917
Name: liquid_limit, dtype: Float64