NEONiso

NOTE: some restructuring of this package, and working to adding new functions, may have caused some workflows to break. If you are having trouble with this version, please try the CRAN version.

DOI R-CMD-check codecov Lifecycle: experimental CRAN status

Author: Rich Fiorella
Last Updated: July 6, 2021.

This repository contains an R package to calibrate NEON atmospheric isotope data. A stable version of the package can be installed from CRAN, and a development version of this package can be installed here using devtools (see below).

Please report any issues you have, bugs found, or enhancement suggestions as issues to this repository.

Installing the development version:

  1. You will need the rhdf5 package, which is not on CRAN. rhdf5 is available from bioconductor using:
if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")

BiocManager::install("rhdf5")
  1. Install devtools, which is available on CRAN.
  2. Install NEONiso from GitHub. Development version can be installed using:
devtools::install_github("SPATIAL-Lab/NEONiso")

Alternatively, you can install a specific version of the package (e.g., v0.1) by specifying the version tag:

devtools::install_github("SPATIAL-Lab/[email protected]")

Citation information:

Package functionality to calibrate NEON carbon isotope data is described in a paper at JGR-Biogeosciences (doi: 10.1029/2020JG005862). Users of this package should also cite the Zenodo DOI above.

Please also check to ensure that you are compliant with NEON’s data citation policy for any products derived from this package: https://www.neonscience.org/data/about-data/data-policies

Usage:

Two methods are available to calibrate NEON Carbon isotope data and they take slightly different approaches: a) the ‘Bowling_2003’ method calibrates 12CO2 and 13CO2 mole fractions independently, while b) the ‘linreg’ method calibrates d13C and CO2 directly without converting to isotopologue mole fractions. The method is specified as an argument to calibrate_carbon(). Both methods yield very similar results, but the error and precision estimates are slightly better from the Bowling et al. 2003 method (Fiorella et al., 2021; JGR-Biogeosciences)

This function is meant to be applied to a list or vector of uncalibrated data files, and produce output hdf5 files that have (currently) only the CO2 and d13C variables instead of the entire data bundle. Development was targeted and tested on basic files, but the functions should also work on the extended data files.

neonUtilities:::stackEddy should work on these output files - please file an issue if it does not.

Future plans

The next major release will include calibration routines for the NEON water isotope products - more info soon

DATA ALERT:

Several months of data on the NEON data portal have an issue where the Picarro time clock has diverged from the valve manifold time. A fix has been developed, but has not been propagated to the NEON data portal. In the interim, corrected files for carbon isotopes only are available here: https://www.dropbox.com/sh/i9a61g2crv26ess/AADFCT80TPeMz2ayfNsCotg8a?dl=0