Try OGGM online#
You can try OGGM in your web browser without having to install anything! This is the best way to run the tutorials or even do exploratory research to test the model, before you move on to more serious computations.
We provide two solutions to try OGGM online, without local installation.
The simplest and quickest solution is OGGM-Binder (no registration necessary). OGGM-Hub is much better for more serious work and requires to send us an email. If you are unsure, have a look at Hub or Binder?!
Thanks to the fantastic MyBinder service, our OGGM-Binder test space is available to anyone, with no registration necessary. Using it is very simple. Just click on the link below to get you started!
If you are new to the Jupyter Notebooks or to JupyterLab, you will probably find this introduction to interactive notebooks quite useful.
Binder environments are only temporary! Perfect for trying and learning, but not suitable for development work. Remember to download your notebooks at the end of a session if you want to keep them for later.
hub.oggm.org is our own JupyterHub deployment of OGGM on our servers in Bremen. It works similarly to MyBinder but it is bound to a username (you’ll need an account) and is therefore persistent (your files are saved between sessions). It also gives you access to more computing resources than MyBinder.
In order to be able to log in, you will need to have a (free) user account. It is super easy, just Get in touch if you want to try it out! Please briefly introduce yourself and tell us why you would like an account, so that we can guide you towards the next steps.
hub.oggm.org is still experimental and we cannot guarantee that your work will always be safe here. We will do our best, but, you know, we are scientists after all. Please, make a copy of your files from time to time!
How does this work?#
We use a single compute node located in Bremen to welcome the hub users.
Currently (we are still trying things out) each user gets enough CPUs (4) and
enough RAM (8Gb) to run OGGM on several glaciers at once.
This is not enough to do heavy work, but will get you through the exploratory
phase or even small regional runs. Each user also gets a persistent 16Gb disk
to save output data, notebooks and scripts. The OGGM-specific input data
(i.e. everything that is downloaded automatically between users, see
system settings) is shared among
shared folder in your
$HOME). The first time you run a
new glacier, OGGM will first check if the data is available in the
and if not it will download it for you and the other users.
When logging in, you can choose between two environments:
oggm_latest, with the latest OGGM installed from master (updated every few weeks)
oggm_vXXX(starting from OGGM v1.4), which are environments made with a pinned OGGM version
These environments are restarted each time you log-out and log-in again
(don’t worry, your
HOME and all it contains won’t be erased!). This means
that while you can install things in the root tree (e.g. with
it won’t be there the next time you open your hub. If you have special
requirements, please let us now so that we can add them, or install them in
pip install --user.
Accessing the tutorials (and other content) with nbgitpuller#
You can execute this command in your JupyterHub terminal (Launcher -> Start a terminal):
$ gitpuller https://github.com/OGGM/tutorials master tutorials
That will copy the notebooks into the
in your home directory (on OGGM-Hub, not your local machine).
You can use a similar command to pull content from other repositories as well (e.g. the
Another way to pull content into your hub is to use a special weblink. Say, for example, that you would like to download the content of Lizz’s glacier course (Spanish notebooks) into your lab as well. You can use the nbgitpuller link generator to create the following links which, once clicked, will open your workspace with the new notebooks in it. Here are some useful links to add notebooks to your hub:
nbgitpuller will never overwrite changes that the user made to the files in the pulled folder. This is very important to remember: sometimes you would like to get an updated version of the notebooks for example, and this will not work if you made changes to the file there. Therefore, it is always a good idea to make a working copy of the original file/folder before working on it (right-click -> rename).
The full set of rules used by nbgitpuller while pulling is explained here.
Hub or Binder?#
Which is best for you? Here is a quick comparison.
Files not saved between sessions
Files saved between sessions
Limited computational resources
Dedicated processing and space on OGGM servers
Use cases: quick tests and demos
Use cases: deeper explorations and teaching
Can be slow to start / unreliable
Reliable (with due caution!)
No registration required
Contact us to register