pgh_hgm

概览

Extension version is 2.2.6, shipped inside pghydro package version 6.6.

版本

构建

您可以使用 pig build 命令构建 pghydro 扩展的 RPM / DEB 包：

pig build pkg pghydro         # 构建 RPM / DEB 包

安装

您可以直接安装 pghydro 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

• 安装
• pig
• dnf
• apt

pig install pghydro;          # 当前活跃 PG 版本安装

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 pgh_hgm CASCADE;  -- 依赖: plpgsql, postgis, postgis_raster, pghydro, pgh_raster

用法

来源：PGHydro README，pgh_hgm SQL

pgh_hgm 为 PgHydro 增加水文地貌分析函数。它结合排水线、排水区、DEM 以及派生栅格产品，计算水资源分析中常用的流域和河网指标。

启用

在核心 PgHydro 和栅格扩展之后安装：

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

初始化对象

扩展创建 pgh_hgm schema，其中包括 pghft_drn_elevationprofile、pghft_upn_elevationprofile、pghft_hydro_intel 等表。

SELECT pgh_hgm.pghfn_tables_initialize();

指标

SQL 对象包括高程剖面、排水区高程摘要、坡面流平均长度、轴长、圆形度、紧凑度、排水密度、高程统计、形状因子、水文密度、Kirpich 时间、周长、河段坡降、相对起伏、汇流时间、坡度方法、弯曲度、波速传播，以及 AMHG 深度/宽度估计等函数。

SELECT nspname, proname
FROM pg_proc p
JOIN pg_namespace n ON n.oid = p.pronamespace
WHERE nspname = 'pgh_hgm'
ORDER BY proname;

注意事项

运行指标计算前，需要先加载并校验 DEM、flow direction、flow accumulation 以及 PgHydro 排水图层。pgh_hgm 依赖 pgh_raster 提供栅格派生水文产品。