Getting Started with GEOtop: A Short Course at EGU 2026
GEOtop short course. © 2026 John Mohd WaniMountains store water as snow. Understanding when and how much of that snow melts is critical for millions of people downstream for drinking water, irrigation, hydropower, and flood forecasting. Yet modelling snow in complex terrain remains one of the hardest problems in hydrology.
This May, at the EGU General Assembly 2026 in Vienna, we are offering a hands-on short course to help researchers and students get started with two powerful open-source tools for snow-dominated catchments: GEOtop and GEOframe.
What is the Course About?
Session: SC2.20 — Introducing GEOtop and GEOframe
When: Friday, 8 May 2026, 16:15–18:00 CEST
Where: Room -2.62, Austria Center Vienna
Conveners: John Mohd Wani, Giacomo Bertoldi, Marialaura Bancheri, Matteo Dall’Amico, Giuseppe Formetta
The course is designed for researchers, PhD students, and practitioners who want to start using physically-based hydrological models but find the setup and compilation process daunting. We walk you through everything from installation to interpreting your first simulation results.
What You Will Learn
The GEOtop part covers:
What is GEOtop?: A physically-based model that couples energy and water balance at and below the land surface, including a multilayer snow scheme, soil freezing, and terrain effects.
Installation on any OS: Step-by-step instructions for Linux, macOS, and Windows (via WSL). We tested every command live on Ubuntu 24.04 with GCC 13.3 and CMake 3.28.
Running your first simulation: Understanding the directory structure, the
geotop.inptsconfiguration file, meteorological forcing format, and output files.Hands-on output analysis: A Jupyter notebook that reads GEOtop output and produces publication-quality plots of snow depth, SWE, energy balance, precipitation partitioning, snow density evolution, and more.
Why GEOtop?
GEOtop solves the full surface energy balance. It doesn’t use a simple degree-day approach. This means it can capture processes that simpler models miss: radiation effects in complex terrain, the thermal state of the snowpack (cold content vs. isothermal ripening), and the coupled dynamics of soil freezing and thawing.
It’s not the easiest model to set up and that’s precisely why this course exists. Our goal is to lower the entry barrier so that more researchers in the snow and permafrost community can benefit from physically-based modelling.
How to Prepare
To make the most of the hands-on session, please come with:
- A laptop with git, CMake (or Meson), and a C++ compiler installed
- Windows users: install WSL2 with Ubuntu beforehand
- A conda environment for the Jupyter notebook:
conda create -n geotop_course python=3.11 pandas matplotlib numpy jupyterlab -c conda-forge -y
Don’t worry if you can’t compile before the session, we’ll walk through it together.
Course Material
All materials are open-access under a CC BY 4.0 license:
| Material | Description | Link |
|---|---|---|
| Presentation slides | Installation, model overview, configuration | [Coming soon — will be uploaded after the course] |
| Jupyter notebook | Output analysis with 14 scientific plots | [Coming soon] |
| Conda environment | environment.yml for Python setup | [Coming soon] |
A Taste of What GEOtop Can Do
GEOtop has been used to simulate snow dynamics across the European Alps. Here’s an example from the Non Valley (Val di Non) catchment in Trentino, Italy, one of our operational setups showing simulated snow depth across the catchment in winter versus late spring:

© 2025 John Mohd Wani. All rights reserved.
The model captures the strong elevation dependence of snow accumulation and the progressive melt-out from valley floors to high-altitude ridgelines.
Related Resources
- GEOtop source code: github.com/geotopmodel/geotop
- GEOtop user manual: geotopmodel.github.io
- GEOtoPy (Python wrapper): github.com/stefanocampanella/GEOtoPy
- geotopbricks (R package): CRAN
Key references:
- Endrizzi, S., Gruber, S., Dall’Amico, M., Rigon, R. (2014). GEOtop 2.0: simulating the combined energy and water balance at and below the land surface. Geosci. Model Dev., 7, 2831–2857. DOI
- Rigon, R., Bertoldi, G., Over, T.M. (2006). GEOtop: A Distributed Hydrological Model with coupled water and energy budgets. J. Hydrometeorol., 7, 371–388. DOI
See you in Vienna!
If you have questions about the course, feel free to get in touch.