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.
Binder is the solution available to anyone (no registration necessary), but it provide only temporary environments. Perfect for tutorials and trying things out!
OGGM-Hub is our own deployment on our server. Use OGGM-Hub if you want to rely on a persistent environment and more computing resources to run your experiments.
Using Binder 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 on OGGM-Edu 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.
This is our own JupyterHub deployment of OGGM on dedicated resources.
Thanks to a server installed at the University of Bremen and maintained by Timo, we are able to provide free resources to anyone interested in using and testing OGGM more seriously. In order to be able to log-in on hub.oggm.org, you will need to have a user account. It is super easy, just Get in touch if you want to try it out!
Similarly, if you are new to the Jupyter Notebooks and JupyterLab, you will probably find this introduction on OGGM-Edu quite useful.
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 compute node to welcome the hub users, who have to share the resources attributed to the hub. Currently (we are still trying things out), each user gets enough CPUs and enough RAM 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 input data is shared among users, but the first time you run a new glacier, OGGM might download the necessary data for you.
Accessing the tutorials (and other content) with nbgitpuller¶
You can execute this command in the terminal for example:
$ gitpuller https://github.com/OGGM/oggm-edu-notebooks master oggm-edu-notebooks
Which means that the OGGM-Edu notebooks are copied into the oggm-edu-notebooks folder in your home directory. You can use the a similar command in your lab’s terminal to pull content from other repositories as well. Another way to pull content is to use a special link to open your hub. Say, for example, that you would like to download the content of Lizz’ glacier course (spanish notebooks) in your lab as well. You can use the 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:
- Add OGGM-Edu’s tutorial notebooks to your hub
- Add Lizz’s Clubes de Ciencia Perú 2019 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 or your students would like to get an updated version of the notebooks for example, and this will not work if the file changed. Therefore, it is always a good idea to make a working copy of the original file/folder before working in it (right-click -> rename).
The full set of rules used by nbgitpuller while pulling is explained here
Frequent use-case: copy-pasting text with the mouse in JupyterLab¶
Copying to and from JupyterLab can be annoying at times (context). This is one of the most frequent issue hitting users of JupyterLab, when working in a terminal (Launcher -> Start a terminal) or when selecting text from notebook cells.
In these cases, press
shift + right click to experience a standard
“copy/paste” mouse menu.