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.

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