This repository should hold code snippets and test cases to explore the use of plastic-style iceberg calving in the Open Global Glacier Model.

What does the acronym mean? Stay tuned...

chakra should work in the stress-free "minimal environment" required by OGGM's numerical core. The required packages are:

• numpy
• scipy
• pandas
• matplotlib
• shapely
• requests
• configobj
• netcdf4
• xarray
• pytest
• oggm

You can install them manually or let pip do it for you with:

pip install git+https://github.com/OGGM/oggm

Once in this environment, you can test OGGM alone with:

pytest --pyargs oggm

And, in the chakra folder, you can test chakra with:

pytest .

For the "full OGGM experience" you'll need a few more packages. For a stress free experience we recommend to use a dedicated conda environment (so that you can't break anything in the environments that work for you).

The easiest way to install all necessary packages with conda is to copy the content of this environment file into a text file, rename the environment to what suits you (in the linked file the environment is simply called "oggm_env"), and run:

conda env create -f environment.yml

This should be completely independant of all other conda environments you may have (conda documentation for reference).

Type source activate MY-ENV-NAME to enter the environment and run the tests as described in the section above.

Have fun!