Package: rice 2.3.1

rice: Radiocarbon Equations

Provides functions for the calibration of radiocarbon dates, as well as options to calculate different radiocarbon-related timescales (cal BP, cal BC/AD, C14 age, F14C, pMC, D14C) and estimating the effects of contamination or local reservoir offsets (Reimer and Reimer 2001 <doi:10.1017/S0033822200038339>). Supporting publication: Blaauw, M., Reimer, P.J., 2026. An open-source toolkit for radiocarbon dating and calibration. Radiocarbon <doi:10.1017/RDC.2026.10221>. The methods follow long-established recommendations such as Stuiver and Polach (1977) <doi:10.1017/S0033822200003672> and Reimer et al. (2004) <doi:10.1017/S0033822200033154>. This package uses the calibration curves from the data package 'rintcal'.

Authors:Maarten Blaauw [aut, cre], Paula Reimer [ctb], Vegard Martinsen [ctb]

rice_2.3.1.tar.gz
rice_2.3.1.zip(r-4.7-any)rice_2.3.1.zip(r-4.6-any)rice_2.3.1.zip(r-4.5-any)
rice_2.3.1.tgz(r-4.6-any)rice_2.3.1.tgz(r-4.5-any)
rice_2.3.1.tar.gz(r-4.7-any)rice_2.3.1.tar.gz(r-4.6-any)
rice_2.3.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
rice/json (API)

# Install 'rice' in R:

