Technical details

We provide more information about the platform’s internals for instructors and contributors. Make sure you read Introduction to interactive notebooks before going on!

The computing environments

The computing environments available via MyBinder are Docker containers, or “software capsules” that can be created, pushed and pulled online. We create these containers using a few simple configuration files specifying the software packages and python libraries we would like to used in OGGM-Edu. These configurations files are found in this repository: https://github.com/OGGM/binder

MyBinder uses repo2docker to build these environments and stores them in a hidden database. Once built, they won’t be built again unless a new change is made to the OGGM/binder repository.

We use the same principle to build images that can be used by your own JupyterHub deployment, if you have one. These images are available here and form the base of the Binder environments. Their configuration files are found in this repository: https://github.com/OGGM/r2d. We use these in OGGM-Hub.

The notebooks

The notebooks are developped collaboratively. We welcome your input and contributions! You will find the directory with all notebooks (educational and tutorials) on GitHub: https://github.com/OGGM/oggm-edu-notebooks

This website

The content of this website is written within the Sphinx framework and is hosted on ReadTheDocs.

OGGM-Hub

We also provide a dedicated OGGM JupyterLab running on our own server: OGGM-Hub. The advantages of OGGM-Hub over Binder are:

  • more resources for your students, faster launches

  • user management: you can set passwords and user names at wish

  • persistent sessions: work can be saved between sessions and log-ins (this is probably the main advantage of OGGM-Hub)

hub.oggm.org is only available to registered users (registration is free!), but it won’t work for an entire class. If you have a specific need for an OGGM-hub service (e.g. for a one-week class or a workshop), please Get in touch to get access to classroom.oggm.org! classroom.oggm.org is a copy of hub.oggm.org, but with less resources allocated to each user (good enough for a class though!).