Catchment Geometry Constraints#

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 only: a catchment mask, the clipped river network, geology units inside the boundary, and a regional DEM backdrop. It documents the inputs that drive meshing and solver setup before any discretization happens.

Catchment geometry constraints map
Boundary, hydro network, and geology units clipped to the same domain.

Case Setup#

  • Domain mask sourced from the shipped canut polygon.

  • Hydrography and geology layers clipped to the same boundary.

  • Regional DEM added for context; no mesh data used.

What It Shows#

  • How the river network, geology units, and boundary align on the same domain.

  • How geometry layers are clipped and contextualized before any mesh is generated.

  • Where the catchment sits relative to the regional DEM backdrop.

Key Metrics#

  • Boundary area: 24.9 km2

  • River length: 0.0 km

  • Geology units: 0

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.

constraints_overview

docs/source/_static/capability_gallery/geometry/geometry_constraints_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

geology_path

Geology layer clipped to the same boundary when available.

GEO1M_brittany.shp

examples/data/geology/GEO1M_brittany.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_constraints_canut_summary.json

river_length_km

Total clipped river length visible inside the boundary.

0 km

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

geology_unit_count

Number of distinct geology units intersecting the catchment.

0

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

Source Pointers#

  • examples/data/masks/canut.shp

  • examples/data/hydrography/regional_stream_network.shp

  • examples/data/geology/GEO1M_brittany.shp

  • tools/doc_gallery/update_gallery.py

Artifacts#

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

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