Catchment Topography Context#

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 adds relief and slope context to the same geometry stack using the regional DEM. It stays mesh-free while providing visual context for elevation and terrain gradients.

Catchment topography context map
Regional DEM with catchment boundary and river network overlays.

Case Setup#

  • Regional DEM background (Naizin).

  • Catchment boundary clipped to the same extent.

  • Mesh-free visualization to document geometry inputs.

What It Shows#

  • Where the catchment sits on the DEM relief.

  • How slope patterns complement elevation context.

  • What elevation range is covered by the selected mask.

Key Metrics#

  • Boundary area: 24.9 km2

  • River length: 0.0 km

  • DEM min: 87 m

  • DEM max: 139 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.

topography_context

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

boundary_path

Boundary polygon used to clip and frame the catchment domain.

canut.shp

examples/data/masks/canut.shp

rivers_path

Hydrographic layer overlaid inside the catchment boundary.

regional_stream_network.shp

examples/data/hydrography/regional_stream_network.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_topography_canut_summary.json

river_length_km

Total clipped river length visible inside the boundary.

0 km

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

geology_unit_count

Number of distinct geology units intersecting the catchment.

0

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

dem_min_m

Minimum DEM elevation represented by the rendered extent.

86.7 m

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

dem_max_m

Maximum DEM elevation represented by the rendered extent.

138.7 m

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

Source Pointers#

  • examples/data/masks/canut.shp

  • examples/data/hydrography/regional_stream_network.shp

  • examples/data/dem/regional_dem_naizin.tif

  • tools/doc_gallery/update_gallery.py

Artifacts#

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

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