Skip Links

USGS - science for a changing world

Open-File Report 2014-1073

Laharz_py: GIS Tools for Automated Mapping of Lahar Inundation Hazard Zones

By Steve P. Schilling


Laharz_py is written in the Python programming language as a suite of tools for use in ArcMap Geographic Information System (GIS). Primarily, Laharz_py is a computational model that uses statistical descriptions of areas inundated by past mass-flow events to forecast areas likely to be inundated by hypothetical future events. The forecasts use physically motivated and statistically calibrated power-law equations that each has a form A = cV2/3, relating mass-flow volume (V) to planimetric or cross-sectional areas (A) inundated by an average flow as it descends a given drainage. Calibration of the equations utilizes logarithmic transformation and linear regression to determine the best-fit values of c. The software uses values of V, an algorithm for idenitifying mass-flow source locations, and digital elevation models of topography to portray forecast hazard zones for lahars, debris flows, or rock avalanches on maps. Laharz_py offers two methods to construct areas of potential inundation for lahars: (1) Selection of a range of plausible V values results in a set of nested hazard zones showing areas likely to be inundated by a range of hypothetical flows; and (2) The user selects a single volume and a confidence interval for the prediction. In either case, Laharz_py calculates the mean expected A and B value from each user-selected value of V. However, for the second case, a single value of V yields two additional results representing the upper and lower values of the confidence interval of prediction. Calculation of these two bounding predictions require the statistically calibrated prediction equations, a user-specified level of confidence, and t-distribution statistics to calculate the standard error of regression, standard error of the mean, and standard error of prediction. The portrayal of results from these two methods on maps compares the range of inundation areas due to prediction uncertainties with uncertainties in selection of V values. The Open-File Report document contains an explanation of how to install and use the software. The Laharz_py software includes an example data set for Mount Rainier, Washington. The second part of the documentation describes how to use all of the Laharz_py tools in an example dataset at Mount Rainier, Washington.

First posted April 8, 2014

For additional information, contact:
Contact Information, Volcano Science Center
Cascades Volanco Observatory
U.S. Geological Survey
1300 SE Cardinal Court
Vancouver, WA 98683-9589

Part or all of this report is presented in Portable Document Format (PDF). For best results viewing and printing PDF documents, it is recommended that you download the documents to your computer and open them with Adobe Reader. PDF documents opened from your browser may not display or print as intended. Download the latest version of Adobe Reader, free of charge.

Suggested citation:

Schilling, S.P., 2014, Laharz_py—GIS tools for automated mapping of lahar inundation hazard zones: U.S. Geological Survey Open-File Report 2014-1073, 78 p.,

ISSN 2331-1258 (online)



Laharz Overview

Digital Topography

Proximal Hazard Zone Boundary

Laharz Algorithms


Example Using Laharz_py


References Cited

Appendix A. Strategy for Computing and Portraying Confidence Limits in Inundation Predictions Using Laharz (R.M. Iverson, written commun., October 2007)

Appendix B. Code

Accessibility FOIA Privacy Policies and Notices

Take Pride in America logo logo U.S. Department of the Interior | U.S. Geological Survey
Page Contact Information: GS Pubs Web Contact
Page Last Modified: Wednesday, 07-Dec-2016 19:35:20 EST