Square Field Parameterizations#

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 builds one compact two-zone square domain and maps the same conductivity field onto structured and triangular meshes. It also illustrates how inline units and depth-profile modes are normalized before the solver stage.

Hydraulic conductivity parameterizations on square synthetic meshes
Structured and triangular conductivity maps alongside depth-profile and inline-unit examples.

Case Setup#

  • Unit-square domain split by one diagonal into granite and micaschist zones.

  • Structured and triangular meshes generated from the same target cell count.

  • Depth dependence illustrated with none, exponential, and tabulated profiles.

What It Shows#

  • How the same heterogeneous K field maps onto structured and triangular meshes.

  • How inline values such as m/day and mm/day are normalized to HydroModPy’s SI internals.

  • How none, exponential, and tabulated depth profiles modify conductivity with depth.

Key Metrics#

  • Structured cells: 64

  • Triangular cells: 128

  • Minimum K: 2.0 m/day

  • Maximum K: 10.0 m/day

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#

Selected Parameters#

Field

Meaning

Value

Source

property_case_kind

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

square_parameterizations

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

parameter_ids

Hydraulic parameters illustrated by the case.

K, Sy, Ss

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

parameterization_modes

Parameterization modes intentionally demonstrated by the case.

inline, heterogeneous, exponential, tabulated

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

supports

Spatial supports used to render the field or compare variants.

structured, triangular_structured

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

Configuration Values#

Field

Meaning

Value

Source

[field] id

Identifier used by FieldParam for the illustrated hydraulic property.

K

hydromodpy/spatial/field/cases/square/field_param_config.toml

[field] kind

Homogeneous or heterogeneous assignment mode used by the field parameter.

heterogeneous

hydromodpy/spatial/field/cases/square/field_param_config.toml

[field] unit

Unit declared for the property values before internal normalization.

m/s

hydromodpy/spatial/field/cases/square/field_param_config.toml

[field] values_source

How heterogeneous values are supplied to the field parameter.

inline

hydromodpy/spatial/field/cases/square/field_param_config.toml

[field] values

Inline heterogeneous values used to map zones or materials to property values.

granite=10, micaschists=2

hydromodpy/spatial/field/cases/square/field_param_config.toml

[field_vertical_profile] mode

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

none

hydromodpy/spatial/field/cases/square/field_param_config.toml

Displayed Values#

Field

Meaning

Value

Source

structured_cell_count

Metric displayed on this page.

64

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

triangular_cell_count

Metric displayed on this page.

128

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

k_min_m_per_day

Metric displayed on this page.

2.0 m/day

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

k_max_m_per_day

Metric displayed on this page.

10.0 m/day

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

Source Pointers#

  • hydromodpy/spatial/field/core/field_param.py

  • hydromodpy/spatial/field/core/field_param_config.py

  • hydromodpy/spatial/field/cases/square/field_mesh_square.py

  • hydromodpy/spatial/field/cases/square/field_spatial_square.py

  • hydromodpy/spatial/field/cases/square/field_param_config.toml

  • tests/unit/field/test_field_param.py

  • tests/unit/field/test_field_param_config.py

Artifacts#

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

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