calib.plot: Plot the dates

View source: R/calibrate.R

calib.plotR Documentation

Plot the dates

Description

Produce a plot of the dated depths and their dates

Usage

calib.plot(
  set = get("info"),
  dets = set$dets,
  accordion = c(),
  BCAD = set$BCAD,
  cc = set$cc,
  rotate.axes = FALSE,
  rev.d = FALSE,
  rev.age = FALSE,
  rev.yr = rev.age,
  age.lim = c(),
  yr.lim = age.lim,
  date.res = 100,
  d.lab = c(),
  age.lab = c(),
  yr.lab = age.lab,
  height = 1,
  calheight = 1,
  mirror = TRUE,
  up = TRUE,
  cutoff = 0.1,
  C14.col = rgb(0, 0, 1, 0.5),
  C14.border = rgb(0, 0, 1, 0.75),
  cal.col = rgb(0, 0.5, 0.5, 0.5),
  cal.border = rgb(0, 0.5, 0.5, 0.75),
  dates.col = c(),
  slump.col = grey(0.8),
  new.plot = TRUE,
  plot.dists = TRUE,
  same.heights = FALSE
)

Arguments

set

Detailed information of the current run, stored within this session's memory as variable info.

dets

The set of determinations to be plotted.

accordion

If depths have to be squeezed/stretched, the parameters can be set here. Defaults to being empty, but requires 2 parameters if active, e.g., accordion=c(10,20).

BCAD

The calendar scale of graphs is in cal BP by default, but can be changed to BC/AD using BCAD=TRUE.

cc

Calibration curve to be used (defaults to info$cc)

rotate.axes

The default of plotting age on the horizontal axis and event probability on the vertical one can be changed with rotate.axes=TRUE.

rev.d

The direction of the depth axis can be reversed from the default (rev.d=TRUE).

rev.age

The direction of the calendar age axis can be reversed from the default (rev.age=TRUE)

rev.yr

Deprecated - use rev.age instead

age.lim

Minimum and maximum calendar age ranges, calculated automatically by default (age.lim=c()).

yr.lim

Deprecated - use age.lim instead

date.res

Date distributions are plotted using date.res=100 points by default.

d.lab

The labels for the depth axis. Default d.lab="Depth (cm)".

age.lab

The labels for the calendar axis (default yr.lab="cal BP" or "BC/AD" if BCAD=TRUE).

yr.lab

Deprecated - use age.lab instead

height

The heights of the distributions of the dates. See also normalise.dists.

calheight

Multiplier for the heights of the distributions of dates on the calendar scale. Defaults to calheight=1.

mirror

Plot the dates as 'blobs'. Set to mirror=FALSE to plot simple distributions.

up

Directions of distributions if they are plotted non-mirrored. Default up=TRUE.

cutoff

Avoid plotting very low probabilities of date distributions (default cutoff=0.1).

C14.col

Colour of the calibrated distributions of the dates. Default is semi-transparent blue: rgb(0,0,1,.35).

C14.border

Colours of the borders of calibrated 14C dates. Default is transparent dark blue: cal.col

cal.col

Colour of the non-14C dates in the age-depth plot: default semi-transparent blue-green: rgb(0,.5,.5,.35).

cal.border

Colour of the of the border of non-14C dates in the age-depth plot: default semi-transparent dark blue-green: rgb(0,.5,.5,.5).

dates.col

As an alternative to colouring dates based on whether they are 14C or not, sets of dates can be coloured as, e.g., dates.col=colours()[2:100].

slump.col

Colour of slumps. Defaults to slump.col=grey(0.8).

new.plot

Start a new plot (new.plot=TRUE) or plot over an existing plot (new.plot=FALSE).

plot.dists

Plot the distributions of the dates (default plot.dists=TRUE).

same.heights

Plot the distributions of the dates all at the same maximum height (default same.height=FALSE), which instead normalises the distributions (all have an area of 1).

Details

This function is generally called internally to produce the age-depth graph. It can be used to produce custom-built graphs.

Value

NA

Author(s)

Maarten Blaauw, J. Andres Christen

Examples

  Bacon(run=FALSE, coredir=tempfile())
  calib.plot()

rbacon documentation built on July 26, 2023, 5:35 p.m.