hydromodpy.physics.flow.physical_properties#

Pydantic model for flow physical properties with pint units.

This module introduces a typed, unit-aware representation of the core hydrogeological scalars (k_aquifer, specific_yield, specific_storage) used by flow simulations. It is the first P03 migration target and serves as the template for the broader rollout planned in P04-P09 (field parameters, recharge, boundary conditions, …).

Canonical units#

  • k_aquifer : m/s (via HydraulicConductivity)

  • specific_yield : - (dimensionless, in [0, 1])

  • specific_storage : 1/m (via SpecificStorage)

TOML compatibility#

Each pint-typed field accepts either a bare number (interpreted in the canonical unit) or an explicit "<value> <unit>" string, so the following are all valid:

[flow.properties]
k_aquifer = 1e-4            # m/s (fallback)
k_aquifer = "1e-4 m/s"
k_aquifer = "0.36 m/h"      # auto-converted to m/s

The value always comes back as a pint Quantity in the canonical unit.