geotech.lab.index.get_liquidity_index#

DataFrame.geotech.lab.index.get_liquidity_index()#

Calculate and return the liquidity index.

The liquidity index is calculated as the ratio of the natural moisture content minus the plastic limit to the plasticity index.

Requires:

moisture_content
plastic_limit
plasticity_index
Returns:
Series

Series with liquidity index values.

Notes

The liquidity index is defined as:

\[LI = \frac{w - PL}{PI}\]

where:

  • \(LI =\) liquidity index,

  • \(w =\) natural moisture content, %,

  • \(PL =\) plastic limit, %,

  • \(PI =\) plasticity index, %.

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],
...         "moisture_content": [30.0],
...         "plastic_limit": [25.3],
...         "plasticity_index": [22.2],
...     }
... )
>>> df.geotech.lab.index.get_liquidity_index()
0    0.211712
Name: liquidity_index, dtype: Float64