indexParameters: Phase Diagrams and Index Parameters

In geotech: Geotechnical Engineering

Description

These functions compute and plot phase diagrams and index parameters associated with a soil's composition.

Usage

phase.plot(Ws, Ww, Vs, Vw, Va, W.unit, V.unit, mass = FALSE)
phase.params(Ws, Ww, Vs, Vw, Va)
waterContent(M1, M2, Mc)
relDensity(e, emax, emin)

Arguments

Ws	Weight of solids
Ww	Weight of water
Vs	Volume of solids
Vw	Volume of water
Va	Volume of air
W.unit	Measurement unit of weights
V.unit	Measurement unit of volume
mass	logical variable: TRUE for masses or FALSE for weights (default)
M1	Mass (or weight) of can and wet soil, before drying in oven
M2	Mass (or weight) of can and dry soil, after drying in oven
Mc	Mass (or weight) of can
e	Void ratio
emax	Maximum void ratio
emin	Minimum void ratio

Details

• In phase.plot, if any parameters are zero, please enter "0"; do not leave them blank.

• In waterContent, either masses or weights may be used, because the units cancel.

Value

• phase.plot plots phase diagrams from weights (or masses) and volumes of a soil sample. No numerical output is provided.

• phase.params calculates a ten-element list of index parameters from provided weights and volumes of a soil sample:

  1. w = water content (as decimal)

  2. S = degree of saturation (as decimal)

  3. e = void ratio (as decimal)

  4. n = porosity (as decimal)

  5. Gs = specific gravity

  6. gammaT = total unit weight

  7. gammaD = dry unit weight

  8. gammaS = unit weight of solids

  9. gammaW = unit weight of water

  10. gammaB = buoyant unit weight

• waterContent calculates the water content (as a decimal) from lab results (i.e., measured weights or masses)

• relDensity calculates the relative density (as a decimal) from specified void ratios (e, emax, and emin).

Note

The phase diagram in phase.plot is currently not to scale; this may be edited in the future to allow this functionality.

Author(s)

James Kaklamanos <[e-mail]> and Kyle Elmy <[e-mail]>

Examples

##  Example of phase diagram plot:
phase.plot(Ws = 75.8, Ww = 15.6, Vs = 0.45, Vw = 0.25,
           Va = 0.1, W.unit = "lb", V.unit = "ft^3", mass = FALSE)

##  Example of index parameters function:
phase.params(Ws = 75.8, Ww = 15.6, Vs = 0.45, Vw = 0.25, Va = 0.1)

##  Example of water content function:
waterContent(M1 = 20.68, M2 = 18.14, Mc = 8.20)

##  Example of relative density function:
relDensity(e = 0.3, emax = 0.92, emin = 0.35)

geotech documentation built on May 1, 2019, 9:09 p.m.