Phase Diagrams and Index Parameters

Share:

Description

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

Usage

1
2
3
4
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 <kaklamanosj@merrimack.edu> and Kyle Elmy <ElmyK@merrimack.edu>

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
##  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)