Bacon.hist: Calculate age distributions of depths.

In rbacon: Age-Depth Modelling using Bayesian Statistics

Calculate age distributions of depths.

Description

Calculate the distribution of age estimates of single or multiple depths.

Usage

Bacon.hist(
  d,
  set = get("info"),
  BCAD = set$BCAD,
  age.lab = c(),
  age.lim = c(),
  hist.lab = "Frequency",
  calc.range = TRUE,
  hist.lim = c(),
  draw = TRUE,
  prob = set$prob,
  hist.col = grey(0.5),
  hist.border = grey(0.2),
  range.col = "blue",
  med.col = "green",
  mean.col = "red",
  verbose = TRUE,
  save.info = FALSE
)

Arguments

d	The depth or depths for which a histogram and age ranges should be provided. If multiple depths are given, then just the age ranges, median and means (no graphs) are provided for each depth.
set	Detailed information of the current run, stored within this session's memory as variable info.
BCAD	The calendar scale of graphs and age output-files is in cal BP by default, but can be changed to BC/AD using BCAD=TRUE.
age.lab	The labels for the calendar axis (default age.lab="cal BP" or "BC/AD" if BCAD=TRUE).
age.lim	Minimum and maximum calendar age ranges, calculated automatically by default (age.lim=c()).
hist.lab	The y-axis is labelled ylab="Frequency" by default.
calc.range	Calculate ranges? Takes time so can be left out
hist.lim	Limits of the y-axis.
draw	Draw a plot or not. Defaults to draw=TRUE, however no plots are made if more than one depth d is provided. If draw=FALSE, then the age ranges, median and mean are given for each depth (as four columns).
prob	Age ranges are given as quantiles, e.g., 2.5% and 97.5% for the default of 95% confidence limits (prob=0.95)).
hist.col	Colour of the histogram. Default grey, hist.col=grey(0.5).
hist.border	Colour of the histogram's outline. Default dark grey, hist.border=grey(0.2).
range.col	Colour of confidence ranges. Defaults to range.col="blue".
med.col	Colour of the median. Defaults to med.col="green".
mean.col	Colour of the mean. Defaults to mn.col="red".
verbose	Provide feedback on what is happening (default verbose=TRUE).
save.info	A variable called ‘info’ with relevant information about the run (e.g., core name, priors, settings, ages, output) can be saved into the working directory. Note that this will overwrite any existing variable with the same name - as an alternative, one could run, e.g., myvar <- Bacon(), followed by supplying the variable myvar in any subsequent commands.

Details

Age estimates of specific depths can also be plotted.

Value

A local variable called ‘hists’, and a plot with the histogram and the age ranges, median and mean, or just the age ranges, medians and means if more than one depth d is given.

Author(s)

Maarten Blaauw, J. Andres Christen

Examples

## Not run: 
  Bacon(run=FALSE, coredir=tempfile())
  agedepth(age.res=50, d.res=50, d.by=10)
  Bacon.hist(20)
  Bacon.hist(20:30)

## End(Not run)

rbacon documentation built on Sept. 30, 2024, 9:40 a.m.