ananke

status-badge Code coverage Dependencies

r-universe CRAN Version CRAN checks CRAN Downloads

Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.

DOI Zenodo SWH

Overview

Simple radiocarbon calibration and chronological analysis. This package allows the calibration of radiocarbon ages and modern carbon fraction (F14C) values using multiple calibration curves. It allows the calculation of highest density region intervals and credible intervals. The package also provides tools for visualising results and estimating statistical summaries.

This package is currently experimental. This means that it is functional, but interfaces and functionalities may change over time, testing and documentation may be lacking.

To cite ananke in publications use:

Frerebeau N (2026). ananke: Quantitative Chronology in Archaeology. Université Bordeaux Montaigne, Pessac, France. doi:10.5281/zenodo.13236285 https://doi.org/10.5281/zenodo.13236285. R package version 0.3.0, https://packages.tesselle.org/ananke/.

This package is a part of the tesselle project https://www.tesselle.org.

Installation

You can install the released version of ananke from CRAN with:

install.packages("ananke")

And the development version from Codeberg with:

# install.packages("remotes")
remotes::install_git("https://codeberg.org/tesselle/ananke")

Usage

# Install extra package, if needed
# install.packages("khroma")

## Load packages
library(ananke)
#> Loading required package: aion
library(khroma)

ananke uses aion for internal date representation. Look at vignette("aion", package = "aion") before you start.

## Data from Bosch et al. 2015
data("ksarakil")

## Graphical parameters
par(mar = c(4, 6, 1, 1) + 0.1) # Adjust margins

## Calibrate multiple ages
cal <- c14_calibrate(
  values = ksarakil$date,
  errors = ksarakil$error,
  names = ksarakil$code,
  curves = "marine13",
  reservoir_offsets = 53,
  reservoir_errors = 43,
  from = 50000, to = 0
)

## Plot calibrated ages
ridgelines(
  x = cal, 
  calendar = CE(), 
  col = palette_color_picker("bright")(ksarakil$phase)
)


## 95% intervals
hdr95 <- interval_hdr(cal, level = 0.95)
as.data.frame(hdr95, calendar = CE())
#>        label  start    end    p
#> 1  GrA-53005 -28472 -27538 0.95
#> 2  GrA-54848 -30837 -29740 0.95
#> 3  GrA-53006 -36920 -35614 0.95
#> 4  GrA-57545 -38737 -37401 0.95
#> 5  GrA-54847 -41927 -40650 0.95
#> 6  GrA-57544 -38765 -37560 0.95
#> 7  GrA-57598 -39991 -38970 0.95
#> 8  GrA-57599 -41784 -40694 0.95
#> 9  GrA-53001 -36676 -35245 0.95
#> 10 GrA-54846 -41804 -40640 0.95
#> 11 GrA-57602 -39504 -38384 0.95
#> 12 GrA-57603 -40553 -39761 0.95
#> 13 GrA-57542 -39129 -37916 0.95
#> 14 GrA-53004 -41346 -40383 0.95
#> 15 GrA-57597 -42000 -40766 0.95
#> 16 GrA-53000 -42451 -41111 0.95

## Plot intervals
plot(
  x = hdr95,
  calendar = CE(),
  col = palette_color_picker("bright")(ksarakil$phase),
  lwd = 2
)

Translation

This package provides translations of user-facing communications, like messages, warnings and errors, and graphical elements (axis labels). The preferred language is by default taken from the locale. This can be overridden by setting of the environment variable LANGUAGE (you only need to do this once per session):

Sys.setenv(LANGUAGE = "<language code>")

Languages currently available are English (en) and French (fr).

Contributing

Please note that the ananke project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

References

