isocalcR: An R package to streamline and standardize stable isotope calculations in ecological research

The use of stable isotopes to characterize ecosystem dynamics and infer leaf gas exchange processes has become increasingly prevalent over the last few decades within the ecological community. While advancements in theory and our understanding of the physiological processes controlling isotopic signatures in plants has been well-documented, no standardized tool currently exists to facilitate the computation of common isotope-derived plant physiological indices. Here, we present isocalcR, an R package intended to facilitate the use of stable isotope data from plant tissues by providing an integrated collection of functions and recommended reference data. The isocalcR R package contains a suite of functions that compute leaf carbon isotope discrimination (∆¹³ C), leaf intercellular [CO₂ ], the ratio of leaf intercellular to atmospheric [CO₂ ], the difference between atmospheric and leaf intercellular [CO₂ ], and intrinsic water use efficiency from carbon isotope signatures in leaf or wood tissue with minimal inputs from the user. isocalcR also implements and provides recommended input atmospheric [CO₂ ] (ppm) and atmospheric δ¹³ CO₂ (‰) data for the period 0-2021 C.E. A major goal of isocalcR is to provide a standardized, open-source tool to streamline the calculation of reproducible physiological indices from stable isotope signatures in plant tissues, incorporating the most up-to-date theory, while simultaneously eliminating potential errors associated with complex calculations. isocalcR can be used for any location globally as long as the user provides information regarding temperature and elevation to the main workhorse functions.