ggplot_casagrande_preconsolidation: ggplot for Casagrande oedometer preconsolidation pressure

View source: R/oedometer.R

ggplot_casagrande_preconsolidationR Documentation

ggplot for Casagrande oedometer preconsolidation pressure

Description

Function to create a ggplot showing how Casagrande's method for determining the preconsolidation pressure from oedometer data works.

The point of maximum curvature is determined by fitting a bilinear curve with a hyperbolic transition area.

Usage

ggplot_casagrande_preconsolidation(
  sigma_v = c(5, 10, 20, 50, 100, 200, 500, 1000, 2000),
  e = c(0.94, 0.93, 0.92, 0.9, 0.88, 0.85, 0.8, 0.75, 0.71),
  xlim = c(4, NA),
  ylim = c(NA, NA),
  palette = "Set1",
  label_line = c("1", "2", "3", "4", "5", "sigma*minute[v*\",\"*c]"),
  stages = seq(6),
  include_value = TRUE,
  nsignif = 2
)

Arguments

sigma_v

array with oedometer stresses

e

array with void ratios

xlim, ylim

2-parameters arrays for x and y axes limits. If not defined, these limits are determined automatically

palette

RColorBrewer pallette for plot colors

label_line

array with six character strings, which will be parsed

  • string for tangent line at maximum curvature (1)

  • string for horizontal line (2)

  • string for bisection line between lines (1) and (2)

  • string for tangent line virgin behaviour (3)

  • string for vertical line down from intersection lines (3) and (4)

  • string for preconsolidation pressure label

stages

plot fitting stages (array with numbers)

  • 1: adds smooth trace through measurement points

  • 2: adds trangent at max curvature

  • 3: adds horizontal line at max curvature

  • 4: adds bisection line between 2 and 3

  • 5: adds tangent at virgin compression

  • 6: adds vertical at intersection of 4 and 5

include_value

if TRUE, the value of the preconsolidation pressure is added to the plotted label

nsignif

the number of significant digits to use in the (rounded) value of the show preconsolidation pressure (if include_value = TRUE)

Examples

#all stages
ggplot_casagrande_preconsolidation()

#stage by stage
ggplot_casagrande_preconsolidation(stages = c())
ggplot_casagrande_preconsolidation(stages = seq(1))
ggplot_casagrande_preconsolidation(stages = seq(2))
ggplot_casagrande_preconsolidation(stages = seq(3))
ggplot_casagrande_preconsolidation(stages = seq(4))
ggplot_casagrande_preconsolidation(stages = seq(5))
ggplot_casagrande_preconsolidation(stages = seq(6))

GJMeijer/soilmech documentation built on May 22, 2022, 10:39 a.m.