Reddy: An open-source toolbox for analyzing eddy-covariance measurements in heterogeneous environments

Laura Mack · 2026

Read Reddy: An open-source toolbox for analyzing eddy-covariance measurements in heterogeneous environments by Laura Mack (2026) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2601-21890.txt.

Introduction

Laura Mack introduces a software toolbox for scientists who measure how land and air exchange gases and heat. The eddy-covariance method infers those exchanges from fast wind and gas measurements above a surface. It began as a way to track ecosystem-scale exchange between air and vegetation.

The method now also serves to test theories of atmospheric turbulence, with the aim of improving weather and climate models. Reddy, the open-source toolbox in this 2026 preprint, is built for analyzing such measurements in heterogeneous environments. Where the land below is a patchwork rather than one uniform field. Shared tools matter because flux data feed the carbon budgets that climate policy relies on.

Catalog record

CREATORLaura Mack
YEAR2026
COLLECTIONPAPERS
FORMATTXT
FILE SIZE31 KB
VERSION1.0
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2601-21890

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

Reddy: An open-source toolbox for analyzing eddy-covariance measurements in heterogeneous environments Laura Mack Abstract Abstract Land-atmosphere exchange processes are determined by turbulent fluxes, which can be derived from eddy-covariance measurements. This method was established to quantify ecosystem-scale vertical atmosphere-vegetation exchange processes, but is also used to validate atmospheric turbulence theories with the ultimate aim to improve the representation of turbulence in numerical models. While the focus has long been on turbulence over idealized, homogeneous and flat surfaces, recent scientific developments are shifting towards investigating turbulent exchange processes in complex heterogeneous environments under non-idealized conditions, which pose particular challenges, e.g. advective fluxes between different surface types or non-stationarity of nighttime turbulence. This requires to rethink standard post-processing routines for determining turbulent fluxes from the high-frequency sonic and gas analyzer measurements. Here, we introduce the open-source R-package ’Reddy’, which provides modular-built functions for post-processing, analysis and visualization of eddy-covariance measurements, including investigating spectra, coherent structures, anisotropy, flux footprints and surface energy balance closure. The ’Reddy’ package is accompanied by a detailed documentation and a set of jupyter notebooks introducing new users hands-on to eddy-covariance data analysis. We showcase ’Reddy’ based on measurements from three different sites in Norway: A case study during strong stratification over alpine tundra, for determining suitable averaging times during ice-cover transition at a boreal lake, and for fitting flux-variance relations for a permafrost peatland. ’Reddy’ serves as extension of previously developed software packages, paving the way towards holistic turbulence data analysis in heterogeneous real-world environments. 1 Introduction Turbulent fluxes are the main driver of land-atmosphere and vegetation-atmosphere interactions ( Baldocchi, 2003 ; Baldocchi, 2020 , e.g.) , and the standard technique for measuring them is eddy-covariance ( Aubinet et al., 2012 , e.g.) . Strictly speaking, however, eddy-covariance is only the method used to calculate fluxes from high-frequency sonic and gas analyzer measurements of three-dimensional wind speed, temperature and trace gases, which enable in-depth analysis of turbulence characteristics. To derive turbulent fluxes of sensible heat, latent heat, carbon dioxide or further trace gases from the high-frequency measurements, several software packages have been developed that offer a range of post-processing options for deriving vertical exchange between vegetation and atmosphere, most notably EddyPro ( LI-COR Biosciences, 2017 ) . These software packages are well-tested and robust, leading to a high agreement of the derived turbulent fluxes ( Mauder et al., 2008 ; Fratini and Mauder, 2014 ; Mammarella et al., 2016 ) , and have served as tools to generate regional or global flux products, e.g. within FLUXNET ( Pastorello et al., 2020 ) or the Integrated Carbon Observation System (ICOS). However, recent scientific developments are moving towards studying turbulent fluxes in more complex heterogeneous environments ( Rotach and Holtslag, 2025 , e.g.) , requiring a rethinking of common post-processing routines, which were typically developed for homogeneous flat terrain under idealized well-mixed turbulence conditions. For example, in highly heterogeneous environments, horizontal gradients at the interface of different surface types, e.g. between lake and forest or snow patches, can introduce lateral advective fluxes. Under wintertime stable conditions, turbulence can become intermittent and non-stationary influenced by non-local wave transport ( Mahrt, 2014 , e.g.) , leading to notable low-frequency contributions to fluxes ( Sievers et al., 2015 ; Pirk et al., 2017 , e.g.) . In these cases, the standard post-processing procedure to derive vertical fluxes based on 30 minutes averaging, might not be sufficient. Instead, post-processing and analysis steps of turbulence characteristics have to be linked in a re-evaluation cycle in order to adapt the post-processing methods to the specific site and environmental conditions. In this regard, it is also desirable that not only post-processing but also standard analysis routines are available in open-source software. Accordingly, software packages for selected applications of eddy-covariance data analysis have been developed, e.g. ’REddyProc’ focusing on gap-filling and flux partitioning ( Wutzler et al., 2018 ) or ’bigleaf’ for deriving physiological ecosystem properties from eddy-covariance data ( Knauer et al., 2018 ) . Here, we expand on these recent advancements by introducing the open-source software package ’Reddy’, which is built in a modular fashion enabling customized post-processing routines as well as performing several analysis steps, that help to determine suitable averaging times by characterizing turbulence properties through the combination of analyzing spectra, coherent structures, flux footprints and turbulence topology. Additionally, ’Reddy’ also provides functions to treat output from numerical weather prediction systems, analyze it and use eddy-covariance measurements for model verification and development ( Mack et al., 2025b ) . We first explain the package structure and the main analysis steps, including post-processing, calculation of turbulence diagnostics, and visualization of the results. Subsequently, we showcase parts of the package functionality for dual-site measurements in the alpine valley Finse (Southern Norway), for a measurement campaign at the boreal lake Langtjern (Southern Norway), and the permafrost peatland Iškoras (Northern Norway). These sites are characterized by heterogeneous and changing surface conditions, meaning that analyzing turbulence characteristics requires a modular, step-by-step approach, which is precisely what ’Reddy’ was specifically developed for. 2 Package Description The ’Reddy’ package provides functions for both raw data processing and standardized analysis of the post-processed eddy-covariance data, as showcased in Fig. 2.1 and described in the following. Figure 2.1: Components and workflow from eddy-covariance raw data to application in ’Reddy’. 2.1 Data processing The raw data processing of the high-frequency eddy-covariance data in ’Reddy’ follows the usual four-step procedure ( Fratini and Mauder, 2014 , e.g.) : • step1: raw data preparation : The raw data is despiked by using pre-defined thresholds (plausibility limits), skewness and kurtosis thresholds, and the median deviation test ( Mauder et al., 2013 ) . Additionally, variable conversions, e.g. from speed of sound to sonic temperature, and unit conversions are performed. The separation between gas analyzer and sonic can be corrected for with a lag-time correction applying the maximum cross-correlation method. • step2: tilt correction, time averaging and flux calculation : Tilt correction is performed by rotating the axes of the three-dimensional wind measurements. ’Reddy’ provides two methods for this: (1) double rotation, to rotate the wind into a streamline-following natural coordinate system per chosen averaging time window, and (2) planar fit rotation, to rotate the wind into a mean-streamline plane ( Wilczak et al., 2001 ) . Double-rotation is recommended for flat and homogeneous terrain as well for sites with changing surface properties, e.g. during snow melt-out or growing season, while planar fit is the preferred method in complex sloped terrain. Afterwards, the means, variances and covariances of the desired quantities are calculated using block or rolling average and the covariances are transformed to fluxes. To accelerate these calculations, ’Rcpp’ is used which facilitates a seamless integration of R and C++ ( Eddelbuettel, 2013 ) . The aim of this step is to separate the active eddy turbulent transport from deterministic larger-scale motions, and thus depends strongly on the studied site ( Moncrieff et al., 2005 ) , so that re-iterating post-processing and analysis steps (detailed in sec. 2.3 ) is necessary. • step3: flux corrections : Depending on used instruments and conditions, the fluxes require specific corrections. To convert from buoyancy flux (based on sonic temperature) to sensible heat flux, SND correction ( Schotanus et al., 1983

Read the complete text