Notebooks for geomorphology teaching

By Simon M Mudd

Overview

This repository contains jupyter notebooks for teaching various concepts in geomorphology.

The notebooks are intended for use on the University of Edinburgh’s Notable service.

Usage instructions

Here is how to get started using the notebooks

Using these notebooks in Noteable

1. If you are in one of Simon’s classes, you should be able to find the Notable link within the course materials section of the Learn page.

2. If you are not in a course, you can use the direct ease login. If you do this, make sure you start a notebook server with the "GeoScience" kernel.

Using these notebooks in docker

If you are not at the University of Edinburgh and are on a Docker-friendly operating system (Linux, MacOS, or a version of Windows 10 that has Windows linux Subsystem 2), you can download our docker image. See this website for instructions: https://hub.docker.com/repository/docker/lsdtopotools/lsdtt_pytools_docker

For a quickstart:

1. Once you have downloaded the container, run:

   $ docker run -it -v C:\LSDTopoTools:/LSDTopoTools -p 8888:8888 lsdtopotools/lsdtt_pytools_docker

2. then start notebook server with:

   # jupyter notebook --ip 0.0.0.0 --port 8888 --no-browser --allow-root

3. Then copy the token (NOT THE HTML address).

   1. Open a web broser and go to http://localhost:8888/

   2. In the password box, enter the token that you copied.

Using notebooks with a conda install

You can also use a conda environment.

Here is the explicit environment file: https://github.com/LSDtopotools/lsdtt_pytools_docker/tree/master/conda_environments

Download the pytools_env_explicit.txt file and run:

$ conda create --name lsd_pytools --file pytools_env_explicit.txt