Skip to content
Repository for ipython notebooks demonstrating functionality of pygplates
Jupyter Notebook Other
Branch: master
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data add static polygons shapefiles Jun 19, 2019
docker upgrade to python3 Mar 13, 2020
libs upgrade to python3 Mar 13, 2020
notebooks remove five notebook as per dietmar's request Apr 14, 2020
.gitignore remove notebook.sh Sep 27, 2019
LICENSE.md Initial commit Feb 3, 2016
README.md Update README.md Mar 19, 2020

README.md

pygplates-tutorials

Introduction

This repository contains jupyter notebooks which demonstrate how to use pygplates in plate tectonic research. The notebooks are designed to be a companion to the pygplates documentation. The documentation contains sample code illustrating in a general sense how to perform certain tasks; these notebooks contain worked examples on actual data sets.

Getting Started

Step 1: Download the repository

git clone --depth=1 https://github.com/GPlates/pygplates-tutorials.git

Note that this requires git to be installed on your local system. Alternatively you can download the repository as a zip file (and extract on your local system).

Step 2: Pull the gplates/pygplates-notebook docker container

install Docker https://www.docker.com/ if you have not done so.

docker pull gplates/pygplates-tutorials

Step 3: Run the Docker container

in the top level folder of this repository(pygplates-tutorials)

docker run -it --rm -p 18888:8888 -v `pwd`:/home/workspace gplates/pygplates-tutorials

Note that this sets up Docker to display notebooks in your current working directory (where you cloned or downloaded the Github repository).

Step 4: Check the notebooks in a web browser

http://localhost:18888/tree/notebooks

Note that if you are running Docker Toolbox on Windows then replace localhost with the output of docker-machine ip.

System Requirements:

If you would like to run the notebooks in your computer directly(instead of using Docker), you need to install all the required dependencies.

The fundamental requirement to run these notebooks is to have pygplates for python3 installed. Installation instructions can be found in the pygplates user documentation. Other python modules and libraries used by the notebooks are listed in docker/Dockerfile.

It is strongly recommended to use Docker container to run these notebooks.

Notes about Docker:

You don't need to read this section unless you are interested in learning a bit about Docker.

build the docker image:

cd docker
docker build -t gplates/pygplates-tutorials .

run the docker container:

cd pygplates-tutorials
docker run -it --rm -p 18888:8888 -v `pwd`:/home/workspace gplates/pygplates-tutorials

push Docker image to Dockerhub.com

docker push gplates/pygplates-tutorials

About

These tutorials stem from the work of Simon Williams, Michael Tetley, John Cannon and Michael Chin at EarthByte Group, University of Sydney, 2016-present

For general information on GPlates, please see the gplates website: www.gplates.org

The pygplates documentation can be found here: www.gplates.org/docs/pygplates/index.html

If you have issues or questions, you may post the questions in GPlates online forum https://discourse.gplates.org.

or submit an inquiry here https://www.earthbyte.org/contact-us-3/

You can’t perform that action at this time.