Merge fca0374 into 3aa0f6b

docs/assets.rst

@@ -1,10 +1,9 @@
-Assets and downloads
-====================
+Other datasets
+==============
 
 This page lists some datasets that are either generated or used by OGGM and
 that can be useful to others.
 
-
 Shapefiles of glacier centerlines, flowlines and widths
 -------------------------------------------------------
 
@@ -28,21 +27,6 @@ If you use these data, please cite `Maussion et al., 2019 <https://gmd.copernicu
     Shapefile of OGGM's flowlines and widths for a subset of RGI region 15
 
 
-RGI-TOPO
---------
-
-The `RGI-TOPO <https://rgitools.readthedocs.io/en/latest/dems.html>`_ dataset
-provides a local topography map for each single glacier in the RGI (currently version 6).
-It was generated with OGGM, and can be used very easily from the :doc:`shop` (visit
-our `tutorials <https://oggm.org/tutorials>`_ if you want to learn how to use them!).
-
-.. figure:: _static/malaspina_topo.png
-    :width: 100%
-    :align: left
-
-    Example of the various RGI-TOPO products at Malaspina glacier
-
-
 Useful data tables
 ------------------
 

docs/cloud.rst

@@ -5,31 +5,176 @@ 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.
 
-.. image:: https://gke.mybinder.org/static/logo.svg
-    :width: 25%
-    :target: https://mybinder.org/v2/gh/OGGM/binder/stable?urlpath=git-pull?repo=https://github.com/OGGM/tutorials%26amp%3Bbranch=master%26amp%3Burlpath=lab/tree/tutorials/notebooks/welcome.ipynb%3Fautodecode
+We provide two solutions to try OGGM online, without local installation.
+
+The simplest and quickest solution is :ref:`oggm-binder` (no registration necessary).
+:ref:`oggm-hub` is much better for more serious work and requires to send us
+an email. If you are unsure, have a look at :ref:`hub-binder`!
+
+.. _oggm-binder:
 
-Our `Binder <https://mybinder.org/>`_ 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!
+OGGM-Binder
+-----------
+
+.. image:: https://mybinder.org/static/logo.svg
+    :width: 20%
+    :align: right
+    :target: https://mybinder.org/v2/gh/OGGM/tutorials/stable?labpath=notebooks%2Fwelcome.ipynb
+
+Thanks to the fantastic `MyBinder <https://mybinder.org>`_ 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!
 
 .. figure:: https://img.shields.io/badge/Launch-OGGM%20tutorials-579ACA.svg?style=popout&logo=data:image/png;base64,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
-  :target: https://mybinder.org/v2/gh/OGGM/binder/stable?urlpath=git-pull?repo=https://github.com/OGGM/tutorials%26amp%3Bbranch=master%26amp%3Burlpath=lab/tree/tutorials/notebooks/welcome.ipynb%3Fautodecode
-  :align: left
+  :target: https://mybinder.org/v2/gh/OGGM/tutorials/stable?labpath=notebooks%2Fwelcome.ipynb
 
 If you are new to the Jupyter Notebooks or to JupyterLab, you will probably
 find this `introduction to interactive notebooks`_ quite useful.
 
-.. warning::
+.. _introduction to interactive notebooks: http://edu.oggm.org/en/latest/notebooks_howto.html
+
+.. important::
 
     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.
 
     **If you want to use OGGM for more serious and permanent work**, we recommend to
