flux-data-qaqc
flux-data-qaqc is a Python package for energy balance closure correction and post-processing of eddy covariance flux data. It starts from processed half-hourly, hourly, or daily station data, such as AmeriFlux and FLUXNET files, and produces daily and monthly time series of the surface energy balance components and evapotranspiration (ET) with quality control, gap filling, and energy balance closure corrections, along with interactive plots. Applications include hydrologic and atmospheric model validation, evaluation of satellite-based ET, and irrigation and water use studies.
Daily energy balance closure at the US-Tw3 AmeriFlux site before (init) and after (corr) the Energy Balance Ratio correction, one of the plots made by QaQc.plot. Click the figure to open all of the interactive plots for this site, or see the tutorial.
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
Installation
pip install fluxdataqaqcflux-data-qaqc requires Python 3.9 or newer. See the installation page for installing with the provided conda environment or in developer mode.
Quick start
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, and the tutorial explains each step and its options.
Used in
The eddy covariance ET benchmark dataset for 194 stations in the conterminous U.S. (Volk et al., 2023; data), used to assess the accuracy of OpenET (Volk et al., 2024).
Many others
Documentation
How to cite
Volk et al., (2021). flux-data-qaqc: A Python Package for Energy Balance Closure and Post-Processing of Eddy Flux Data. Journal of Open Source Software, 6(66), 3418, https://doi.org/10.21105/joss.03418
1 maintainer
Metadata
1 maintainer
Release files for fluxdataqaqc 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| fluxdataqaqc-0.7.0.tar.gz | 29.4 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fluxdataqaqc-0.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.5 MB
Release files / fluxdataqaqc-0.7.0.tar.gz
| Download URL | fluxdataqaqc-0.7.0.tar.gz |
|---|---|
| Size | 29.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eca24f1e862fc0cda48abafd6214d4dda740619cba972f8eacc3f560acde2921
|
|
BLAKE2b-256 checksum How to use checksums |
a4a399deaa1ef07fd04d9eee8438a3b460f29f9dad7447bbf0f6837545b022b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / fluxdataqaqc-0.7.0-py3-none-any.whl
| Download URL | fluxdataqaqc-0.7.0-py3-none-any.whl |
|---|---|
| Size | 74.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
afa35e184f243ff00c8527c80efd7897f08b8a4073d2ed904d0ec02d2a99f9cd
|
|
BLAKE2b-256 checksum How to use checksums |
2d13687827be4496fce9b1b16c91f49d446de77081fb8b7cf7d3bfeb84924ff0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Security for fluxdataqaqc 0.7.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
