MATILDA-Online: Workflow for Modeling Water Resources in Glacierized Catchments

Binder DOI

Welcome to MATILDA-Online, the online companion to the MATILDA glacio-hydrological modeling framework. Designed in form of a Jupyter Book for researchers, practitioners, and students, this workflow guides users from data acquisition to the analysis of climate change impacts on glacierized catchments.

πŸ“š Explore the Jupyter Book on the MATILDA-Online Website.

Installation

Note: You are now viewing the documentation of the legacy branch v1.x which is designed to use MATILDA-Online with your own Google Cloud Project. If want to use the web-service version instead, switch to the latest version or follow the links on the MATILDA-Online Website.

You can run most of the workflow in an online environment hosted on mybinder.org. However, model calibration is computationally intensive and can be slow in Binder because only limited computing resources are available. For more comprehensive calibration runs, we recommend downloading the notebooks and running them locally on a machine with multiple CPU cores.

MATILDA-Online is designed to be run in JupyterLab.

1. Install the required tools

Before you begin, make sure the following are installed on your computer:

2. Clone the repository

Open a terminal.

  • On macOS / Linux, use your default terminal.

  • On Windows, use Anaconda Prompt (recommended), PowerShell, or Git Bash.

Then run:

git clone --branch release-1.x --single-branch https://github.com/phiscu/matilda_online.git
cd matilda_online

3. Create the Python environment

Create a new conda environment from the provided environment.yml file:

conda env create -f binder/environment.yml -n matilda_online

This may take a few minutes the first time.

4. Activate the environment

Activate the new environment:

conda activate matilda_online

If conda activate does not work in Windows PowerShell, open Anaconda Prompt and run the same command there.

5. Install JupyterLab

If JupyterLab is not already included in your environment, install it with:

conda install -c conda-forge jupyterlab

6. Launch MATILDA-Online in JupyterLab

From the root folder of the repository, start JupyterLab:

jupyter lab Notebook0_Introduction.ipynb

JupyterLab should open automatically in your browser. If it does not, copy the local URL shown in the terminal and paste it into your browser.

7. Open the notebooks

In JupyterLab, navigate to the cloned matilda_online folder and open the notebooks in order, starting with the introduction notebook.

Notes for Windows users

  • We recommend using Anaconda Prompt if you are unfamiliar with the command line.

  • If git is not recognized, make sure Git is installed and available in your system PATH.

  • If jupyter lab is not recognized, check that your conda environment is activated before launching it.

Updating the environment

If the environment.yml file changes in a future version of the repository, update the environment with:

conda env update -f environment.yml -n matilda_online --prune

Workflow Overview

The MATILDA-Online workflow is organized into a series of interactive Jupyter notebooks. These cover all key steps of modeling water resources in glacierized catchments, including catchment delineation, data acquisition, model calibration, and scenario analysis. Below is a detailed flowchart of the workflow:

Workflow Flowchart

Core Routines

The core routines of MATILDA, including the temperature-index melt model and HBV hydrological model, are maintained in the MATILDA repository. The MATILDA-Online workflow integrates these routines into a streamlined educational framework.

Authors

License

This project is licensed under the MIT License. See the LICENSE file for details.

git clone –branch gee-webservice –single-branch https://github.com/phiscu/matilda_edu.git