ISRaD R package

The ISRaD R package provides tools for data manipulation, data enhancement (ISRaD_extra), QA/QC, and making simple queries and reports. ISRaD data are not bundled with the R package, but are maintained under version control on GitHub, and are updated continuously.

The latest ISRaD data can be retrieved from the ISRaD GitHub repository using the function ISRaD.getdata from within an R session (all package versions ≥ 1.0.0). This will download the most recently compiled version of the database to a user-specified directory. All data will be tagged with the ISRaD version number and the compilation date.

For non-R users, the compiled raw data can also be downloaded as a .zip file directly from GitHub. See the Database page for more information.

The ISRaD R package provides a number of data enhancement tools (ISRaD.extra functions) that calculate or fill in certain fields with missing data, as well as provide ancillary data from various geospatial data sources. Note that in addition to the basic compiled version of the database, you can choose to download a version of the compiled database that already has these data filled and added (i.e. “ISRad_extra”) by using the option extra = TRUE when running the ISRaD.getdata function:

# set 'directory' argument to local path
ISRaD.getdata(directory = "~", dataset = "full", extra = "TRUE", force_download = "TRUE")

For more information, please read the user manual.

R package installation, data download and user manual

The ISRaD R package (version 1.2.3) is on CRAN. Users can install the package from inside an R session in the normal fashion:

install.packages("ISRaD")
# load package
library(ISRaD)

Most up-to-date data can be retrieved:

ISRaD.getdata(directory = "~", dataset = "full", force_download = "TRUE")

Alternatively, for those users willing to risk working with beta code, you can install the development version of ISRaD. There are many additional functionalities but code is more likely to break. Install it from GitHub:

devtools::install_github('International-Soil-Radiocarbon-Database/ISRaD/Rpkg')

Looking for step-by-step instructions? Tutorial here.

Code or data-related questions, concerns, suggestions? Post an issue here.

Or contact us at info.israd@gmail.com (slower).