Metadata-Version: 2.4
Name: acacia_s2s_toolkit
Version: 2.40
Summary: A python package to support download and analysis of forecasts from S2S prediction project database.
Author-email: Joshua Talib <joshuatalib@ecmwf.int>, Innocent Masukwedza <g.t.masukwedza@reading.ac.uk>, Piotr Wolski <wolski@csag.uct.ac.za>
Project-URL: Homepage, https://github.com/joshuatalib/acacia_s2s_toolkit
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.23
Requires-Dist: cdo>=1.6.0
Requires-Dist: xarray>=2024.9.0
Requires-Dist: eccodes>=2.40.0
Requires-Dist: dask>=2024.9.0
Requires-Dist: pandas>=2.2.3
Requires-Dist: scipy>=1.14.1
Requires-Dist: netCDF4>=1.7.2
Requires-Dist: requests>=2.32.2
Requires-Dist: matplotlib>=3.8
Requires-Dist: cartopy>=0.22
Requires-Dist: huracanpy>=1.3.1
Requires-Dist: geopandas>=1.0.0
Requires-Dist: cdsapi>=0.7.7
Requires-Dist: xesmf>=0.7
Requires-Dist: pooch>=1.9
Dynamic: license-file

# ACACIA S2S Toolkit (`acacia-s2s-toolkit`)

> **Disclaimer:** This package is provided for research purposes only. It is **not** intended for use in any operational or production context. It is not an officially supported ECMWF software product.

## Overview

`acacia-s2s-toolkit` is a Python library that supports downloading and post-processing of dynamical sub-seasonal forecast data from the ECMWF Data Store

It builds on [xarray](https://xarray.dev/) for efficient NetCDF-based data handling.

---

## Installation

To install the *acacia-s2s-toolkit* on Linux, run the following command:

**python3 -m pip install acacia_s2s_toolkit**

For guidance on installing Python 3 or pip, refer to the official documentation.

---

## Dependencies

The AI-WQ-package requires the following dependencies:

- **numpy** (version 1.23 or higher)
- **xarray** (version 2024.09.0 or higher)
- **dask** (version 2024.9.0)
- **pandas** (version 2.2.3 or higher)
- **scipy** (version 1.14.1 or higher)
- **netCDF4** (version 1.7.2 or higher)
- **requests** (versions 2.32.2 or higher)
- **matplotlib** (versions 3.8 or higher)
- **cartopy** (versions 0.22 or higher)

If these dependencies conflict with your current working environment, consider installing the package in a new virtual environment.

---

## Upgrading the Package

To upgrade to the latest version, run:

**python3 -m pip install --upgrade acacia_s2s_toolkit**

This project is being actively developed. New updates may be released periodically with detailed annoucements given on the ECMWF-hosted forum.

---

## Software Maturity

| Attribute        | Status |
|------------------|--------|
| **Maturity**     | [![Static Badge](https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity/sandbox_badge.svg)](https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity#sandbox) |
| **Support level**| Best effort — no guaranteed response time |
| **Operational use** | Not suitable for operational use |


> [!IMPORTANT]
> This software is **Sandbox**, is under active development, and subject to ECMWF's guidelines on [Software Maturity](https://github.com/ecmwf/codex/raw/refs/heads/main/Project%20Maturity). Releases are intended for testing, evaluation, and collaboration rather than production deployment.

---

## License

This project is licensed under the **Apache License 2.0**. See the [LICENSE](LICENSE) file for the full text.

---

## Support

This package is **not officially supported** by ECMWF. 

For general ECMWF-related enquiries, please use the [ECMWF Service Desk](https://support.ecmwf.int/).

---

## Documentation

Full documentation is available on ReadTheDocs:

**https://acacia-s2s-toolkit.readthedocs.io/en/latest/**
