c14_calibrate: Calibrate radiocarbon dates

In joeroe/c14: Tidy Radiocarbon Data

Calibrate radiocarbon dates

Description

Transforms 'raw' radiocarbon ages into a calendar probability distribution using a calibration curve.

Usage

c14_calibrate(
  c14_age,
  c14_error,
  ...,
  engine = c("intcal", "rcarbon", "oxcal", "bchron"),
  min_pdens = 1e-05
)

Arguments

c14_age	Vector of uncalibrated radiocarbon ages.
c14_error	Vector of standard errors associated with c14_age.
...	Optional arguments passed to calibration function (see below).
engine	Method to use for calibration. The default ("intcal") is fast and simple. Other options require additional packages to be installed. Available engines: "intcal": IntCal::caldist() (default) "rcarbon": rcarbon::calibrate() "oxcal": oxcAAR::oxcalCalibrate() "bchron": Bchron::BchronCalibrate()
min_pdens	Minimum probability density threshold below which ages are excluded from the result. Set to NULL to use the full calibration curve.

Details

c14_age and c14_error are recycled to a common length.

Parallelisation is supported for engines "intcal" and "rcarbon" and can dramatically speed up calibration of large numbers of dates. For "intcal", it must first be enabled with future::plan(). For "rcarbon", it requires the doSNOW package and can be controlled with the ncores argument of rcarbon::calibrate().

Value

A list of cal objects.

Examples

c14_calibrate(1000, 30)

joeroe/c14 documentation built on Nov. 24, 2024, 11:47 p.m.