Accessing National Data and Distributed Models for Catchment Simulation

CLINIC DATE: May 26, 2015

LOCATION: Boulder, Colorado, USA

CLINIC LEADS: Chris Duffy, Gopal Bhatt, Lorne Leonard

TECHNICAL CONTACTS: Gopal Bhatt (gopal.bhatt @, Xuan Yu (xuan @, Lorne Leonard (lnl3 @, Yu Zhang (yzz130 @, Lele Shu (lzs157 @, Yuning Shi (yzs123 @


 The objective of the clinic is: (1) to introduce the concept of essential terrestrial variables (ETVs) and HydroTerre [1] as a continental scale ETV-repository for catchment modeling, and (2) to demonstrate the use of ETV's with the Penn State Integrated Hydrologic Model (PIHM) for simulating the catchment water cycle. PIHM [2] is a multi-process, multi-scale hydrologic model where the hydrologic processes are fully coupled using the semi-discrete finite volume method. PIHMgis [3] is an open source, platform independent, and extensible distributed modeling framework for setup, execute, and analyze model simulations. Through the procedural framework of PIHMgis, participants will be introduced to multiple data processing tools, and presented with a live demonstration of (i) accessing HydroTerre ETV service, (ii) ETV geodata translator for PIHM, (iii) automated ingestion of model parameters from national geospatial databases, (iv) conditional domain decomposition of the watershed into quality triangular mesh elements for numerical simulation, (v) performing multi-state distributed hydrologic model simulations on desktop, and (vi) visualization of model results as time-series plots and geo-spatial maps. In the clinic, an application is developed for a small-scale hillslope catchment Susquehanna-Shalehills Critical Zone Observatory (SSHCZO), which serves as a guided example of the desktop workflow, which is readily used to develop your own catchment simulation.




> Presentation Document

> CSDMS Clinics


1. Download and Install PIHMgis software

  PIHMgis is available for download at the following link. There will you find options to select appropriate version of PIHMgis based on the operating system that you are running on your computer.

PIHMgis Download Webpage

Version 2.3 - Installation Guide (Macintosh/Windows)

Version 3.0 - Install Guide (follow information on download page)

2. Download Input Data

  Here is the link to download input geo-spatial datasets that we will be using to develop a prototype catchment simulation using PIHMgis. Please have the dataset specific to software version you installed downloaded on your laptop at an easily identifiable and accessible folder e.g., “PIHMWorkshop” in your users home directory.

Susquehanna - ShaleHills Critical Zone Observatory:  SSHCZO for VERSION 2.3     SSHCZO for VERSION 3.0

3. Tutorial and Documents

PIHMgis tutorial: V-Catchment Tutorial

PIHM input data format: PIHM v2.x Input File Formats

PIHM output data format: PIHM v2.x Output File Formats

Introduction of downloading data from HydroTerre and conversion tool format Download

HydroTerre Data Conversion Tool format: Download