aqua-core 1.0.0a1

AQUA; a model evaluation framework for high-resolution climate model simulations

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 [e-mail]: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/