GHydraulics integrates EPANET and QGIS

GHydraulics is a Quantum GIS plugin that allows to export water supply networks for analysis in EPANET. It also contains a function to calculate economic diameters based on given flowrates. The functions are accessible from the Quantum GIS plugin menu and toolbars.

GHydraulics Screenshot

Installation

You can use the Quantum GIS Plugin Repository to install GHydraulics.
Learn more on on the Quantum GIS Plugin Repository GHydraulics page.

Detailed step-by-step installation instructions for older QGIS versions are available.

Download

Starting with Quantum GIS 0.10.0 the GHydraulic plugin can be installed directly from Quantum GIS.

Sample data

Example data (a collection of shape files describing a simple hydraulic analysis model) is available in ZIP format: ghydraulics-samples.zip

It's recommended to use Darcy-Weisbach (D-W) and cubic meters per day (CMD) in the EPANET hydraulics options with this sample data.

Bugs and Problems

Please report all problems in the GHydraulics Bug Tracker.

Documentation

Blog

A series of GHydraulics-related blog posts explains how to use the software along with the current state of development.

Requirements

GHydraulics is a QGIS plugin and as such requires Quantum GIS (QGIS) in order to run. GHydraulics and QGIS are platform independent and run on Windows, Mac OS X and Linux.

Economic diameter calculation

The "Calculate economic diameters" function expects a RESULT_FLO field with the input. Output will be written to the DIAMETER field.

RESULT_FLO values are expected to be flow rates in l/s. The economic diameters are nominal diameters (DN) in mm.

The script will work for diameters from DN 80 to DN 1000.

A diameter of 9999 will be used to indicate where the RESULT_FLO flowrate exceeds the economic flowrate of DN 1000.

economicdiameter.py

If you want to use the commandline interface economicdiameter.py on Windows:

c:\Program Files\Quantum GIS\python needs to be in the PYTHONPATH:

set PYTHONPATH=%PYTHONPATH%;c:\Program Files\Quantum GIS\python

c:\Program Files\Quantum GIS needs to be in the PATH:

PATH=%PATH%;c:\Program Files\Quantum GIS

The script economicdiameter.py will fill the DIAMETER field with the economic diameter according to the RESULT_FLO field value.

Roadmap

At some point in the future, GHydraulics should fully integrate the EPANET engine into Quantum GIS. The DC Water Design Extension provides similar EPANET integration for ArcView GIS 3.*

Open Source

GHydraulics is open source software, written in the Python programming language. If you're a software developer, you may want to check out the GHydraulics Git Repository on Sourceforge:

sourceforge.net/p/ghydraulic/code-0/

License

The software is available for free (open source) under the terms of the GPL.

History

June 13, 2012: GHydraulics 2.06 writes all network elements, fixes bugs and provides an updated package.

January 20, 2012: GHydraulics 2.0.4 allows to write EPANET INP files with junctions from QGIS.

April 11, 2010: GHydraulics 2.0.2 fixes problems with QT versions > 3.

January 29, 2009: GHydraulics 2.0.1 adds support for the Quantum GIS 1.0 API.

GHydraulic 0.x

GHydraulic 0.x is a simple hydraulic analysis engine that has become obsolete with the availability of EPANET.