The coupled snowpack and ice surface energy and mass balance model in Python COSIPY solves the energy balance at the surface and is coupled to an adaptive vertical multi-layer subsurface module.

Documentation

The documentation for COSIPY is available at the following link: https://cosipy.readthedocs.io/en/latest/

Confused about migrating to the new .toml configuration system? The documentation contains an in-depth tutorial and a guide on upgrading.

Convert your existing configuration files before merging the latest update:

pip install toml
git fetch --all
git checkout master -- convert_config.py
python convert_config.py  # generate .toml files

This works on any branch regardless of local changes. Alternatively you can copy and run convert_config.py into any older COSIPY source tree.

This will preserve your configuration for config.py, constants.py, aws2cosipyConfig.py and wrf2cosipyConfig.py. Parameters for create_static must still be added manually to the generated utilities_config.toml.

Checkout a new branch with a clean version of COSIPY and merge your modifications. This minimises the number of merge conflicts. After updating to the latest version of COSIPY, run python COSIPY.py --help to see how to specify paths to configuration files. COSIPY will default to ./config.toml, ./constants.toml, ./slurm_config.toml, ./utilities_config.toml in the current working directory.

Installation

Install GDAL:

sudo apt-get install gdal-bin libgdal-dev
pip install --upgrade gdal==`gdal-config --version` pybind11  # with pip
conda install gdal  # with conda

Install COSIPY with pip (for general use):

pip install cosipymodel
cosipy-setup  # generate template configuration files
cosipy-help   # view help

Install COSIPY as an editable (recommended for development):

git clone https://github.com/cryotools/cosipy.git
cd cosipy
make install          # using conda/mamba
make install-pip-dev  # using pip

cosipy-help           # view help

Install COSIPY from source (for development):

git clone https://github.com/cryotools/cosipy.git
cd cosipy
make install-conda-envs                      # install using conda/mamba
conda install --file conda_requirements.txt  # install with conda

pip install -r requirements.txt              # install default environment
pip install -r dev_requirements.txt          # install dev environment

python3 COSIPY.py -h
make commands

Communication and Support

We are using the groupware slack for communication (inform about new releases, bugs, features, ...) and support: https://cosipy.slack.com

About

Tests:
Citation:
License: