geotech.lab.index.get_moisture_content#

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

Return moisture content calculation according to ASTM D2216.

Requires:

moisture_content_mass_moist
moisture_content_mass_dry
moisture_content_mass_container

Returns:

Series: moisture_content

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()
0    40.762155
Name: moisture_content, dtype: float64