flux-data-qaqc - Tools for Energy Balance Closure Analysis
flux-data-qaqc provides a framework to create reproducible workflows for validation and analysis of eddy covariance data. The package is intended for those who need to post-process flux data, particularly for generating daily and monthly evapotranspiration (ET) timeseries estimates with energy balance closure corrections applied. Applications where this software may be useful include analysis involving eddy covariance flux tower data, hydrologic or atmospheric model validation, and irrigation and water consumption studies.
Key functionalities and tools include:
reading sub-daily or daily station data (e.g. AmeriFlux, FLUXNET, or other CSV and Excel files) with a config file that holds the site metadata and column names
quality control with QC flags, averaging of multiple sensors, and a filter for days with too many sub-daily gaps
daily and monthly aggregation, with interpolation of short sub-daily gaps
energy balance closure corrections (energy balance ratio, Bowen ratio, and linear regression), optionally with photosynthetic or ecosystem biochemical energy storage removed from Rn - G
download of gridMET data and gap filling of daily ET with the gridMET reference ET fraction (ETrF)
partitioning of NEE into GPP and ecosystem respiration
ASCE reference ET and other meteorological calculations
interactive plots, unit conversions, and writing config files for batches of sites
Quick start
pip install fluxdataqaqc
from fluxdataqaqc import Data, QaQc
# read the config file and the station data
d = Data('US-Tw3_config.ini')
# resample to daily and monthly, filter days with data gaps
q = QaQc(d)
# energy balance closure correction, ET gaps filled with gridMET
q.correct_data(meth='ebr')
# save interactive plots (HTML) and daily and monthly CSV files
q.plot()
q.write()
Outputs are saved in an “output” folder next to the config file. The example config file and data are in examples/Basic_usage, see Installation for other ways to install and the Tutorial for each step and its options.
Contents: