geotech.lab.index.get_moisture_content#

DataFrame.geotech.lab.index.get_moisture_content(prefix='moisture_content')#

Calculate and return the moisture content according to ASTM D2216.

This method allows the use of prefix where it is possible to specify the prefix and name used for calculating the moisture content. This is useful for other moisture content applications like the Atterberg limits.

Requires:

{prefix}_mass_moist
{prefix}_mass_dry
{prefix}_mass_container
Parameters:
prefix: string, default “moisture_content”

Prefix to use for looking up the relevant columns. This is also used as the prefix of the name of the resulting series if using a non-default value.

Returns:
Series

Series with moisture content values.

Notes

In general, the moisture content, \(w\), is calculated by:

\[w = \frac{M_{cms} - M_{cds}}{M_{cds} - M_c} \times 100\]

where:

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

  • \(M_{cms} =\) mass of container and moist specimen, g,

  • \(M_{cds} =\) mass of container and oven dry specimen, g,

  • \(M_{c} =\) mass of container, g,

Note

ASTM D2216 offers two methods in determining the moisture content, however, the major difference is only in the rounding of the result (by 1% or 0.1%). This is not covered by this method so the user can provide their own rounding based on their specific use.

References

[1]

ASTM International. (2019). Standard test methods for laboratory determination of water (moisture) content of soil and rock by mass (ASTM D2216-19). https://doi.org/10.1520/D2216-19

Examples

Getting the moisture content:

>>> df = pd.DataFrame(
...     {
...         "point_id": ["BH-1"],
...         "bottom": [1.0],
...         "moisture_content_mass_moist": [236.44],
...         "moisture_content_mass_dry": [174.40],
...         "moisture_content_mass_container": [22.20],
...     }
... )
>>> df.geotech.lab.index.get_moisture_content(prefix="moisture_content")
0    40.762155
Name: moisture_content, dtype: float64

Getting the moisture content with prefix=”liquid_limit_1”:

>>> df = pd.DataFrame(
...     {
...         "point_id": ["BH-1"],
...         "bottom": [1.0],
...         "liquid_limit_1_mass_moist": [23.51],
...         "liquid_limit_1_mass_dry": [17.85],
...         "liquid_limit_1_mass_container": [3.30],
...     }
... )
>>> df.geotech.lab.index.get_moisture_content(prefix="liquid_limit_1")
0    38.900344
Name: liquid_limit_1_moisture_content, dtype: float64