Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


DOI:10.5194/gchron-2020-25) R License: MIT R build status


What is it?

Quantifying age uncertainties is a critical component of paleoscience (paleoclimatology, paleoecology, paleontology). geoChronR is an integrated framework that allows scientists to generate state-of-the-art age models for their records, create time-uncertain ensembles of their data, analyze those ensembles with a number of commonly-used techniques, and visualize their results in an intuitive way. The code is being developed in the open-source and community-supported R platform.

geoChronR is currently under review as a discussion paper in Geochronology, check it out here


geoChronR is a package for R, and so you'll need R to run and install it. geoChronR should work with any version newer than 3.5.0. You can download R for your operating system here.

You'll also need an interface to use R. Although many can work, I strongly recommend RStudio. You can download RStudio for your operating system here.

Once you have R and your interface up and running, you'll need to install some packages. Most of this will be handled automatically, but to get started install the remotes package:


In addition, the packages are not required, but may be useful, and will not install automatically through geoChronR so if you're interested install lipdR and nuspectral from github:

remotes::install_github("nickmckay/lipd-utilities",subdir = "R")


Install package in R Studio:


Load the package into the environment:


Getting started with geoChronR

A great way to get started with geoChronR is to work through some of the tutorials avialable at the top of the geoChronR documentation page. These are also provided as "vignettes" that come installed with geoChronR, which you can access by running browseVignettes("geoChronR"). These examples run through how to create an age model ensemble, perform ensemble correlation, regression, spectral and principal components analysis, and visualize the results. They also show off some of the tools we've built for efficiently working with and visualizing LiPD datasets.

Once you're ready to start applying these techniques to your new data, you'll need one more LiPD files. Thousands of LiPD datasets are available at and the World Data Service for Paleoclimatology. If you'd like to create your own dataset, the easiest way is using the This can be a bit daunting at first, but check out the tutorial on the playground, and/or this youtube tutorial to get started.

How to Cite this Code

McKay, N. P., Emile-Geay, J., and Khider, D.: GeoChronR – an R package to model, analyze and visualize age-uncertain paleoscientific data, Geochronology Discuss.,, in review, 2020.


Additional Resources

Github - lipdR

Github - LiPD Utilities

Linked Earth Wiki


If you are having issues, please create an issue here, or if for some reason it's not appropriate for the Github issue tracker let us know at


The project is licensed under the MIT License


Development repository for GeoChronR




No packages published

Contributors 4

You can’t perform that action at this time.