# Phase Diagrams and Index Parameters

### 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:w = water content (as decimal)

S = degree of saturation (as decimal)

e = void ratio (as decimal)

n = porosity (as decimal)

Gs = specific gravity

gammaT = total unit weight

gammaD = dry unit weight

gammaS = unit weight of solids

gammaW = unit weight of water

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