DeepIceDrain

Mapping and monitoring deep subglacial water activity in Antarctica using remote sensing and machine learning.

Getting started

Quickstart

Launch in Pangeo Binder (Interactive jupyter lab environment in the cloud).

Installation

Basic

To just try out the scripts, download the environment.yml file from the repository and run the commands below:

cd deepicedrain
conda env create --name deepicedrain --file environment.yml
pip install git+https://github.com/weiji14/deepicedrain.git

Advanced

To help out with development, start by cloning this repo-url

git clone <repo-url>

Then I recommend using conda to install the non-python binaries. The conda virtual environment will also be created with Python and poetry installed.

cd deepicedrain
conda env create -f environment.yml

Activate the conda environment first.

conda activate deepicedrain

Then install the python libraries listed in the pyproject.toml/poetry.lock file.

poetry install

Finally, double-check that the libraries have been installed.

poetry show

(Optional) Install jupyterlab extensions for interactive bokeh visualizations.

jupyter labextension install @pyviz/jupyterlab_pyviz
jupyter labextension install dask-labextension

jupyter labextension list  # ensure that extensions are installed

Running jupyter lab

conda activate deepicedrain
python -m ipykernel install --user --name deepicedrain  # to install conda env properly
jupyter kernelspec list --json                          # see if kernel is installed
jupyter lab &