Open-source software for simulating hillslope hydrology and stability

This is the material of the SC34/NH10.2 ECS: Open-source software for simulating hillslope hydrology and stability
by Giuseppe Formetta, Francesco Serafin, Riccardo Rigon, Raffaele Albano and Luigi Lombardo (co-conveners)

session of the  2017 EGU meeting in Wien.

For all of this work it is necessary to download a number of softwares.

• Docker GEOtop,
• Preliminari to any operation is to install GEOtop 2.0  on your machine. To avoid the complication implied by different platform GEOtop has been compiled against Docker which is a lightweight, well supported mini virtual machine which run on most operating systems.  The instructions on how to do it are available directly at: https://github.com/geotopmodel/docker (scroll down a little the page to see the instructions). Installing Docker is time consuming so, it is essential that participants to the pico session will download it before the session. An alternative little guide is on GrowWorkingHard.  Other information about the dockerized version of GEOtop can be found here.
• References: 
• Rigon, R., Bertoldi, G., & Over, T. M. (2006). GEOtop: A Distributed Hydrological Model with Coupled Water and Energy Budgets. Journal of Hydrometeorology, 7, 371–388.
• Endrizzi S., Gruber S., Dall’Amico M., Rigon R., GEOtop 2.0.: Simulating the combined energy and water balance at and below the land surface accounting for soil freezing, snow cover and terrain effects, Geosci. Model Dev., 2014
• Other GEOtop information can be found in the GEOtop essential post
• Next stuff require you to have installed the Java JDK (from Oracle site)
• Console OMS3, 
• OMS3 is a framework to build environmental models. It is Java native but it supports also the inclusion of C/C++ and FORTRAN codes. In our case, GEOtop is a C++ code and the hillslope stability code is a Java one. 
• First operation required in this case is the installation of OMS3 console. Its installation page is here.
• Further readings:
• David, O., Ascough II, J.C., Lloyd, W., Green, T.R., Rojas, K.W., Leavesley, G.H., Ahuja, L.R., 2013. A software engineering perspective on environmental modeling framework design: the Object Modeling System. Environ. Model. Softw. 39, 201e213
• 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

• Hillslope Stability jars and data
• To download the .sim files to be used with OMS please go to https://zenodo.org/record/569354. Alternatively, the same material can be found here and here.
• This Stability analysis is novel unpublished material. So if you use it, the Author kindly ask to cite:
• Formetta G., S. Simoni, J. W. Godt, N. Lu, and R. Rigon (2016), Geomorphological control on variably saturated hillslope hydrology and slope instability, Water Resour. Res., 52, 4590?4607, doi:10.1002/2015WR017626.
• Further Readings
• Lu, N., & Likos, W. J. (2006). Suction Stress Characteristic Curve for Unsaturated Soil. Journal of Geotechnical and Geoenvironmental Engineering, 32, 131–142. 
• Lu, N., & Godt, J. (2008). Infinite slope stability under steady unsaturated seepage conditions. Water Resources Research, 44(11), 148–13. http://doi.org/10.1029/2008WR006976 
• Lu, N. & Godt, J.W., Hillslope Hydrology and Stability, Cambridge University Press, 2013, https://doi.org/10.1017/CBO9781139108164
• Running all of the examples
• At present here you have to types of runs:
• First you execute from the system console the command: 
  docker run --rm -v $(pwd):/work omslab/geotop 
Before launching it, please pay attention to have changed your directory that contains the initialisation files (geotop.inpts and io.ini), and then issue the command. (In the present case, you have to go in the "concave" directory that contains all these files and the input data file appropriately positioned)
• Secondly, please starts the OMS console, usually executing the "console" .sh or .bat files. Once in the console, you should upload the appropriate OMS project (OMS.landslide.prj) and you can execute Giuseppe's code for hillslope stability. It runs reading the outputs of GEOtop and does its job.