Geology-Driven Conductivity Transfer#

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 reuses the Brittany geology subset shipped with the repository and the generic geology-to-field pipeline. A compact figure shows geology zones, the value table keyed by zone, and the mapped conductivity field.

Geology-driven conductivity transfer on the Brittany subset
Geology zones, zone-value mapping, and resulting conductivity field on a local mesh.

Case Setup#

  • Local Brittany window extracted from the committed GEO1M subset.

  • Heterogeneous K values loaded from a versioned CSV keyed by geology codes.

  • Property transfer computed on a compact structured mesh for documentation stability.

What It Shows#

  • How one CSV keyed by geology codes turns into a mesh-ready K field.

  • How HydroModPy keeps the zone legend and the mapped property view aligned on the same local window.

  • What a deterministic geology-driven property transfer looks like on versioned demo data.

Key Metrics#

  • Polygons: 23

  • Unique zones: 13

  • Mesh cells: 400

  • Maximum K: 7.21e-05 m/s

Reproduce#

Refresh the committed gallery artifacts with:

python -m tools.doc_gallery

Case Parameters#

Selected Parameters#

Field

Meaning

Value

Source

property_case_kind

Hydraulic-property rendering mode used to build this gallery figure.

geology_transfer_demo

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

parameter_ids

Hydraulic parameters illustrated by the case.

K

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

parameterization_modes

Parameterization modes intentionally demonstrated by the case.

csv, heterogeneous

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

supports

Spatial supports used to render the field or compare variants.

vector_local, structured

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

Configuration Values#

Field

Meaning

Value

Source

[field] id

Identifier used by FieldParam for the illustrated hydraulic property.

K

hydromodpy/data/variables/geology/cases/gallery_field_param_brittany.toml

[field] kind

Homogeneous or heterogeneous assignment mode used by the field parameter.

heterogeneous

hydromodpy/data/variables/geology/cases/gallery_field_param_brittany.toml

[field] values_source

How heterogeneous values are supplied to the field parameter.

csv

hydromodpy/data/variables/geology/cases/gallery_field_param_brittany.toml

[field] values_csv_file

CSV file used to map zone keys to property values when the case is CSV-driven.

geology_K_dummy_demo.csv

../../../../../examples/data/geology/geology_K_dummy_demo.csv

[field_vertical_profile] mode

Vertical-profile mode applied to the field when depth dependence is active.

none

hydromodpy/data/variables/geology/cases/gallery_field_param_brittany.toml

[geology] id

Identifier of the geology field used to spatialize the property mapping.

field_geology

hydromodpy/data/variables/geology/cases/gallery_geology_config_brittany.toml

[geology] cell_samples_per_axis

Sampling density used when rasterizing geology polygons onto the support.

6

hydromodpy/data/variables/geology/cases/gallery_geology_config_brittany.toml

[geology.source] kind

Source type used to load the geology layer shown by the property demo.

vector

hydromodpy/data/variables/geology/cases/gallery_geology_config_brittany.toml

[geology.source] code_field

Attribute used as the geology code when transferring values onto the support.

CODE_LEG

hydromodpy/data/variables/geology/cases/gallery_geology_config_brittany.toml

Displayed Values#

Field

Meaning

Value

Source

n_polygons

Metric displayed on this page.

23

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

n_unique_zones

Metric displayed on this page.

13

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

n_mesh_cells

Metric displayed on this page.

400

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

property_max

Metric displayed on this page.

7.21e-05 m/s

docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany_summary.json

Source Pointers#

  • hydromodpy/data/variables/geology/cases/run_geology_property_case.py

  • hydromodpy/data/variables/geology/cases/gallery_geology_config_brittany.toml

  • hydromodpy/data/variables/geology/cases/gallery_field_param_brittany.toml

  • examples/data/geology/GEO1M_brittany.shp

  • examples/data/geology/GEO1M_brittany.dbf

  • examples/data/geology/GEO1M_brittany.shx

  • examples/data/geology/GEO1M_brittany.prj

  • examples/data/geology/geology_K_dummy_demo.csv

  • examples/data/dem/regional_dem_naizin.tif

  • tests/unit/data_managers/geology/test_geology_property_demo.py

Artifacts#

  • docs/source/_static/capability_gallery/hydraulic_properties/hydraulic_conductivity_geology_transfer_brittany.png

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