scahpy 2.0.5

SCAHpy — System for Coupled Atmosphere–Hydrosphere Analysis in Python

📢 SCAHpy v2.0 — Major Release ⭐ Version 2.0 of SCAHpy is now available with improved stability, new analytical and plotting features, and a fully reorganized documentation framework. The official documentation is now provided in two languages: English and Spanish, increasing accessibility for both regional and international research communities.

What is SCAHpy?

SCAHpy (System for Coupled Atmosphere–Hydrosphere Analysis in Python) is an open-source scientific Python package that facilitates the analysis and visualization of outputs from the atmospheric, oceanic, and hydrological components of IGP RESM-COW coupled model (see ref1, ref2).

It provides tools for processing, diagnosing, and visualizing model results in a modular and reproducible way.

Why SCAHpy?

The atmospheric and oceanic components of coupled models generate large volumes of output data, making post-processing and diagnostics complex.
SCAHpy simplifies these tasks by streamlining data handling, coordinate management, and temporal adjustments (e.g., conversion to local time), while integrating high-level plotting utilities for maps, sections, and time-series analyses.

Its design is inspired by the principles of open and reproducible science, promoting accessibility and collaboration across research institutions.

How to use SCAHpy?

SCAHpy can be used as a standalone Python package or within high-performance computing environments such as the HPC-IGP Cluster, which hosts more than 22 years of regional coupled simulations over the Peruvian domain.

Note: SCAHpy has been developed and validated using IGP RESM-COW model outputs. However, it is fully compatible with any WRF or CROCO-based dataset or NetCDF output following CF-Conventions. Community contributions are welcome!

Documentation

The official documentation is hosted here:
👉 https://fiorelacl.github.io/SCAHpy/

It is available in English and Spanish, with a complete bilingual structure using Quarto profiles.

Installation

Using Mamba

1. Install mamba or miniconda through Miniforge.
2. Create the environment using the included environment.yml:

 mamba env create --file environment.yml -n scahpy_env

Using pip

1. To install SCAHpy directly. Open a terminal, then run the following command:

 pip install scahpy

Note: Checkout the contribution page if you want to get involved and help maintain or develop SCAHpy