sand_w_scr_mix_calcs: Calculate component masses for a 3-way soil mixture

In evanmascitti/soiltestr: Functions for Laboratory Soil Testing

Calculate component masses for a 3-way soil mixture

Description

Computations are based on desired sand content and silt-to-clay ratio of the final mixture

Usage

sand_w_scr_mix_calcs(
  x = NULL,
  mix_date,
  final_OD_kg,
  sample_name = NULL,
  sandy_name = NULL,
  silty_name = NULL,
  clayey_name = NULL,
  final_sand_pct,
  final_scr,
  sand_sandy,
  silt_sandy,
  clay_sandy,
  sand_silty,
  silt_silty,
  clay_silty,
  sand_clayey,
  silt_clayey,
  clay_clayey,
  w_sandy,
  w_silty,
  w_clayey,
  ...
)

Arguments

x	data frame containing the relevant columns. If NULL (the default), user must supply each argument below.
mix_date	Character.
final_OD_kg	Numeric. Final oven-dry mass of mixture.
sandy_name	Character. Name of sandy soil component.
silty_name	Character. Name of siltiest soil component.
clayey_name	Character. Name of clayey soil component.
final_sand_pct	Numeric (decimal). Desired mass percent of sand-size particles.
final_scr	Numeric. Desired silt-to-clay ratio of final mixture.
sand_sandy	Numeric (decimal). Sand-size content of sandy component.
silt_sandy	Numeric (decimal). Sand-size content of silty component.
clay_sandy	Numeric (decimal). Sand-size content of clayey component.
sand_silty	Numeric (decimal). Silt-size content of sandy component.
silt_silty	Numeric (decimal). Silt-size content of silty component.
clay_silty	Numeric (decimal). Silt-size content of clayey component
sand_clayey	Numeric (decimal). Clay-size content of sandy component.
silt_clayey	Numeric (decimal). Clay-size content of silty component.
clay_clayey	Numeric (decimal). Clay-size content of clayey component
w_sandy	Numeric (decimal). Water content of sandy component.
w_silty	Numeric (decimal). Water content of sandy component.
w_clayey	Numeric (decimal). Water content of sandy component.
...	Other arguments passed to methods (currently ignored)
mix_name	Character, if NULL a name is constructed as "sandy_name-silty-name-clayey_name-scr-final_scr_final_sand_content"

Examples

mix_sheet <- sand_w_scr_mix_calcs(
  x = NULL,
  mix_date = Sys.Date(),
  final_OD_kg = 30,
  sample_name = NULL,
  sandy_name = 'my-angular-sand-',
  silty_name = 'crushed-quartz',
  clayey_name = c('tile-clay', 'gumbo-clay'),
  final_sand_pct = 0.6,
  final_scr = 1,
  sand_sandy = 0.98,
  silt_sandy = 0.01,
  clay_sandy = 0.01,
  sand_silty = 0.04,
  silt_silty = 0.88,
  clay_silty = 0.08,
  sand_clayey = c(0.01, 0.57),
  silt_clayey = c(0.29, 0.17),
  clay_clayey = c(0.7, 0.26),
  w_sandy = 0.001,
  w_silty = 0.0001,
  w_clayey = c(0.02, 0.01)
)

evanmascitti/soiltestr documentation built on Oct. 6, 2022, 5:32 p.m.