Welcome to the 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 🚀).

Ready to go?

New! The 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… “elevation band” and “centerline” flowlines

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

Beginner tutorials:

• working_with_rgi will show you how to read glacier outline files and prepare them for a run

• store_and_compress_glacierdirs: storing glacier directories for later use

• plot_mass_balance: fetch and plot the simulated mass-balance as well as other diagnostics

• distribute_flowline: compute area and thickness changes from the flowline on a 2D grid (experimental!)

• deal_with_errors: dealing with errors after a run

• inversion: run the OGGM ice thickness inversion model with various ice parameters

• hydrological_output: hydrological mass-balance output

• oggm_shop: getting acquainted with what’s happening under the hood in OGGM GlacierDirectories, and how you can use the shop to add data to them

• full_prepro_workflow What’s in your preprocessed directories? A full OGGM workflow, step by step

Advanced tutorials:

• preprocessing_errors: error analysis of the global pre-processing workflow

• run_with_a_spinup_and_gcm_data: start from a glacier state different than the RGI inventory date

• dem_sources: create local topography maps from different DEM sources with OGGM

• use_your_own_inventory: use custom glacier inventories with OGGM

• centerlines_to_shape: compute the centerlines for a custom inventory and DEM and write them to disk

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

• where_are_the_flowlines: how to access the OGGM flowlines location before, during, and after a run.

• ingest_gridded_data_on_flowlines: ingest gridded products such as ice velocity into OGGM (and compare them with model output)

• merge_gcm_runs_and_visualize: how to merge different GCM runs into one dataset, analyse them on a regional scale and visualize with HoloViz

Related to OGGM:

• holoviz_intro: an introduction to the HoloViz vizualisation ecosystem (previously called PyViz)

• dem_comparison: compare the various DEMs available in OGGM

Tutorials in (re-)construction:

• dynamical_spinup: a deeper dive into the dynamical spinup for past simulations (to be repaired for v1.6)

• inversion_with_frontal_ablation: a case study about ice thickness inversion with frontal ablation

• kcalving_parameterization: the Oerlemans & Nick frontal ablation parameterization in OGGM

• merging_glaciers: a tutorial about how to merge two or more glaciers for advancing glacier scenarios

• area_length_filter: a short tutorial about how to filter spikes in the area and length outputs

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.10.11.final.0
    python-bits: 64
    OS: Linux
    OS-release: 5.15.0-1037-azure
    machine: x86_64
    processor: x86_64
## Packages info:
    oggm: 1.6.1.dev20+g01cba8b
    numpy: 1.24.3
    scipy: 1.10.1
    pandas: 2.0.1
    geopandas: 0.13.0
    netCDF4: 1.6.3
    matplotlib: 3.7.1
    rasterio: 1.3.6
    fiona: 1.9.3
    pyproj: 3.5.0
    shapely: 2.0.1
    xarray: 2023.4.2
    dask: 2023.4.1
    salem: 0.3.10.dev1+gfe1a230
    OGGM git identifier: fdf95a60ea2154340278f3198945ef5b73e37f20