install.packages('rice', repos = c('https://maarten14c.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/maarten14c/rice/issues

Datasets:

elements - Elements Data
shells - Shells Data
shroud - Shroud Data

On CRAN:

6.85 score 3 stars 4 packages 16 scripts 1.1k downloads 85 exports 21 dependencies

Last updated from:2448b9add2. Checks:9 OK. Indexed: yes.

Target	Result	Time
linux-devel	OK	173
source / vignettes	OK	218
linux-release	OK	177
macos-release	OK	113
macos-oldrel	OK	120
windows-devel	OK	119
windows-release	OK	142
windows-oldrel	OK	144
wasm-release	OK	107

Exports:adjust.background adjust.fractionation age.F14C age.pMC age.range as.bin as.one atom b2ktoBCAD b2ktoC14 b2ktocalBP b2ktoDelta14C b2ktoF14C b2ktopMC BCADtob2k BCADtoC14 BCADtocalBP BCADtoDelta14C BCADtoF14C BCADtopMC C14.cycle C14tob2k C14toBCAD C14tocalBP C14toDelta14C C14toF14C C14topMC calBPtob2k calBPtoBCAD calBPtoC14 calBPtoDelta14C calBPtoF14C calBPtopMC caldist calib.t calibratable calibrate clean contaminate coverage CtoF decay_series Delta14CtoC14 Delta14CtoF14C Delta14CtopMC draw.ccurve draw.CF draw.contamination draw.dates draw.Delta14C F14C.age F14CtoC14 F14CtoDelta14C F14CtopMC find.shells fractions fromto FtoC howmuchC14 hpd hpd.overlap l.calib map.dates map.shells muck older overlap p.range pMC.age pMCtoC14 pMCtoDelta14C pMCtoF14C point.estimates pool push.gamma push.normal r.calib radio shells.mean sim.date smooth.ccurve span spread weighted_means younger

Dependencies:cli cpp11 data.table farver ggplot2 glue gtable isoband jsonlite labeling lifecycle maps R6 RColorBrewer rintcal rlang S7 scales vctrs viridisLite withr

Introduction to the rice package

Rendered fromrice.Rmdusingknitr::rmarkdown

Last update: 2026-09-24
Started: 2024-08-27

Help page	Topics
rice: Radiocarbon Equations	rice-package
Adjust a radiocarbon age for background measurements	adjust.background
Adjust a radiocarbon age for fractionation	adjust.fractionation
Deprecated. Use C14toF14C instead	age.F14C
Deprecated. Use C14topMC instead.	age.pMC
Calculate age ranges	age.range
Combine multiple radiocarbon dates within bins	as.bin
Combine multiple radiocarbon dates assuming they belong to the same single year	as.one
Build an atom From the number of protons and neutrons, report the corresponding element/isotope, its abundance, half-life, decay mode and daughter product.	atom
calculate cal BC/AD ages from b2k ages	b2ktoBCAD
Find the 14C age and error belonging to a b2k age.	b2ktoC14
calculate cal BP ages from b2k ages	b2ktocalBP
Find the Delta14C and error belonging to a b2k age.	b2ktoDelta14C
Find the F14C and error belonging to a b2k age.	b2ktoF14C
Find the pMC and error belonging to a b2k age.	b2ktopMC
calculate b2k from cal BC/AD ages	BCADtob2k
Find the 14C age and error belonging to a cal BC/AD age.	BCADtoC14
calculate cal BP ages from cal BC/AD ages	BCADtocalBP
Find the Delta14C and error belonging to a cal BC/AD age.	BCADtoDelta14C
Find the F14C and error belonging to a cal BC/AD age.	BCADtoF14C
Find the pMC and error belonging to a cal BC/AD age.	BCADtopMC
Fill the atmosphere and ocean with 14C	C14.cycle
Find the b2k age(s) crossing a C14 age.	C14tob2k
Find the cal BCAD age(s) crossing a C14 age.	C14toBCAD
Find the calBP age(s) crossing a C14 age.	C14tocalBP
Transform C14 age(s) into Delta14C	C14toDelta14C
Calculate F14C values from C14 ages	C14toF14C
Calculate pMC values from C14 ages	C14topMC
calculate b2k ages from cal BP ages	calBPtob2k
calculate cal BC/AD ages from cal BP ages	calBPtoBCAD
Find the 14C age and error belonging to a cal BP age.	calBPtoC14
Find the Delta14C and error belonging to a cal BP age.	calBPtoDelta14C
Find the F14C and error belonging to a cal BP age.	calBPtoF14C
Find the pMC and error belonging to a cal BP age.	calBPtopMC
Calculate calibrated distribution	caldist
Comparison dates calibrated using both the t distribution (Christen and Perez 2009) and the normal distribution.	calib.t
Make a table of calibrated dates	calibratable
Plot individual calibrated dates.	calibrate
Simulate removing contamination from a radiocarbon age	clean
Simulate the impact of contamination on a radiocarbon age	contaminate
To be retired - coverage of one distribution by another.	coverage
Calculate F14C values from C14 ages	CtoF
Decay series of isotopes	decay_series
Transform Delta14C into C14 age	Delta14CtoC14
Transform Delta14C into F14C	Delta14CtoF14C
Transform Delta14C into pMC	Delta14CtopMC
Draw a calibration curve.	draw.ccurve
Draw the asymmetric relationship between 14C and F14C	draw.CF
Draw contamination impacts	draw.contamination
add calibrated distributions to a plot.	draw.dates
Draw Delta14C and the calibration curve.	draw.Delta14C
elements Data	elements
Deprecated. Use F14CtoC14instead	F14C.age
Calculate C14 ages from F14C values.	F14CtoC14
Transform F14C into Delta14C	F14CtoDelta14C
Calculate pMC ages from F14C values.	F14CtopMC
Find nearby shell-derived dR values	find.shells
Estimate a missing radiocarbon age from fractions	fractions
translate between timescales	fromto
Calculate C14 ages from F14C values.	FtoC
Amount of C14 particles in a sample	howmuchC14
Calculate highest posterior density	hpd
Check whether hpds of two distributions overlap	hpd.overlap
Find the calibrated probability of a calendar age for a 14C date.	l.calib
A map of 180k archaeological C-14 dates	map.dates
Plot regional shell-derived dR values	map.shells
Calculate the amount of muck/contamination to explain an observed C14 age	muck
Find the probability of a calibrated date being older than a certain age	older
The overlap between calibrated C14 dates	overlap
Probability of a date lying within a cal BP range	p.range
Deprecated. Use pMCtoC14 instead.	pMC.age
Calculate C14 ages from pMC values.	pMCtoC14
Transform pMC into Delta14C	pMCtoDelta14C
Calculate pMC ages from F14C values.	pMCtoF14C
Calculate a point estimate	point.estimates
Test if a set of radiocarbon dates can be combined	pool
Add a gamma distribution to a calibrated date	push.gamma
Add a normal distribution to a calibrated date	push.normal
return a random calendar age from a calibrated distribution	r.calib
Listen to radiocarbon being measured	radio
shells Data	shells
Plot and summarize the dR values	shells.mean
shroud Data	shroud
Simulate a radiocarbon date	sim.date
Smooth a calibration curve	smooth.ccurve smooth.curve
The time span between two calibrated dates	span
The spread among calibrated dates	spread
Calculate the weighted mean of C14 ages	weighted_means
Find the probability of a calibrated distribution being of a certain age or younger than it	younger

Package: rice 2.3.1

rice: Radiocarbon Equations

Citation

Development and contributors

Readme and manuals

Help Manual

Usage by other packages (reverse dependencies)