Catchment Geometry Indicators#

Note

This page and its static assets are auto-generated by python -m tools.doc_gallery. The Sphinx build only reads committed PNG and JSON artifacts.

This case focuses on geometry metrics that do not require meshing: elevation distribution, slope statistics, and a hypsometric curve computed on the masked DEM.

Geometry indicators based on DEM and catchment mask
Hypsometric curve and slope diagnostics for the Canut mask.

Case Setup#

  • Regional DEM masked by the Canut boundary.

  • Slope estimated from DEM gradients.

  • Hypsometric curve derived from masked elevations.

What It Shows#

  • How elevation is distributed inside the catchment boundary.

  • How slope metrics provide a geometry-only proxy for terrain complexity.

  • A compact hypsometric curve suitable for documentation pages.

Key Metrics#

  • Boundary area: 24.9 km2

  • Mean slope: nan deg

  • Slope p90: nan deg

  • DEM range: 52 m

Reproduce#

Run the underlying example or validation case with:

python -m tools.doc_gallery

Refresh the committed gallery artifacts with:

python -m tools.doc_gallery

Case Parameters#

Geometry Inputs#

Field

Meaning

Value

Source

geometry_case_kind

Geometry-focused rendering mode used to build this gallery page.

hypsometry_indicators

docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json

boundary_path

Boundary polygon used to clip and frame the catchment domain.

canut.shp

examples/data/masks/canut.shp

dem_path

DEM raster used for regional relief and slope context.

regional_dem_naizin.tif

examples/data/dem/regional_dem_naizin.tif

Derived Geometry Values#

Field

Meaning

Value

Source

boundary_area_km2

Catchment area represented on the geometry page.

24.9187 km2

docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json

river_length_km

Total clipped river length visible inside the boundary.

0 km

docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json

geology_unit_count

Number of distinct geology units intersecting the catchment.

0

docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json

dem_min_m

Minimum DEM elevation represented by the rendered extent.

86.7 m

docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json

dem_max_m

Maximum DEM elevation represented by the rendered extent.

138.7 m

docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json

Source Pointers#

  • examples/data/masks/canut.shp

  • examples/data/dem/regional_dem_naizin.tif

  • tools/doc_gallery/update_gallery.py

Artifacts#

  • docs/source/_static/capability_gallery/geometry/geometry_indicators_canut.png

  • docs/source/_static/capability_gallery/geometry/geometry_indicators_canut_summary.json stores the displayed metrics plus source hashes used by python -m tools.doc_gallery --check.