aqua

AQUA model evaluation framework

https://github.com/destine-climate-dt/aqua

Science Score: 49.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (19.2%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

AQUA model evaluation framework

Basic Info
  • Host: GitHub
  • Owner: DestinE-Climate-DT
  • License: apache-2.0
  • Language: Python
  • Default Branch: main
  • Size: 484 MB
Statistics
  • Stars: 21
  • Watchers: 10
  • Forks: 2
  • Open Issues: 117
  • Releases: 56
Created almost 4 years ago · Last pushed 10 months ago
Metadata Files
Readme Changelog Contributing License Zenodo

README.md

maintenance-status AQUA tests Documentation Status codecov DOI

AQUA

The Application for QUality Assessment (AQUA) is a model evaluation framework designed for running diagnostics on high-resolution climate models, specifically for Climate DT climate simulations being part of Destination Earth activity. The package provides a flexible and efficient python3 framework to process and analyze large volumes of climate data. With its modular design, AQUA offers seamless integration of core functions and a wide range of diagnostic tools that can be run in parallel. AQUA offers:

  • Efficient handling of large datasets from high-resolution climate models;
  • Support for various data formats, such as NetCDF, GRIB, Zarr or FDB;
  • Robust and fast regridding functionality based on CDO;
  • Averaging and aggregation tools for temporal and spatial analyses;
  • Modular design for easy integration of new diagnostics.

Installation

AQUA requires python>=3.10,<3.13. Recommended installation should be done through a package manager for conda-forge (e.g. Miniforge).

Create conda/mamba environment and install packages

git clone git@github.com:DestinE-Climate-DT/AQUA.git cd AQUA mamba env create -f environment.yml mamba activate aqua

This installation will provide both the AQUA framework and the AQUA diagnostics.

Use of AQUA container

An alternative deployment making use of containers is available. Please refer to the Container chapter in the AQUA Documentation.

Documentation

Full AQUA Documentation is available on ReadTheDocs.

Examples

Please look at the notebook folder to explore AQUA functionalities.

Command lines tools

Please look at the cli folder to have access to the AQUA command line tools.

Contributing guide

Please refer to the Guidelines for Contributors if you want to join AQUA team!

License

AQUA is distributed as open source software under Apache 2.0 License. The copyright owner is the European Union, represented by the European Commission. The development of AQUA has been funded by the European Union through Contract DE_340_CSC - Destination Earth Programme Climate Adaptation Digital Twin (Climate DT). Further info can be found at https://destine.ecmwf.int/ and https://destination-earth.eu/

Owner

  • Name: DestinE-Climate-DT
  • Login: DestinE-Climate-DT
  • Kind: organization

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 210
  • Total pull requests: 222
  • Average time to close issues: 3 months
  • Average time to close pull requests: 14 days
  • Total issue authors: 26
  • Total pull request authors: 11
  • Average comments per issue: 1.76
  • Average comments per pull request: 1.99
  • Merged pull requests: 138
  • Bot issues: 0
  • Bot pull requests: 9
Past Year
  • Issues: 198
  • Pull requests: 220
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 10 days
  • Issue authors: 24
  • Pull request authors: 11
  • Average comments per issue: 1.62
  • Average comments per pull request: 2.0
  • Merged pull requests: 138
  • Bot issues: 0
  • Bot pull requests: 9
Top Authors
Issue Authors
  • mnurisso (55)
  • oloapinivad (44)
  • jhardenberg (30)
  • tovaz92 (14)
  • silviacaprioli (11)
  • CostanzaD (9)
  • maqsoodrajput (8)
  • mbatllem (6)
  • mcadau (6)
  • ainagaya (5)
  • nunomrm (4)
  • ghosh97 (2)
  • NataNazar (2)
  • ialsina (2)
  • ankitpatnala (1)
Pull Request Authors
  • mnurisso (76)
  • oloapinivad (47)
  • jhardenberg (28)
  • silviacaprioli (24)
  • tovaz92 (17)
  • dependabot[bot] (9)
  • mcadau (7)
  • ghosh97 (7)
  • maqsoodrajput (4)
  • ainagaya (2)
  • thomasrockhu-codecov (1)
Top Labels
Issue Labels
improvement (109) bug (48) diagnostic (46) discussion (20) question (13) framework (10) cli/scripts (9) workflow (8) not urgent (7) on-hold (6) documentation (4) graphics (3) test (3) reader (3) ¡URGENT! (3) observational data (3) IFS (2) NEMO (2) v0.13-operational (2) dependencies (2) dashboard (2) backlog 🗝️ (1) data source (1) duplicate (1) Phase2 (1)
Pull Request Labels
ready to merge (62) improvement (48) run tests (47) diagnostic (41) fix (30) framework (16) v0.13-operational (14) test (13) dependencies (11) workflow (10) cli/scripts (10) documentation (9) graphics (7) python (7) dashboard (6) reader (5) ¡URGENT! (5) on-hold (2) EC-EARTH (1) do not merge! (1) ICON (1) observational data (1) wontfix (1) not urgent (1)

Dependencies

.github/workflows/aqua-complete.yml actions
  • actions/checkout v4 composite
  • mamba-org/setup-micromamba v2 composite
.github/workflows/aqua.yml actions
  • actions/checkout v4 composite
  • actions/github-script v7 composite
  • baptiste0928/cargo-install v3.1.1 composite
  • mamba-org/setup-micromamba v2 composite
.github/workflows/create-container-from-tag.yaml actions
  • actions/checkout v4 composite
.github/workflows/create-fdb-container.yaml actions
  • actions/checkout v4 composite
diagnostics/ocean3d/pyproject.toml pypi
  • xarray *
diagnostics/seaice/pyproject.toml pypi
  • dask *
  • matplotlib *
  • xarray *
diagnostics/tropical_cyclones/pyproject.toml pypi
  • xarray *
diagnostics/tropical_rainfall/pyproject.toml pypi
  • fast-histogram *
pyproject.toml pypi
  • ECmean4 >=0.1.12
  • boto3 *
  • cartopy *
  • cfgrib *
  • dask *
  • dask_jobqueue *
  • docker *
  • eccodes ==2.39.2
  • fastparquet *
  • gcsfs *
  • gribscan *
  • gsv-interface ==2.9.0
  • h5py @git+https://github.com/h5py/h5py.git@3.12.1
  • intake ==0.7.0
  • intake-esm *
  • intake-xarray *
  • jinja2 *
  • kerchunk *
  • matplotlib *
  • metpy *
  • numpy *
  • pandas *
  • pyYAML *
  • pydantic *
  • pyfdb ==0.1.1
  • pypdf *
  • ruamel.yaml *
  • smmregrid ==0.1.0
  • sparse *
  • xarray *
environment.yml conda
  • cdo >=2.2.0
  • eccodes 2.40.0
  • hdf5
  • imagemagick
  • intake-esm
  • pandas
  • pip
  • python >=3.10,<3.13
  • tempest-extremes
  • xesmf