pghydro

Drainage network analysis core for PostgreSQL and PostGIS

Overview

PackageVersionCategoryLicenseLanguage
pghydro6.6GISGPL-2.0SQL
IDExtensionBinLibLoadCreateTrustRelocSchema
1600pghydroNoNoNoYesNoNopghydro
1601pgh_rasterNoNoNoYesNoNopgh_raster
1602pgh_hgmNoNoNoYesNoNopgh_hgm
1603pgh_outputNoNoNoYesNoNopgh_output
1604pgh_output_en_auNoNoNoYesNoNopgh_output_en_au
1605pgh_output_pt_brNoNoNoYesNoNopgh_output_pt_br
1606pgh_consistencyNoNoNoYesNoNopgh_consistency
Relatedplpgsql postgis

Lead row; package also ships pgh_raster, pgh_hgm, pgh_output, pgh_output_en_au, pgh_output_pt_br, and pgh_consistency.

Version

TypeRepoVersionPG VerPackageDeps
EXTPIGSTY6.61817161514pghydroplpgsql, postgis
RPMPIGSTY6.61817161514pghydro_$vpostgis36_$v
DEBPIGSTY6.61817161514postgresql-$v-pghydropostgresql-$v-postgis-3
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
d13.x86_64
d13.aarch64
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
u22.x86_64
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
u22.aarch64
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
u24.x86_64
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
u24.aarch64
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6
PIGSTY 6.6

Build

You can build the RPM / DEB packages for pghydro using pig build:

pig build pkg pghydro         # build RPM / DEB packages

Install

You can install pghydro directly. First, make sure the PGDG and PIGSTY repositories are added and enabled:

pig repo add pgsql -u          # Add repo and update cache

Install the extension using pig or apt/yum/dnf:

pig install pghydro;          # Install for current active PG version
pig ext install -y pghydro -v 18  # PG 18
pig ext install -y pghydro -v 17  # PG 17
pig ext install -y pghydro -v 16  # PG 16
pig ext install -y pghydro -v 15  # PG 15
pig ext install -y pghydro -v 14  # PG 14
dnf install -y pghydro_18       # PG 18
dnf install -y pghydro_17       # PG 17
dnf install -y pghydro_16       # PG 16
dnf install -y pghydro_15       # PG 15
dnf install -y pghydro_14       # PG 14
apt install -y postgresql-18-pghydro   # PG 18
apt install -y postgresql-17-pghydro   # PG 17
apt install -y postgresql-16-pghydro   # PG 16
apt install -y postgresql-15-pghydro   # PG 15
apt install -y postgresql-14-pghydro   # PG 14

Create Extension:

CREATE EXTENSION pghydro CASCADE;  -- requires: plpgsql, postgis

Usage

Sources: GitHub repo, README, releases Lead extension for the PgHydro suite.

PgHydro extends PostGIS and PostgreSQL for drainage network analysis and water-resources decision making. The project covers river network modeling, flow-direction analysis, Otto Pfafstetter basin coding, upstream and downstream stretch selection, distance-to-mouth calculations, upstream area analysis, river orders, and basin levels.

CREATE EXTENSION postgis;
CREATE EXTENSION postgis_raster;
CREATE EXTENSION pghydro;
CREATE EXTENSION pgh_raster;
CREATE EXTENSION pgh_hgm;
CREATE EXTENSION pgh_consistency;
CREATE EXTENSION pgh_output;

Components

  • pghydro is the core drainage-network analysis extension.
  • pgh_raster uses hydrological products derived from a digital elevation model.
  • pgh_hgm combines pghydro and pgh_raster for hydrogeomorphological analysis.
  • pgh_output provides reporting objects.
  • pgh_consistency adds Pfafstetter consistency checks.

Requirements

  • PostgreSQL 9.1 or newer.
  • PostGIS 3.x.
  • PostGIS Raster.

Notes

  • The README says the master branch tracks the latest minor release, 6.6.
  • The CSV lead row is the core pghydro package, but the repository also ships companion extensions in the same release tree.

Last Modified 2026-04-14: update extension catalog (29617e5)