c14bazAAR (version 1.2.0)

calibrate: Calibrate all valid dates in a c14_date_list

Description

Calibrate all dates in a c14_date_list with Bchron::BchronCalibrate(). The function provides two different kinds of output variables that are added as new list columns to the input c14_date_list: calprobdistr and calrange. calrange is accompanied by sigma. See ?Bchron::BchronCalibrate and ?c14bazAAR:::hdr for some more information. calprobdistr: The probability distribution of the individual date for all ages with an individual probability >= 1e-06. For each date there's a data.frame with the columns calage and density. calrange: The contiguous ranges which cover the probability interval requested for the individual date. For each date there's a data.frame with the columns dens and from and to.

Usage

calibrate(x, choices = c("calrange"), sigma = 2, ...)
# S3 method for default
calibrate(x, choices = c("calrange"), sigma = 2, ...)
# S3 method for c14_date_list
calibrate(x, choices = c("calrange"), sigma = 2, ...)

Arguments

x

an object of class c14_date_list

choices

whether the result should include the full calibrated probability dataframe ('calprobdistr') or the sigma range ('calrange'). Both arguments may be given at the same time.

sigma

the desired sigma value (1,2,3) for the calibrated sigma ranges

...

passed to Bchron::BchronCalibrate()

Value

an object of class c14_date_list with the additional columns calprobdistr or calrange and sigma

Examples

# NOT RUN {
calibrate(
  example_c14_date_list,
  choices = c("calprobdistr", "calrange"),
  sigma = 1
)

# }