# 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

 ```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 <[email protected]> and Kyle Elmy <[email protected]>

## 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) ```

geotech documentation built on May 29, 2017, 11:52 a.m.