add_physical_properties: Calculate physical properties of a soil specimen

In evanmascitti/soiltestr: Functions for Laboratory Soil Testing

Calculate physical properties of a soil specimen

Description

Generates all property values for every soil specimen in the data frame, i.e each row. Output can be easily piped to ggproctor() for plotting purposes.

Usage

add_physical_properties(x, mold_dimensions = NULL, cleat_mark = FALSE)

Arguments

x	a data frame containing relevant specimen data, see Details
mold_dimensions	data frame containing metadata about molds used in tests. If not supplied, looks for global option soiltestr.proctor_molds.
cleat_mark	Logical. Is this analysis for cleat-mark cylinders?

Details

\lifecycle

experimental \loadmathjax

The data passed in via x must contain specific gravity values (in a column named Gs), gravimetric water contents in a column named water_content, and the ambient test temperature (°C) in a column named ambient_temp_c. Water contents can be easily computed with add_w(). The use of generate_proctor_datasheet() ensures compatibility of the the column names used during data collection with those expected by this function.

The properties added to the data frame include moist and oven-dry soil mass in grams, moist and dry density (ρ) in g/cm³, total porosity (n), void ratio (e), and effective saturation (Se).

Value

mutated data frame with new columns, see details

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