Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
69 lines (51 sloc) 2.63 KB

Technical details

We provide more information about the platform's internals for instructors and contributors. Make sure you read :ref:`notebooks_howto` before going on!

The computing environments

The computing environments available via Binder 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

Binder 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 :ref:`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 (experimental)

Thanks to a grant from Google's Data Solutions for Change, we are able to provide free resources to instructors for a specific class or workshop.

You can try OGGM-Hub if you have a GitHub account (free!). 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 :ref:`title_contact` and we'll try to arrange a specific set-up for you!

You can’t perform that action at this time.