Tuesday, February 19, 2019

Material for the GEOframe Winter School - Rainfall-Runoff

Here we are introducing some modules for rainfall runoff modelling present in GEOframe. Some of them where actually refined for the Civil Protection of the Basilicata Region.


  • The set of sim files and the Jupyter notebook are here
  • The Python script by Christian Massari to create automatically the required subfolders. It is here.
General references to Rainfall-Runoff

Beven, K. (2012), Ranfall Runoff, the primer, Wiley-Blackwell

Rigon, R., Bancheri, M., Formetta, G., & de Lavenne, A. (2015). The geomorphological unit hydrograph from a historical-critical perspective. Earth Surface Processes and Landforms, http://doi.org/10.1002/esp.3855

References besides the one already used

For seeing how to represent lumped hydrological models (you can give a look to this paper here)

Abera, W.W. (2016), Modelling water budget at a basin scale using JGrass-NewAge system. PhD thesis, University of Trento

Bancheri, Marialaura (2017) A flexible approach to the estimation of water budgets and its connection to the travel time theory. PhD thesis, University of Trento.

Formetta, Giuseppe (2013) Hydrological modelling with components: the OMS3 NewAge-JGrass system. PhD thesis, University of Trento.

Formetta, G., Antonello, A., Franceschi, S., David, O., & Rigon, R. (2014). Hydrological modelling with components: A GIS-based open source framework, 55(C), 190–200. http://doi.org/10.1016/j.envsoft.2014.01.019

Patta, C, Costruzione di un modello idrologico di stima della disponibilità idrica in area pedemontana, Tesi di laurea (in Italian), Politecnico di Torino, 2018

For open questions about rainfall-runoff see also the Meledrio Posts.

Material for the GEOframe Winter School - Evaporation and Transpiration

Evapotranspiration accounts for most of fifty percent of the terrestrial hydrological cycle. We illustrate here some ways to estimate it with the tools offered by the GEOframe system

Out of schedule (for Chhay)

Primarily for historic papers browse to the list by Dennis Baldocchi
See also the discussions here:

Material for the GEOframe Winter School - Radiation budget

After having spent time on preparatory topics, but before facing the hydrological processes, we need to cope with solar radiation. The topic was already treated in other posts. However not often in English.

Some very elementary slides about the sun:

Now some more complicate topics
Documentation of the components
Exercises illustrated by Jupyter notebooks by Michele Bottazzi

Corripio, J. G. (2002). Modelling the energy balance of high altitude glacierised basins in the Central Andes. Ph.D Dissertation, 1–175.

Corripio, J. G. (2003). Vectorial algebra algorithms for calculating terrain parameters from DEMs and solar radiation modelling in mountainous terrain, 17(1), 1–23.

Formetta, G., Rigon, R., Chávez, J. L., & David O. (2013). Modeling shortwave solar radiation using the JGrass-NewAge system. Geoscientific Model Development, 6(4), 915–928. http://doi.org/10.5194/gmd-6-915-2013

Formetta, G., Bancheri, M., David, O., & Rigon, R. (2016). Performance of site-specific parameterizations of longwave radiation. Hydrology and Earth System Sciences, 20(11), 4641–4654. http://doi.org/10.5194/hess-20-4641-2016

Material for the GEOframe Winter School - Kriging interpolation

Third and fourth days of the Winter School on the GEOframe system about GEOframe are dedicated to interpolation by using Kriging and the use of Particle Swarm Calibrator.


For general information about spatial interpolation of hydrological quantities, please see also "Rainfall and Temperature interpolation", on this blog

Material for the GEOframe Winter School - Catchments and Hydrologic Response Units delineation

The second day of the Winter School on GEOframe is dedicated to the watershed delineation and hillslope extraction. First the relevant concepts are given. Then GEOframe (Horton Machine) tools are used to get the desired results.
Requirements: if not already done, install numpy and rasterio with anaconda. These will be used to visualise the maps produced by the OMS Horton Machine tools.

Day 2 actual schedule ... We recovered something from the first day.

Work in progress

Material for the GEOframe Winter School - Getting Started with OMS and Jupyterlab

Day first of the Winter School on GEOframe was conceived to give people the taste of what OMS is and how to use it with Python lab. For the Installations, please refer to the Installation page
Not much information about Jupyterlab though. It will be given interactively using notebooks and explaining their contents.

Material for the Winter School on the GEOframe System - Installations

The Winter School on the GEOframe system is approaching.  In this webpost you will find all the preparatory material of the school indexed.


You are not assumed to know Python or Java to participate to the School. However programs runs on Java.. We will not do any Java programming though.  Input/Output of models will be treated by using some scripting in Python. We will communicate the appropriate notions during the classes. However, for the interested there are plenty of courses on the web (for instance this comes from SciPy 2018. Other from SciPy here.)
  • Java. GEOframe and OMS are written in Java and they require to have installed Java on your computer. Here you can find instructions to install Java on your computer.  OMS need Java 8 JDK.  Please note that you need the Java Development Toolkit (JDK) installed not the Java Runtime Environment (JRE).  The official Oracle's pages are here. You can watch several videos for Windows: here. Googling you can get videos for your platform.
  • We are going to use Docker for our modelling. Therefore you need to install it (here for Linuxes) on your computer. To quickly understand what Docker is, you can see here. Or read this tutorialThis video could be useful too. The knowledge of Docker required will be extremely elementary. You will not be required to do Docker applications. You simply use one and, at the end, is just matter of executing a command. 
  • During the School we will use Jupyter and Python 3 for data management and visualisation. It would be great if you could arrive
    • The post at this link contains all the information needed. For installation of the software, we suggest Anaconda. For any problem contact us through the mailing list. 
    • To understand what a Jupyter notebook is about, please see its manual. However, we will use Jupyterlab.  (You can see a YouTube video about here).  One can think that Jupyter was heavily based on the look-and-feel of Mathematica notebooks: but Jupyterlab is a step ahead to something different. Installing Anaconda, you also have already installed Jupyter notebook. So you have just to try it issuing the command: 
      • Jupyter notebook
  • You still do not know what to do with it, but we will lear step by step during the Winter School
  • Finally, at least for MacOs user, due to a bug either in the Docker or in GEOtools, it is necessary to use the OMS Console.  You can download the beta 3.5.62 release from here.
  • If you want to further with Jupiter and Jupiterlab, you can  install BeakerX. For its installation, please follow verbatim the instructions here. The instructions given at the main page of BeakerX are incomplete ;-).