add tutorials (#37)

OGGM · Feb 21, 2019 · 46ef1e4 · 46ef1e4
1 parent c6d2e96
commit 46ef1e4
Show file tree

Hide file tree

Showing 8 changed files with 999 additions and 3 deletions.
diff --git a/notebooks/oggm-tuto/area_length_filter.ipynb b/notebooks/oggm-tuto/area_length_filter.ipynb
diff --git a/notebooks/oggm-tuto/deal_with_errors.ipynb b/notebooks/oggm-tuto/deal_with_errors.ipynb
diff --git a/notebooks/oggm-tuto/getting_started.ipynb b/notebooks/oggm-tuto/getting_started.ipynb
@@ -186,7 +186,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "gdirs = workflow.init_glacier_regions(rgi_ids, from_prepro_level=3, prepro_border=80)"
+    "gdirs = workflow.init_glacier_regions(rgi_ids, from_prepro_level=2, prepro_border=80)"
    ]
   },
   {
@@ -845,6 +845,7 @@
    "source": [
     "You have several options from here:\n",
     "- return to the [OGGM documentation](https://docs.oggm.org), in particular [how to set up an OGGM run](https://docs.oggm.org/en/latest/run.html)\n",
+    "- back to the [table of contents](welcome.ipynb).\n",
     "- explore other tutorials on the [OGGM-Edu](https://edu.oggm.org) platform."
    ]
   }

diff --git a/notebooks/oggm-tuto/inversion.ipynb b/notebooks/oggm-tuto/inversion.ipynb
diff --git a/notebooks/oggm-tuto/inversion_with_frontal_ablation.ipynb b/notebooks/oggm-tuto/inversion_with_frontal_ablation.ipynb
@@ -193,7 +193,7 @@
     "- the Oerlemans and Nick calving law is perfectly exact\n",
     "- the tuning parameter $k$ is known\n",
     "- our glacier is in equilibrium (a fundamental assumption for mass-conservation inversion)\n",
-    "- ice flow at the front follows Glen's flow law\n",
+    "- ice deformation at the glacier terminus follows Glen's flow law\n",
     "\n",
     "Under these assumptions, we are now going to show, that there is **one and only one** value for the frontal thickness which complies with *both* the calving law and the ice thickness inversion model of OGGM.\n",
     "\n",
@@ -427,7 +427,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If this happens during the iteration, OGGM is going to set $\\mu^*$ to zero and computes the corresponding flux (the maximal possible physical value). In this case, the calving law and OGGM disagree:"
+    "If this happens during the iteration, OGGM is going to set $\\mu^*$ to zero and computes the corresponding flux (the maximal physically possible value). In this case, the calving law and OGGM disagree:"
    ]
   },
   {

diff --git a/notebooks/oggm-tuto/preprocessing_errors.ipynb b/notebooks/oggm-tuto/preprocessing_errors.ipynb
diff --git a/notebooks/oggm-tuto/welcome.ipynb b/notebooks/oggm-tuto/welcome.ipynb
@@ -28,8 +28,19 @@
     "If you are ready to go:\n",
     "- [getting_started.ipynb](getting_started.ipynb) will get you through all the steps of an OGGM run\n",
     "- [working_with_rgi.ipynb](working_with_rgi.ipynb) will show you how to read glacier outline files\n",
+    "- [area_length_filter.ipynb](area_length_filter.ipynb): a short tutorial about how to filter spikes in the area and length outputs\n",
+    "- [deal_with_errors.ipynb](deal_with_errors.ipynb): dealing with errors after a run\n",
+    "- [preprocessing_errors.ipynb](preprocessing_errors.ipynb): error analysis of the global pre-processing workflow\n",
+    "- [inversion.ipynb](inversion.ipynb): run the OGGM ice thickness inversion model with various ice parameters\n",
     "- [inversion_with_frontal_ablation.ipynb](inversion_with_frontal_ablation.ipynb): a case study about ice thickness inversion with frontal ablation"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Have fun learning OGGM!"
+   ]
   }
  ],
  "metadata": {

diff --git a/notebooks/oggm-tuto/working_with_rgi.ipynb b/notebooks/oggm-tuto/working_with_rgi.ipynb
@@ -239,6 +239,30 @@
     "gdf_sel.plot(ax=ax, edgecolor='k');"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Select glaciers by their ID "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Each glacier in the RGI has a unique ID. It is sometimes difficult to find out which one, but some tools can help you out. For example, the [GLIMS viewer](https://www.glims.org/maps/glims) allows to select glaciers and then see their ID. For example, the Aletsch Glacier in the Swiss Alps:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "al = utils.get_rgi_glacier_entities(['RGI60-11.01450'])\n",
+    "al.plot();"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
@@ -291,6 +315,7 @@
   }
  ],
  "metadata": {
+  "hide_input": false,
   "kernelspec": {
    "display_name": "Python 3",
    "language": "python",
@@ -307,6 +332,19 @@
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
    "version": "3.5.2"
+  },
+  "toc": {
+   "base_numbering": 1,
+   "nav_menu": {},
+   "number_sections": false,
+   "sideBar": true,
+   "skip_h1_title": true,
+   "title_cell": "Table of Contents",
+   "title_sidebar": "Contents",
+   "toc_cell": false,
+   "toc_position": {},
+   "toc_section_display": true,
+   "toc_window_display": false
   }
  },
  "nbformat": 4,