Prerequisites

Installation

To install CryoSwath, clone the GitHub repository.

git clone git@github.com/j-haacker/cryoswath.git

Then install it into your projects virtual environment. If you don’t use virtual environments, please do so for this project to ensure all dependencies can be satisfied. You can install CryoSwath by running:

pip install --editable <path that you cloned into>

Supplying the --editable flag allows you to update and modify CryoSwath.

Continue by running cryoswath-init.

This will setup a directory structure, download the package, and download some small auxiliary files. Large resource dependency need to be downloaded manually.

The above installation is the recommended. Refer to the readme for a variety of alternatives that may help incase of issues. Among the alternatives, there is a fallback strategy using a docker container.

Data dependencies

CryoSwath needs a reference elevation model. Currently, ArcticDEM and REMA of the Polar Geospatial Center, University of Minnesota (https://www.pgc.umn.edu/data/) are supported. To use other sources, add their paths to cryoswath.misc.get_dem_reader(). Deposit them in data/auxiliary/DEM or change dem_path in cryoswath.misc to your needs.

Further, if you would like to take advantage of the basin shapes provided in the Randolph Glacier Inventory, download them as needed. Make sure to download both products, “G” (glaciers/basins) and “C” (complexes). CryoSwath will give you hints, if any data is missing, as you go. Deposit the shape files in data/auxiliary/RGI or change rgi_path in cryoswath.misc to your needs. If you already know what data you need, find them at the nsidc repository.

Software dependencies

The software dependencies should have been installed when you ran pip install --editable ./cryoswath (see above). The dependencies can be found in the pyproject.toml. There is a historic requirements.txt that used to list dependencies that are needed or beneficial to run CryoSwath. However, it is not well maintained. Note, that the package names are “conda” names; “pip” names my be slightly different.