R/data.R

In isogeochem: Tools for Stable Isotope Geochemistry

# Datasets described in this file: "devilshole", "LR04"

# ——————————————————————————————————————————————————————————————————————————— #
#### devilshole ####
#' @title Devils Hole carbonate d18O time series
#'
#' @description
#' A dataset containing the d18O values of the "original" Devils Hole cores.
#'
#' @format A data frame with 442 rows and 4 variables:
#' \describe{
#'   \item{age}{Interpolated uranium-series age of the sample expressed
#'   as thousands of years before present (ka).}
#'   \item{d18O_VSMOW}{Carbonate d18O value expressed on the VSMOW scale (‰).}
#'   \item{d18O_error}{Standard deviation on the d18O value.}
#'   \item{core}{Name of the core (DHC2-8, DHC2-3, DH-11).}
#' }
#'
#' @source
#' \doi{10.3133/ofr20111082}
#'
#' @references
#' Winograd, I. J., Landwehr, J. M., Coplen, T. B., Sharp, W. D.,
#' Riggs, A. C., Ludwig, K. R., & Kolesar, P. T. (2006).
#' Devils Hole, Nevada, d18O record extended to the mid-Holocene.
#' Quaternary Research, 66(2), 202-212.
#' \doi{10.1016/j.yqres.2006.06.003}
#'
#' @family "datasets"
"devilshole"

# ——————————————————————————————————————————————————————————————————————————— #
#### LR04 ####
#' @title A Pliocene-Pleistocene benthic foraminifera d18O stack
#'
#' @description
#' A dataset containing the LR04 benthic d18O stack.
#'
#' @format A data frame with 2115 rows and 3 variables:
#' \describe{
#'   \item{age}{Age of the sample expressed as thousands of years
#'     before present (ka).}
#'   \item{d18O_VPDB}{Carbonate d18O value expressed on the VPDB scale (‰).}
#'   \item{d18O_error}{Standard error on the d18O value.}
#' }
#'
#' @source
#' <https://lorraine-lisiecki.com/stack.html>
#'
#' @references
#' Lisiecki, L. E., & Raymo, M. E. (2005).
#' A Pliocene-Pleistocene stack of 57 globally distributed
#' benthic d18O records.
#' Paleoceanography, 20(1), PA1003.
#' \doi{10.1029/2004pa001071}
#'
#' @family "datasets"
"LR04"

# ——————————————————————————————————————————————————————————————————————————— #
#### GTS2020 ####
#' @title
#' Oxygen isotope stratigraphy from the Geologic Time Scale 2020: macrofossils
#'
#' @description A dataset containing a compilation of d18O and d13C values
#'   of various macrofossils
#'   (bivalves, gastropods, belemnites, ammonites) together with information
#'   on their age, shell mineralogy, and the climate zone they represent.
#'   This dataset is a condensed version of the entire dataset presented in the
#'   Geologic Time Scale 2020. Specifically, the full dataset was filtered for
#'   those "select" d18O and d13C values that also have age information.
#'
#' @format A data frame with 9676 rows and 8 variables:
#' \describe{
#'   \item{age}{Age of the sample expressed as
#'     millions of years before present (Ma).}
#'   \item{d18O_VPDB}{Carbonate d18O value expressed on the VPDB scale (‰).}
#'   \item{d13C_VPDB}{Carbonate d13C value expressed on the VPDB scale (‰).}
#'   \item{mineralogy}{The mineralogy of the carbonate hard part.}
#'   \item{group}{Taxonomic group of the sample
#'     (bivalve, gastropod, belemnite, ammonite).}
#'   \item{clim_zone}{The climate zone the sample represents.}
#' }
#'
#' @source
#' <https://download.pangaea.de/dataset/930093/files/GTS2020-App_10.2A.xlsx>
#'
#' @references
#' Grossman, E. L., & Joachimski, M. M. (2020).
#' Oxygen isotope stratigraphy.
#' In F. M. Gradstein, J. G. Ogg, M. D. Schmitz, & G. M. Ogg (Eds.),
#' Geologic Time Scale 2020: Volume 1 (pp. 279-307): Elsevier.
#' \doi{10.1016/B978-0-12-824360-2.00010-3}
#'
#' @family "datasets"
"GTS2020"

# ——————————————————————————————————————————————————————————————————————————— #
#### meteoric_water ####
#' @title
#' Oxygen isotope values for meteoric waters
#'
#' @description A dataset containing a compilation of d17O and d17O values
#'   of various meteoric waters.
#'
#' @format A data frame with 156 rows and 4 variables:
#' \describe{
#'   \item{Sample}{Sample ID as in the original publication.}
#'   \item{d17O}{Water d17O value expressed on the VSMOW scale (‰).}
#'   \item{d18O}{Water d18O value expressed on the VSMOW scale (‰).}
#'   \item{Reference}{Abbreviated reference for the data point.}
#' }
#'
#' @references
#' Luz, B., & Barkan, E. (2010).
#' Variations of 17O/16O and 18O/16O in meteoric waters.
#' Geochimica et Cosmochimica Acta, 74(22), 6276–6286.
#' \doi{10.1016/j.gca.2010.08.016}
#'
#' Aron, P. G., Levin, N. E., Beverly, E. J., Huth, T. E.,
#' Passey, B. H., Pelletier, E. M., Poulsen, C. J.,
#' Winkelstern, I. Z., & Yarian, D. A. (2021).
#' Triple oxygen isotopes in the water cycle.
#' Chemical Geology, 565, 116770.
#' \doi{10.1016/j.chemgeo.2020.120026}
#'
#' @family "datasets"
"meteoric_water"