OGGM tutorials

If you are new to jupyter notebooks or to jupyterlab, we recommend to have a look at our introduction to jupyter notebooks first!

If you are reading this from our webpage (https://oggm.org/tutorials), remember that each page displayed here is in fact a jupyter notebook! You can start an interactive version of these tutorials online with MyBinder by clicking on the “launch button” on the top right of this page (the little rocket 🚀).

⚠️ You can access various versions of these tutorials ont the web:

• Stable (the default): the version of the tutorials working with the latest official release of OGGM

• Development version: the version of the tutorials working with the most up-to-date version of OGGM on github (unreleased)

• v1.5.3 (2022): legacy tutorials for the OGGM versions predating v1.6 and the mass-balance calibration overhaul.

Note that you can download the notebooks for any of these versions on github by selecting a given branch: stable, master, v1.5.3. Be aware of which versions you are using!

Ready to go?

10 minutes tutorials

These new tutorials are designed to illustrate one single OGGM concept at a time. They are a good way to get started with OGGM, or for returning users to learn about new features!

• 10 minutes to… a preprocessed directory (start with this tutorial if you are new to OGGM)

• 10 minutes to… a glacier change projection with GCM data

• 10 minutes to… OGGM as an accelerator for modelling and machine learning

• 10 minutes to… the new dynamical spinup in OGGM v1.6

OGGM workflow

• Working with the RGI files and prepare glaciers for a run

• Storing glacier directories for later use

• Dealing with errors after a run

• Differences between the “elevation band” and “centerline” flowlines

• Step-by-Step guide to building preprocessed directories from scratch

• What’s in my preprocessed directories? A full centerlines workflow, step by step

Mass balance

• Plotting the OGGM surface mass-balance, the ELA and AAR

• A look into the new mass balance calibration in OGGM v1.6

• Global distribution of the mass-balance model parameters

• Mass balance parameter perturbation experiments with OGGM

Hydrological output

• Hydrological mass-balance output

Dynamical runs

• Run with a long spinup and GCM data

• Dynamic spinup and dynamic melt_f calibration for past simulations

• Understand the difference between the ice dynamic solvers in OGGM

• “Instructed OGGM”: running IGM within the OGGM workflow

Ice thickness

• Ice thickness inversion

• Dynamic model initialization using observed thickness data

Calving

• The Oerlemans & Nick frontal ablation parameterization in OGGM

OGGM shop and additional data

• OGGM-Shop and Glacier Directories in OGGM

• Using your our own glacier inventory with OGGM

• Ingest gridded products such as ice velocity into OGGM

• Create local topography maps from different DEM sources with OGGM

• Compare different DEMs for individual glaciers: RGI-TOPO for RGI v6.0

• RGI-TOPO for RGI 7.0

Visualisation and post-processing

• Display glacier area and thickness changes on a grid

• OGGM flowlines: where are they?

• Compute smoother centerlines for shapefile output

• Error analysis of the global pre-processing workflow

• Merge, analyse and visualize OGGM GCM runs

• Small overview of HoloViz capability of data exploration

Tutorials in (re-)construction

• Ice thickness inversion with frontal ablation

• Filter the glacier length and area time series

Have fun learning OGGM!

Package versions used to build this documentation:

# Package versions
from oggm.utils import show_versions
print(show_versions())

# OGGM environment: 
## System info:
    python: 3.11.11.final.0
    python-bits: 64
    OS: Linux
    OS-release: 6.8.0-1021-azure
    machine: x86_64
    processor: x86_64
## Packages info:
    oggm: 1.6.3.dev10+g24a25ac
    numpy: 2.1.3
    scipy: 1.15.1
    pandas: 2.2.3
    geopandas: 1.0.1
    netCDF4: 1.7.2
    matplotlib: 3.10.0
    rasterio: 1.4.3
    fiona: 1.10.1
    pyproj: 3.7.0
    shapely: 2.0.7
    xarray: 2025.1.2
    dask: 2025.1.0
    salem: 0.3.12.dev8+g84d7f7e
    OGGM git identifier: 10faeba31d63cfc88e4bacc98aae2c66d20cead8