unCalibrate: Uncalibrate a Radiocarbon date

Description Usage Arguments Value Examples

View source: R/unCalibrate.R

Description

Uncalibrate a Radiocarbon date

Usage

1
2
3
4
5
6
7
unCalibrate(
  calAges,
  calCurve = "intcal20",
  type = c("samples", "ages"),
  pathToCalCurves = system.file("data", package = "Bchron"),
  ...
)

Arguments

calAges

Either a vector of calibrated ages (when type = 'ages'), or a vector of calibrated samples (type = 'samples')

calCurve

he calibration curve to use. Only a single calibration curve is currently supported

type

Either 'ages' which uncalibrates a calibrated age values without error (i.e. just a lookup on the calibration curve), or a 'samples' which estimates both an uncalibrated mean age and a standard deviation

pathToCalCurves

The path to the calibration curve directory. Defaults to the location of the standard calibration curves given in the package

...

Other arguments to the optim function used to match the probability distributions under type = 'samples'

Value

Either a vector of uncalibrated ages (type = 'ages') or a list containing the estimated mean age and standard deviation (type = 'samples')

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# Single version outputting just an uncalibrated age
unCalibrate(2350, type = "ages")

# Vector version giving a vector of uncalibrated ages
unCalibrate(
  calAge = c(2350, 4750, 11440),
  calCurve = "shcal20",
  type = "ages"
)

# A version where calibrated standard deviations are required too
calAge <- BchronCalibrate(
  ages = 11255,
  ageSds = 25,
  calCurves = "intcal20"
)
calSampleAges <- sampleAges(calAge)

# Uncalibrate the above
unCalibrate(calSampleAges,
  type = "samples"
)

Bchron documentation built on June 10, 2021, 9:10 a.m.