-    either :doc:`install OGGM on your computer <installing-oggm>` or use
-    :doc:`hub`, an online service similar to Binder but persistent and
-    with access to more resources.
+    use :ref:`oggm-hub` or :doc:`install OGGM on your computer <installing-oggm>`.
 
 
-.. _introduction to interactive notebooks: http://edu.oggm.org/en/latest/notebooks_howto.html
+.. _oggm-hub:
+
+OGGM-Hub
+--------
+
+.. image:: _static/logos/hublogo.svg
+    :width: 25%
+    :align: right
+    :target: https://hub.oggm.org
+
+`hub.oggm.org`_ is our own `JupyterHub <https://jupyter.org/hub>`_ 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.
+
+.. figure:: https://img.shields.io/badge/Launch-OGGM%20hub-F37524.svg?style=popout&logo=data:image/png;base64,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
+  :target: https://hub.oggm.org
+  :align: left
+
+In order to be able to log in, you will need to have a (free) user account.
+It is super easy, just :ref:`contact` 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.
+
+.. warning::
+
+    `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**!
+
+.. _hub.oggm.org: https://hub.oggm.org
+
+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
+:ref:`system settings <system-settings>`) is shared among
+users (the ``shared`` folder in your ``$HOME``). The first time you run a
+new glacier, OGGM will first check if the data is available in the ``shared`` folder,
+and if not it will download it for you and the other users.
+
+.. figure:: _static/hub_envs.png
+    :width: 100%
+    :align: left
+
+    Welcome screen of https://hub.oggm.org
+
+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 ``pip install``),
+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
+your ``HOME`` with ``pip install --user``.
+
+Accessing the tutorials (and other content) with nbgitpuller
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Per default, your user space after logging in should be empty. We recommend
+using `nbgitpuller <https://jupyterhub.github.io/nbgitpuller>`_ to
+automatically download content from our
+`tutorials repository <https://github.com/OGGM/tutorials>`_ for you.
+
+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 ``tutorials`` folder
+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
+`OGGM-Edu notebooks <https://github.com/OGGM/oggm-edu-notebooks>`_).
+
+
+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 <https://github.com/ehultee/CdeC-glaciologia>`_
+(Spanish notebooks) into your lab as well. You can use the
+`nbgitpuller link generator <https://jupyterhub.github.io/nbgitpuller/link>`_
+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's tutorial notebooks to your hub <https://hub.oggm.org/hub/user-redirect/git-pull?repo=https://github.com/OGGM/tutorials%26amp%3Bbranch=master%26amp%3Burlpath=lab/tree/tutorials/notebooks/welcome.ipynb%3Fautodecode>`_
+- `Add Lizz's Clubes de Ciencia Perú 2019 notebooks to your hub <https://hub.oggm.org/hub/user-redirect/git-pull?repo=https%3A%2F%2Fgithub.com%2Fehultee%2FCdeC-glaciologia&urlpath=lab%2Ftree%2FCdeC-glaciologia%2F>`_
+
+.. important::
+
+    `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 <https://jupyterhub.github.io/nbgitpuller/topic/automatic-merging.html>`_.
+
+.. _hub-binder:
+
+Hub or Binder?
+--------------
+
+Which is best for you?  Here is a quick comparison.
+
+.. list-table:: Binder vs. OGGM-Hub
+   :widths: 20 20
+   :header-rows: 1
+
+   * - Binder
+     - OGGM-Hub
+   * - 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
+   * - Free!
+     - Free!

docs/conf.py

@@ -133,6 +133,8 @@
 
 redirects = {
     "input-data": "shop.html",
+    "pitfalls": "faq.html",
+    "hub": "cloud.html#oggm-hub",
     "mass-balance-2012-pergla": "mass-balance-monthly.html",
     "mass-balance-2012": "mass-balance-16guide.html",
 }
@@ -177,7 +179,6 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = 'en'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
@@ -228,7 +229,7 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 html_theme_options = {
-    "logo_only": True,
+    # "logo_only": True,
     "repository_url": "https://github.com/OGGM/oggm",
     "use_repository_button": True,
     "use_issues_button": True,

docs/contributing.rst

@@ -206,14 +206,13 @@ Installation
 ~~~~~~~~~~~~
 
 There are some extra requirements to build the docs: you will need to
-have ``sphinx``, ``sphinx-togglebutton``, ``sphinx-book-theme``, ``numpydoc``
-and ``ipython`` installed.
+have ``sphinx``, ``sphinx-togglebutton``, ``sphinx-book-theme``,
+``sphinx-reredirects``, ``numpydoc`` and ``ipython`` installed.
 
 If you have a conda environment named ``oggm_env``, you can install the extra
 requirements with::
 
-      mamba install -c conda-forge sphinx ipython numpydoc sphinx-book-theme
-      pip install sphinx-togglebutton
+      mamba install -c conda-forge sphinx ipython numpydoc sphinx-book-theme sphinx-reredirects sphinx-togglebutton
 
 If you don't have an oggm installation yet, download (or clone) the latest version
 of the oggm repository.

docs/download-projections.rst

@@ -0,0 +1,4 @@
+OGGM standard projections
+=========================
+
+TODO