geotech (version 1.0)

indexParameters: Phase Diagrams and Index Parameters

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

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).

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.

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)