Skip to contents

Soil expansion potential chart

Source: R/soil_expansion.R
soil_expansion.Rd

Draws a soil expansion potential chart—plasticity index vs clay percentage—with four boundary curves that separate the zones of low, medium, high, and very high expansion potential.

Usage

soil_expansion(lang = "en")

Arguments

lang

Character. Language for axis titles: "en" (default) for English, "es" for Spanish.

Value

A ggplot object with clay percentage on the x-axis and plasticity index on the y-axis, containing the four expansion potential boundary curves and their zone labels.

References

Holtz, R. D., Kovacs, W. D., & Sheahan, T. C. (2023). An Introduction to Geotechnical Engineering (3rd ed.). Pearson Education.

See also

Other classification plots, soil mechanics: Casagrande_chart(), clay_activity(), soil_collapse(), soil_swelling(), ternary_shepard(), ternary_usda()

Examples

# English labels (default)
soil_expansion()


dat = data.frame(
  clay = c(20, 40, 60),
  pi = c(10, 23, 40),
  loc = c("A", "B", "C")
)
# Spanish labels
soil_expansion(lang = "es") +
ggplot2::geom_point(data = dat,
                     ggplot2::aes(x = clay, y = pi, color = loc),
                     size = 3,
                     inherit.aes = FALSE # needed
                    )