Albarède, F., A.-M. Desaulty, and J. Blichert-Toft. 2012. “A Geological Perspective on the Use of Pb Isotopes in Archaeometry.” Archaeometry 54 (5): 853–67. https://doi.org/10.1111/j.1475-4754.2011.00653.x.
Albarède, F., and M. Juteau. 1984. “Unscrambling the Lead Model Ages.” Geochimica Et Cosmochimica Acta 48 (1): 207–12. https://doi.org/10.1016/0016-7037(84)90364-8.
Allègre, Claude. 2005. Géologie isotopique. Belin sup. Belin.
Boers, Niklas, Bedartha Goswami, and Michael Ghil. 2017. “A Complete Representation of Uncertainties in Layer-Counted Paleoclimatic Archives.” Climate of the Past 13 (9): 1169–80. https://doi.org/10.5194/cp-13-1169-2017.
Bronk Ramsey, C. 2008. “Radiocarbon Dating: Revolutions in Understanding.” Archaeometry 50 (2): 249–75. https://doi.org/10.1111/j.1475-4754.2008.00394.x.
Bronk Ramsey, Christopher. 2009. “Bayesian Analysis of Radiocarbon Dates.” Radiocarbon 51 (1): 337–60.
Carleton, W. Christopher. 2021. “Evaluating Bayesian Radiocarbon-Dated Event Count (REC) Models for the Study of Long-Term Human and Environmental Processes.” Journal of Quaternary Science 36 (1): 110–23. https://doi.org/10.1002/jqs.3256.
Galbraith, Rex F. 1988. “Graphical Display of Estimates Having Differing Standard Errors.” Technometrics 30 (3): 271–81. https://doi.org/10.1080/00401706.1988.10488400.
Galbraith, Rex F. 1990. “The Radial Plot: Graphical Assessment of Spread in Ages.” International Journal of Radiation Applications and Instrumentation. Part D. Nuclear Tracks and Radiation Measurements 17 (3): 207–14. https://doi.org/10.1016/1359-0189(90)90036-W.
Galbraith, Rex F. 1994. “Some Applications of Radial Plots.” Journal of the American Statistical Association 89 (428): 1232–42. https://doi.org/10.1080/01621459.1994.10476864.
Heaton, Timothy J, Peter Köhler, Martin Butzin, et al. 2020. “Marine20 The Marine Radiocarbon Age Calibration Curve (0–55,000 Cal BP).” Radiocarbon 62 (4): 779–820. https://doi.org/10.1017/RDC.2020.68.
Hogg, Alan G, Timothy J Heaton, Quan Hua, et al. 2020. “SHCal20 Southern Hemisphere Calibration, 0–55,000 Years Cal BP.” Radiocarbon 62 (4): 759–78. https://doi.org/10.1017/RDC.2020.59.
Hogg, Alan G, Quan Hua, Paul G Blackwell, et al. 2013. “SHCal13 Southern Hemisphere Calibration, 0–50,000 Years Cal BP.” Radiocarbon 55 (4): 1889–903. https://doi.org/10.2458/azu_js_rc.55.16783.
Hua, Quan, and Mike Barbetti. 2004. “Review of Tropospheric Bomb 14C Data for Carbon Cycle Modeling and Age Calibration Purposes.” Radiocarbon 46 (3): 1273–98. https://doi.org/10.1017/S0033822200033142.
Hua, Quan, Mike Barbetti, and Andrzej Z Rakowski. 2013. “Atmospheric Radiocarbon for the Period 1950–2010.” Radiocarbon 55 (4): 2059–72. https://doi.org/10.2458/azu_js_rc.v55i2.16177.
Hua, Quan, Jocelyn C Turnbull, Guaciara M Santos, et al. 2022. “Atmospheric Radiocarbon for the Period 1950–2019.” Radiocarbon 64 (4): 723–45. https://doi.org/10.1017/RDC.2021.95.
Hughen, K., S. Lehman, J. Southon, et al. 2004. “14C Activity and Global Carbon Cycle Changes over the Past 50,000 Years.” Science 303 (5655): 202–7. https://doi.org/10.1126/science.1090300.
Hughen, Konrad A, Mike G L Baillie, Edouard Bard, et al. 2004. “Marine04 Marine Radiocarbon Age Calibration, 0–26 Cal Kyr BP.” Radiocarbon 46 (3): 1059–86. https://doi.org/10.1017/S0033822200033002.
Hyndman, Rob J. 1996. “Computing and Graphing Highest Density Regions.” The American Statistician 50 (2): 120. https://doi.org/10.2307/2684423.
Kueppers, Lara M., John Southon, Paul Baer, and John Harte. 2004. “Dead Wood Biomass and Turnover Time, Measured by Radiocarbon, Along a Subalpine Elevation Gradient.” Oecologia 141 (4): 641–51. https://doi.org/10.1007/s00442-004-1689-x.
McCormac, F G, A G Hogg, P G Blackwell, C E Buck, T F G Higham, and P J Reimer. 2004. “Shcal04 Southern Hemisphere Calibration, 0–11.0 Cal Kyr BP.” Radiocarbon 46 (3): 1087–92. https://doi.org/10.1017/S0033822200033014.
Millard, Andrew R. 2014. “Conventions for Reporting Radiocarbon Determinations.” Radiocarbon 56 (2): 555–59. https://doi.org/10.2458/56.17455.
Reimer, P J, M G L Baillie, E Bard, et al. 2009. “IntCal09 and Marine09 Radiocarbon Age Calibration Curves, 0–50,000 Years Cal BP.” Radiocarbon 51 (4): 1111–50. https://doi.org/10.1017/S0033822200034202.
Reimer, Paula J, William E N Austin, Edouard Bard, et al. 2020. “The IntCal20 Northern Hemisphere Radiocarbon Age Calibration Curve (0–55 Cal kBP).” Radiocarbon 62 (4): 725–57. https://doi.org/10.1017/RDC.2020.41.
Reimer, Paula J, Mike G L Baillie, Edouard Bard, et al. 2004. “Intcal04 Terrestrial Radiocarbon Age Calibration, 0–26 Cal Kyr BP.” Radiocarbon 46 (3): 1029–58. https://doi.org/10.1017/S0033822200032999.
Reimer, Paula J, Edouard Bard, Alex Bayliss, et al. 2013. “IntCal13 and Marine13 Radiocarbon Age Calibration Curves 0–50,000 Years Cal BP.” Radiocarbon 55 (4): 1869–87. https://doi.org/10.2458/azu_js_rc.55.16947.
Stuiver, Minze, and Henry A. Polach. 1977. “Discussion Reporting of 14C Data.” Radiocarbon 19 (3): 355–63. https://doi.org/10.1017/S0033822200003672.
Stuiver, Minze, Paula J. Reimer, Edouard Bard, et al. 1998. “INTCAL98 Radiocarbon Age Calibration, 24,000–0 Cal BP.” Radiocarbon 40 (3): 1041–83. https://doi.org/10.1017/S0033822200019123.
Stuiver, Minze, Paula J. Reimer, and Thomas F. Braziunas. 1998. “High-Precision Radiocarbon Age Calibration for Terrestrial and Marine Samples.” Radiocarbon 40 (3): 1127–51. https://doi.org/10.1017/S0033822200019172.
van der Plicht, J, and A Hogg. 2006. “A Note on Reporting Radiocarbon.” Quaternary Geochronology 1 (4): 237–40. https://doi.org/10.1016/j.quageo.2006.07.001.
Ward, G. K., and S. R. Wilson. 1978. “Procedures for Comparing and Combining Radiocarbon Age Determinations: A Critique.” Archaeometry 20 (1): 19–31. https://doi.org/10.1111/j.1475-4754.1978.tb00208.x.