uncalibrateCalendarDates: Converts calendar dates to 14C dates
In ADMUR: Ancient Demographic Modelling Using Radiocarbon

Description Usage Arguments Details Value Examples

Randomly samples a 14C date from the calibration curve error ribbon, at the corresponding calendar date

1	uncalibrateCalendarDates(dates, calcurve)

`dates`	A vector of calendar dates.
`calcurve`	A calibration curve object. Choose from intcal20 (default), shcal20, intcal13 or shcal13.

Conceptually this can be thought of as the reverse process of calibrating a 14C date into calendar time, however 'uncalibrating' is a misnomer as the full calibrated PD is not used. Instead, it uses a vector of calendar point estimates, and randomly samples 14C dates from the calibration curve error ribbon, at the corresponding calendar dates. Therefore values will differ each time.

Returns a vector of 14C dates

	uncalibrateCalendarDates(c(4500,5000), shcal20)

	# note the date outside the calcurve range has a 1 to 1 mapping between cal and c14 time
	uncalibrateCalendarDates(c(4500,70000), intcal20)

	# however, a soft fade is performed between the end of the calcurve and 60000
	uncalibrateCalendarDates(c(4500,58000), intcal20)