USCS: USCS Soil Classification

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/SoilClassification.R

Description

This set of functions classifies soil using the Unified Soil Classification System (USCS).

Usage

1
2
3
4
5
USCS(pg = NA, ps = NA, pf = NA, Cc = NA, Cu = NA,
     LL = NA, PL = NA, PI = NA, sieve = NA, size = NA,
     percent = NA, metric = NA)
USCS.fine.symbol(LL, PL, PI = NA)
USCS.coarse.symbol(pg, ps, pf, Cc, Cu, PI = NA, LL, PL)

Arguments

pg

percent gravel

ps

percent sand

pf

percent fines

Cu

coefficient of uniformity

Cc

coefficient of curvature

sieve

vector of sieve numbers (according to ASTM D422) in grain-size distribution

size

vector of grain sizes (in or mm) in distribution

percent

vector of percent passing in grain-size distribution

metric

logical variable for grain-size distribution: TRUE for metric units (mm), FALSE for English units (in); only required if "size" is supplied

LL

liquid limit (percent)

PL

plastic limit (percent)

PI

plasticity index (percent)

Details

The USCS function is the master function for performing soil classifications:

The USCS.fine.symbol and USCS.coarse.symbol are used to obtain the group symbols for fine-grained and coarse-grained soils, respectively. For USCS.fine.symbol, either PI or PL must be specified in addition to LL. For USCS.coarse.symbol:

Value

Author(s)

James Kaklamanos <kaklamanosj@merrimack.edu> and Kyle Elmy <ElmyK@merrimack.edu>

References

ASTM (2010). "Annual Book of ASTM Standards", Volume 04.08 – Soil and Rock, ASTM International, Philadelphia.

See Also

AASHTO, grainSize, Plasticity

Examples

1
2
## Example code for USCS
USCS(pg = 15, ps = 34, pf = 51, Cc = 1, Cu = 4, LL = 40, PL = 10)

Example output

$symbol
[1] "CL"

$name
[1] "Sandy lean clay with gravel"

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

Related to USCS in geotech...