w_opt: Fit a compaction curve, returning optimum water content only

View source: R/w_opt.R

w_optR Documentation

Fit a compaction curve, returning optimum water content only

Description

\lifecycle

stable \loadmathjax This is a convenient wrapper around proctor_fit() which returns only the optimum water content (at the effort used), derived from the compaction curve. This is useful when the user wants to perform a "quick-and-dirty" analysis and avoid additional indexing into the more verbose result of proctor_fit().

Usage

w_opt(df, ...)

Arguments

df

A tibble containing raw compaction data containing (at a minimum) columns "water_content", "filled_cylinder_mass_g", "empty_cylinder_mass_g", "cylinder_vol_cm3"

...

Other arguments passed on to proctor_fit()

Details

The compaction curve is fit using a natural spline, with the spline degree set by the user (defaults to cubic). Porosity is calculated using a default specific gravity value of 2.7, but this must be over-ridden with a measured \mjseqnG_s value if better control is required. The \mjseqnw_opt is computed by an optimization of the the spline function.

Value

w_opt The optimum water content for the present compaction effort

References

Proctor, 1932. Description of field and laboratory methods. Eng. News Record, 110:10, p. 286-289.

Standard effort: ASTM D698-12e2

Modified effort: ASTM D1557-12e1

See Also

proctor_fit(), d_max()


evanmascitti/soiltestr documentation built on Oct. 6, 2022, 5:32 p.m.