Calibration and Analysis of Radiocarbon Dates

Enables the calibration and analysis of radiocarbon dates, often but not exclusively for the purposes of archaeological research. It includes functions not only for basic calibration, uncalibration, and plotting of one or more dates, but also a statistical framework for building demographic and related longitudinal inferences from aggregate radiocarbon date lists, including: Monte-Carlo simulation test (Timpson et al 2014 ), random mark permutation test (Crema et al 2016 ) and spatial permutation tests (Crema, Bevan, and Shennan 2017 ).


cran version rstudio mirror downloads rstudio mirror downloads

This package enables the calibration and analysis of radiocarbon dates, often but not exclusively for the purposes of archaeological research. It includes functions not only for basic calibration, uncalibration, and plotting of one or more dates, but also a statistical framework for building demographic and related longitudinal inferences from aggregate radiocarbon date lists, including: Monte-Carlo simulation test (Timpson et al 2014), random mark permutation test (Crema et al 2016, Bevan et al 2017) point-to-point test (Edinborough et al 2017), and spatial permutation test (Crema, Bevan, and Shennan 2017).

To install the stable version from CRAN:

install.packages('rcarbon')

To install the latest development version:

devtools::install_github('ahb108/rcarbon')

References

Bevan, A. Colledge,S., Fuller, D., Fyfe, R., Shennan, S., Stevens, C. 2017.Holocene fluctuations in human population demonstrate repeated links to food production and climate. Proceedings of the National Academy of Sciences of the United States of America. doi:10.1073/pnas.1709190114

Crema, E.R., Bevan, A., Shennan, S., 2017. Spatio-temporal approaches to archaeological radiocarbon dates. Journal of Archaeological Science 87, 1–9. doi:10.1016/j.jas.2017.09.007

Crema, E.R., Habu, J., Kobayashi, K., Madella, M., 2016. Summed Probability Distribution of 14 C Dates Suggests Regional Divergences in the Population Dynamics of the Jomon Period in Eastern Japan. PLOS ONE 11, e0154809. doi:10.1371/journal.pone.0154809

Edinborough, K., Porcic, M., Martindale, A., Brown, T.J., Supernant, K, Ames, K.M. 2017. Radiocarbon test for demographic events in written and oral history, Proceedings of the National Academy of Sciences of the United States of America, 114 (47), 12436–12441. doi:10.1073/pnas.1713012114

Timpson, A., Colledge, S., Crema, E., Edinborough, K., Kerig, T., Manning, K., Thomas, M.G., Shennan, S., 2014. Reconstructing regional population fluctuations in the European Neolithic using radiocarbon dates: a new case-study using an improved method. Journal of Archaeological Science 52, 549–557. doi:10.1016/j.jas.2014.08.011

Case Studies Using rcarbon

Crema, E.R., Bevan, A., Shennan, S., 2017. Spatio-temporal approaches to archaeological radiocarbon dates. Journal of Archaeological Science 87, 1–9. doi:10.1016/j.jas.2017.09.007

Freeman, J., Baggio, J.A., Robinson, E., Byers, D.A., Gayo, E., Finley, J.B., Meyer, J.A., Kelly, R.L., Anderies, J.M., 2018. Synchronization of energy consumption by human societies throughout the Holocene. PNAS 201802859. doi:10.1073/pnas.1802859115

Palmisano, A., Bevan, A., Shennan, S. 2017. Comparing archaeological proxies for long-term population patterns: An example from central Italy. Journal of Archaeological Science, 87, 59-72. doi:10.1016/j.jas.2017.10.001

Riris, P. 2018 Dates as data revisited: A statistical examination of the Peruvian preceramic radiocarbon record. Journal of Archaeological Science, 97, 67-76. doi:10.1016/j.jas.2018.06.008

Tallavara, M., Personen, P. 2018. Human ecodynamics in the north-west coast of Finland 10,000–2000 years ago.Quaternary International,doi:/10.1016/j.quaint.2018.06.032

News

Development Version

  • Bug fix in SPpermTest(): Functions was not working when not running when raw=FALSE and ncores=1.
  • Bug fix in summary() for the output of modelTest(): The number of bins reported was incorrect.
  • UPDATE: binsense() requires a smaller number of non-optional arguments and allows for binning based on median calibrated dates.
  • UPDATE: plot() function for geometric growth rates now allows for BC/AD calendar display.
  • UPDATE: binPrep() can now group dates based on median calibrated dates.
  • UPDATE: modelTest()can now test SPD generated from multiple calibration curves.
  • UPDATE: modelTest() now uses randomised back-calibration for the 'calsample' method.
  • UPDATE: uncalibrate()'s random back-calibration now utilises both the user supplied lab error and the error of the calibration curve.
  • NEW: mixCurves() function generates mixed terrestrial/marine calibration curves.
  • Further minor updates in plot labels, help documentation, and vignette.

Version 1.1.3 (26 June 2018)

  • Bug fix in permTest(): p-values calculation algorithm was yielding p-values of 0.
  • NEW: summary() functions for the outputs of permTest() and modelTest().

Version 1.1.2 (22 May 2018)

  • Bug Fix in calibrate(): calibration of multiple dates with different calibration curves was based on the calibration curve of the first sample.
  • Bug Fix in modelTest(): back-calibration routine was ignoring user-supplied calibration curve and was solely using "intcal13".
  • UPDATE: modelTest() now allows for two distinct procedures for generating random dates from fitted models.
  • Minor corrections (e.g. typos) in the help documentation.

Version 1.1.1 (28 April 2018)

  • Added a Vignette.
  • Added normally-distributed (non-14C) age in calibrate().
  • Fixed a bug in SPpermTest() generating opposite results (positive deviations were recorded as negative deviations) when ncores was larger than 1.
  • Fixed a minor bug in the implementation of the [North el al 2002] formula
  • Several changes in theplot.SpatialTest().
  • NEW function: spd2gg() to convert SPD curves into geometric growth rates for given temporal blocks and an associated plot function.
  • Minor updates in the documentation.

Version 1.1.0 (12 March 2018)

  • Improved performance of modelTest() function when running with multiple cores.
  • NEW function: p2pTest() for comparing point to point differences in SPD (as in Edinborough et al 2017 )
  • p-values of Monte-Carlo simulations are now all calculated using the formula in North el al 2002
  • minor bug fixes

Version 1.0.0 (9 Otober 2017)

First official CRAN release.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("rcarbon")

1.2.0 by Enrico Crema, 7 months ago


Browse source code at https://github.com/cran/rcarbon


Authors: Andrew Bevan [aut] , Enrico Crema [aut, cre] , Fabio Silva [ctb]


Documentation:   PDF Manual  


GPL (>= 2) license


Imports sp, stats, graphics, grDevices, utils, doParallel, foreach, parallel, knitr


See at CRAN