BCADtoDelta14C: Find the Delta14C and error belonging to a cal BC/AD age.

In rice: Radiocarbon Equations

Find the Delta14C and error belonging to a cal BC/AD age.

Description

Given a calendar age, the calibration curve (default cc=1) is interpolated and the corresponding Delta14C value and error are returned.

Usage

BCADtoDelta14C(
  x,
  zero = TRUE,
  cc = 1,
  postbomb = FALSE,
  rule = 1,
  cc.dir = NULL,
  thiscurve = NULL,
  roundby = NA
)

Arguments

x	The cal BC/AD year.
zero	Whether or not zero BC/AD should be included. Defaults to zero=TRUE.
cc	calibration curve (see caldist()).
postbomb	Whether or not to use a postbomb curve (see caldist()).
rule	How should R's approx function deal with extrapolation. If rule=1, the default, then NAs are returned for such points and if it is 2, the value at the closest data extreme is used.
cc.dir	Directory of the calibration curves. Defaults to where the package's files are stored (system.file), but can be set to, e.g., cc.dir="curves".
thiscurve	As an alternative to providing cc and/or postbomb, the data of a specific curve can be provided (3 columns: cal BP, C14 age, error).
roundby	Amount of decimals required for the output. Defaults to roundby=NA, no rounding.

Details

Interpolation is used, and values outside the calibration curve are given as NA. For negative cal BP ages, a postbomb curve will have to be provided.

Value

The calibration-curve 14C year belonging to the entered cal BC/AD age.

Author(s)

Maarten Blaauw

Examples

  BCADtoDelta14C(1900)

rice documentation built on Sept. 9, 2025, 5:42 p.m.