Learn R Programming

rice

Radiocarbon Calibration Equations

Radiocarbon is widely used for dating a range of archaeological and geographical objects. This package provides a number of functions to calibrate radiocarbon dates, including ones to transfer values between different realms (F14, D14C, pMC, C14 ages), to simulate the impacts of contamination, and to plot one or more calibrated dates.

Please check out the vignettes folder for a tutorial. In short, install the package from github, load it and run the two main functions:

require(devtools)
install_github("Maarten14C/rice")
library(rice)
calibrate(2450,20)
contaminate(55000, 100, .05, 1)
draw.contamination()

Installation

To use high-resolution maps, install the rnaturalearthhires package from GitHub (also install devtools if you haven't already):

install.packages("devtools")
devtools::install_github("ropensci/rnaturalearthhires")

Copy Link

Version

Install

install.packages('rice')

Monthly Downloads

1,218

Version

1.1.1

License

GPL (>= 2)

Maintainer

Maarten Blaauw

Last Published

April 9th, 2025

Functions in rice (1.1.1)

Find the BCAD age(s) crossing a C14 age.

Transform C14 age(s) into D14C

Find the F14C and error belonging to a cal BP age.

Calculate F14C values from C14 ages

Calculate C14 ages from F14C values.

Transform D14C into F14C

Transform D14C into C14 age

Transform F14C into D14C

Find the pMC and error belonging to a cal BP age.

Amount of C14 particles in a sample

Combine multiple radiocarbon dates assuming they belong to the same single year

add calibrated distributions to a plot.

Find the pMC and error belonging to a cal BP age.

Transform D14C into pMC

Find the 14C age and error belonging to a cal BP age.

To be deprecated. Use C14.F14C instead

calculate BC/AD ages from cal BP ages

Calculate pMC values from C14 ages

Find the calBP age(s) crossing a C14 age.

Plot individual calibrated dates.

Find nearby shell-derived dR values

To be deprecated. Use pMCtoC14 instead.

Calculate highest posterior density

Simulate the impact of contamination on a radiocarbon age

Draw d14C and the calibration curve.

Draw a calibration curve.

draw.contamination

Draw contamination impacts

The overlap between calibrated C14 dates

Probability of a date lying within a cal BP range

Transform F14C into D14C

Plot regional shell-derived dR values

Find the calibrated probability of a calendar age for a 14C date.

To be deprecated. Use C14topMC instead.

Combine multiple radiocarbon dates within bins

Calculate calibrated distribution

Calculate the amount of muck/contamination to explain an observed C14 age

Comparison dates calibrated using both the t distribution (Christen and Perez 2009) and the normal distribution.

Calculate pMC ages from F14C values.

Simulate removing contamination from a radiocarbon age

Find the probability of a calibrated date being older than a certain age

Find the probability of a calibrated date being of a certain age or younger than it

Plot and summarize the dR values

point.estimates

Calculate a point estimate

Estimate a missing radiocarbon age from fractions

Add a normal distribution to a calibrated date

Add a gamma distribution to a calibrated date

return a random calendar age from a calibrated distribution

translate between realms

rice: Radiocarbon Equations

Test if a set of radiocarbon dates can be combined

Calculate C14 ages from pMC values.

Radiocarbon Equations

Smooth a calibration curve

The time span between two calibrated dates

The spread among calibrated dates

Calculate the weighted mean of C14 ages

Find the F14C and error belonging to a BC/AD age.

calculate cal BP ages from BC/AD ages

To be deprecated. Calculate C14 ages from F14C values.

Find the pMC and error belonging to a BC/AD age.

Find the pMC and error belonging to a cal BP age.

Find the 14C age and error belonging to a BC/AD age.

Calculate pMC ages from F14C values.