Make it pink (#14)

docs/_static/style.css

@@ -1,13 +1,13 @@
 @import url("theme.css");
 
 .wy-side-nav-search {
-  background-color: #9cb7c9;
+  background-color: #e1a7e0;
 }
 
 .wy-side-nav-search>div.version {
   display: none;
 }
 
 .wy-nav-top {
-  background-color: #9cb7c9;
+  background-color: #e1a7e0;
 }

docs/explorer.rst

@@ -10,7 +10,7 @@ The world glacier explorer is an interactive application allowing to explore
 the location of the glaciers and their climate.
 
 
-You can open it by clicking on this link: |badgelink|_
+You can start the app by clicking on this link: |badgelink|_
 
 .. |badgelink| image::  https://img.shields.io/badge/launch-binder%20app-579ACA.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFkAAABZCAMAAABi1XidAAAB8lBMVEX///9XmsrmZYH1olJXmsr1olJXmsrmZYH1olJXmsr1olJXmsrmZYH1olL1olJXmsr1olJXmsrmZYH1olL1olJXmsrmZYH1olJXmsr1olL1olJXmsrmZYH1olL1olJXmsrmZYH1olL1olL0nFf1olJXmsrmZYH1olJXmsq8dZb1olJXmsrmZYH1olJXmspXmspXmsr1olL1olJXmsrmZYH1olJXmsr1olL1olJXmsrmZYH1olL1olLeaIVXmsrmZYH1olL1olL1olJXmsrmZYH1olLna31Xmsr1olJXmsr1olJXmsrmZYH1olLqoVr1olJXmsr1olJXmsrmZYH1olL1olKkfaPobXvviGabgadXmsqThKuofKHmZ4Dobnr1olJXmsr1olJXmspXmsr1olJXmsrfZ4TuhWn1olL1olJXmsqBi7X1olJXmspZmslbmMhbmsdemsVfl8ZgmsNim8Jpk8F0m7R4m7F5nLB6jbh7jbiDirOEibOGnKaMhq+PnaCVg6qWg6qegKaff6WhnpKofKGtnomxeZy3noG6dZi+n3vCcpPDcpPGn3bLb4/Mb47UbIrVa4rYoGjdaIbeaIXhoWHmZYHobXvpcHjqdHXreHLroVrsfG/uhGnuh2bwj2Hxk17yl1vzmljzm1j0nlX1olL3AJXWAAAAbXRSTlMAEBAQHx8gICAuLjAwMDw9PUBAQEpQUFBXV1hgYGBkcHBwcXl8gICAgoiIkJCQlJicnJ2goKCmqK+wsLC4usDAwMjP0NDQ1NbW3Nzg4ODi5+3v8PDw8/T09PX29vb39/f5+fr7+/z8/Pz9/v7+zczCxgAABC5JREFUeAHN1ul3k0UUBvCb1CTVpmpaitAGSLSpSuKCLWpbTKNJFGlcSMAFF63iUmRccNG6gLbuxkXU66JAUef/9LSpmXnyLr3T5AO/rzl5zj137p136BISy44fKJXuGN/d19PUfYeO67Znqtf2KH33Id1psXoFdW30sPZ1sMvs2D060AHqws4FHeJojLZqnw53cmfvg+XR8mC0OEjuxrXEkX5ydeVJLVIlV0e10PXk5k7dYeHu7Cj1j+49uKg7uLU61tGLw1lq27ugQYlclHC4bgv7VQ+TAyj5Zc/UjsPvs1sd5cWryWObtvWT2EPa4rtnWW3JkpjggEpbOsPr7F7EyNewtpBIslA7p43HCsnwooXTEc3UmPmCNn5lrqTJxy6nRmcavGZVt/3Da2pD5NHvsOHJCrdc1G2r3DITpU7yic7w/7Rxnjc0kt5GC4djiv2Sz3Fb2iEZg41/ddsFDoyuYrIkmFehz0HR2thPgQqMyQYb2OtB0WxsZ3BeG3+wpRb1vzl2UYBog8FfGhttFKjtAclnZYrRo9ryG9uG/FZQU4AEg8ZE9LjGMzTmqKXPLnlWVnIlQQTvxJf8ip7VgjZjyVPrjw1te5otM7RmP7xm+sK2Gv9I8Gi++BRbEkR9EBw8zRUcKxwp73xkaLiqQb+kGduJTNHG72zcW9LoJgqQxpP3/Tj//c3yB0tqzaml05/+orHLksVO+95kX7/7qgJvnjlrfr2Ggsyx0eoy9uPzN5SPd86aXggOsEKW2Prz7du3VID3/tzs/sSRs2w7ovVHKtjrX2pd7ZMlTxAYfBAL9jiDwfLkq55Tm7ifhMlTGPyCAs7RFRhn47JnlcB9RM5T97ASuZXIcVNuUDIndpDbdsfrqsOppeXl5Y+XVKdjFCTh+zGaVuj0d9zy05PPK3QzBamxdwtTCrzyg/2Rvf2EstUjordGwa/kx9mSJLr8mLLtCW8HHGJc2R5hS219IiF6PnTusOqcMl57gm0Z8kanKMAQg0qSyuZfn7zItsbGyO9QlnxY0eCuD1XL2ys/MsrQhltE7Ug0uFOzufJFE2PxBo/YAx8XPPdDwWN0MrDRYIZF0mSMKCNHgaIVFoBbNoLJ7tEQDKxGF0kcLQimojCZopv0OkNOyWCCg9XMVAi7ARJzQdM2QUh0gmBozjc3Skg6dSBRqDGYSUOu66Zg+I2fNZs/M3/f/Grl/XnyF1Gw3VKCez0PN5IUfFLqvgUN4C0qNqYs5YhPL+aVZYDE4IpUk57oSFnJm4FyCqqOE0jhY2SMyLFoo56zyo6becOS5UVDdj7Vih0zp+tcMhwRpBeLyqtIjlJKAIZSbI8SGSF3k0pA3mR5tHuwPFoa7N7reoq2bqCsAk1HqCu5uvI1n6JuRXI+S1Mco54YmYTwcn6Aeic+kssXi8XpXC4V3t7/ADuTNKaQJdScAAAAAElFTkSuQmCC
 .. _badgelink: https://mybinder.org/v2/gh/panel-demos/glaciers/master?urlpath=/proxy/5006/app
@@ -20,9 +20,11 @@ The app contains five elements:
 - the **header text** indicates how many glaciers are currently selected
   (active), and how much of the total area they represent.
 - the **top left panel** is a map of the glacier locations and their area. Moving
-  the mouse over a glacier pixel gives you its glaciated area
+  the mouse over a glacier pixel gives you its glaciated area. Be aware that
+  the map projection is misleading: northern latitudes appear much bigger on
+  the map than they really are.
 - the **top right panel** displays the elevation of the glaciers with respect to
-  their latitude
+  their latitude.
 - the **bottom left panel** shows the histogram of the glaciers' mean temperature
   (at the glacier's mean elevation).
 - the **bottom right panel** shows the histogram of the glaciers' mean annual
@@ -31,22 +33,49 @@ The app contains five elements:
 When selecting data in each of these panels, the other panels are actualized
 automatically, allowing to ask questions such as:
 
-- where are the wettest glaciers located? And the driests?
+- where are the wettest glaciers located? And the driest?
 - is there a relationship between temperature and precipitation?
 - how much glacier area is found on Greenland? In the European Alps?
 - what is the relationship between latitude and glacier elevation?
 - ...
 
 
+Authors
+-------
+
+`Philipp Rudiger <https://github.com/philippjfr>`_ and
+`James Bednar <https://github.com/jbednar>`_ from
+`PyViz <http://pyviz.org/>`_, based on an original
+`Dash application <https://dash.klima.uni-bremen.de/apps/explore>`_ by
+`Fabien Maussion <https://fabienmaussion.info/>`_.
+
+
 Data sources
 ------------
 
+The app displays all glaciers worldwide with the exception of Antarctica, where
+no climate data is available. Glacier location and area are obtained
+from the `Randolph Glacier Inventory version 6 <https://www.glims.org/RGI/>`_.
+
+The climate data (temperature and precipitation) is extracted from the
+CRU TS v4.01 data `provided <https://crudata.uea.ac.uk/cru/data/hrg/>`_
+by the Climatic Research Unit of the University of East Anglia.
+
+Topography data is obtained from
+`various data sources <https://docs.oggm.org/en/latest/input-data.html#topography-data>`_.
+
+The data processing was realized with the OGGM model for
+`this scientific paper <https://www.geosci-model-dev-discuss.net/gmd-2018-9/>`_.
+
 Possible improvements
 ---------------------
 
 - By using other data sources (e.g. ERA-Interim), it would be possible to plot
   the Antarctic glaciers as well.
-- With a selection by category, it would be possible to differenciate glaciers
+- The elevation / latitude plot could also be binned an colored per area,
+  although it might be inaccurate because the data does not contain multiple
+  elevations bands per glaciers (yet).
+- With a category choice bar, it would be possible to differentiate glaciers
   from ice-caps or marine terminating glaciers from land-terminating ones.
 - By using the data from the global ITMIX experiment, it is possible to convert a
   selection into sea-level rise equivalent.

docs/glacier_basics.rst

@@ -0,0 +1,111 @@
+.. _glacier_basics:
+
+Introduction to glaciers
+========================
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/gif/glacier.gif
+    :width: 100%
+
+
+A collection of free glacier graphics that can be used for education and
+outreach.
+
+
+**License**: `Creative Commons Attribution-NonCommercial 4.0 International License <http://creativecommons.org/licenses/by-nc/4.0/>`_
+
+.. figure:: https://i.creativecommons.org/l/by-nc/4.0/88x31.png
+    :target: http://creativecommons.org/licenses/by-nc/4.0/
+
+
+Feel free to use / adapt the graphics, but always refer to the original author
+and do not sell them.
+
+**Author**: Anne Maussion, `Atelier les Gros yeux <http://atelierlesgrosyeux.com>`_
+
+This series of graphics was designed for a talk given by
+`Fabien Maussion <https://fabienmaussion.info/>`_ to a general audience. He used
+them to explain the concepts of accumulation, ablation, equilibrium line
+altitude and mass movements in a glacier.
+
+**Download**: `zip file <https://github.com/OGGM/glacier-graphics/blob/master/glacier_intro/glacier_intro.zip?raw=true>`_, `gif <https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/gif/glacier.gif>`_
+
+Single images with explanations
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_01.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_01.png
+
+The first image just sets the scene and allows to explain that we are now
+looking at a typical mountain glacier from a cross-section along the main
+ice flow.
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_02.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_02.png
+
+We then announce that we are looking at the processes at the glacier surface
+first. This helps to bring the focus to it first.
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_03.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_03.png
+
+**Accumulation**: definition, which processes are at play, how you measure it,
+typical values...
+The time you want to spend on it is up to you. Note that some snow flakes
+now appears on the upper left corner!
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_04.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_04.png
+
+**Ablation**: definition, which processes are at play, how you measure it,
+typical values...
+The time you want to spend on it is up to you. Note that a sun
+now appears on the upper right corner!
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_05.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_05.png
+
+**Mass Balance**: definition, over which period you measure it,
+typical values...
+The time you want to spend on it is up to you. Note that the formula is now
+complete!
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_06.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_06.png
+
+The imbalance between accumulation and ablation is
+compensated by a **movement of ice** from top to bottom. If this is where you
+want to bring your talk to, you can use the mass flux arrow to explain the
+principles of ice thickness inversion using mass conservation principles.
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_07.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_07.png
+
+Concept of **Equilibrium Line Altitude** (ELA).
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_08.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_08.png
+
+More accumulation and/or less ablation leads to a **decrease** of the ELA. You
+might want to highlight the changes in surface mass budget as well as the
+increased solid precipitation and/or the shaded sun.
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_09.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_09.png
+
+This new imbalance increases the flux of ice through the glacier (hence the
+wider arrow) and results in a glacier advance. See the response time section
+below for a companion graphic.
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_10.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_10.png
+
+
+Less accumulation and/or more ablation leads to an **increase** of the ELA. You
+might want to highlight the changes in surface mass budget as well as the
+decreased solid precipitation and/or the stronger sun.
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/thumbnails/glacier_11.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_intro/png/glacier_11.png
+
+This new imbalance decreases the flux of ice through the glacier (hence the
+thinner arrow) and results in a glacier retreat. See :ref:`glacier_lowpass` for a companion graphic.

docs/glacier_lowpass.rst

@@ -0,0 +1,45 @@
+.. _glacier_lowpass:
+
+Glacier as low-pass filters
+===========================
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_04.png
+
+A collection of free glacier graphics that can be used for education and
+outreach.
+
+
+**License**: `Creative Commons Attribution-NonCommercial 4.0 International License <http://creativecommons.org/licenses/by-nc/4.0/>`_
+
+.. figure:: https://i.creativecommons.org/l/by-nc/4.0/88x31.png
+    :target: http://creativecommons.org/licenses/by-nc/4.0/
+
+
+Feel free to use / adapt the graphics, but always refer to the original author
+and do not sell them.
+
+**Author**: Fabien Maussion with the `OGGM <http://oggm.org>`_ model.
+
+**Code**: `OGGM-edu <https://github.com/OGGM/oggm-edu/blob/master/gen_plots/ela_changes_response_time.ipynb>`_
+
+**Download**: `zip file <https://github.com/OGGM/glacier-graphics/blob/master/glacier_response/glacier_response.zip>`_
+
+This series of graphics was used right after the graphics above to explain
+the concepts of **response time** (or time constant) and **low-pass filter**.
+
+There are several stages to click through (useful for presentations):
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_01.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_01.png
+
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_02.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_02.png
+
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_03.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_03.png
+
+
+.. figure:: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_04.png
+    :target: https://raw.githubusercontent.com/OGGM/glacier-graphics/master/glacier_response/png/tau_04.png

docs/index.rst

@@ -28,3 +28,17 @@ Interactive Notebooks
     :caption: Interactive Notebooks
 
     notebooks_howto.rst
+
+Graphics
+^^^^^^^^
+
+* :doc:`glacier_basics`
+* :doc:`glacier_lowpass`
+
+.. toctree::
+    :maxdepth: 1
+    :hidden:
+    :caption: Graphics
+
+    glacier_basics.rst
+    glacier_lowpass.rst