Theory#
Method-focused notes that explain the scientific models implemented in HydroModPy: physical scope, governing equations, hydrology and recharge chains, mesh and discretization rationale, solver formulations, and the inverse problem behind calibration.
How to read this section
This is the what and why layer. For how to drive the software, open Workflow Reference. For how the code is organized, open Architecture and Developer Guide. For stable result figures, open Capability Gallery.
Sections#
What physical system HydroModPy represents, the modelling assumptions shared across workflows, and the solver-agnostic groundwater problem.
Recharge generation, PyHELP coupling, runoff and ETP chains, time aggregation, plus the semantics of streams, ocean, and drainage at the groundwater interface.
Why mesh choice is a modelling decision: structured grids, runtime DISV, triangular meshes, field-to-cell projection, quality criteria, and acceptance rules.
MODFLOW family (NWT and 6), shared numerical concepts, package semantics, XT3D, vertical representation, transport coupling, and worked cases.
The in-house finite-volume shallow-groundwater backend on triangular runtime meshes: equation, surface interaction, lower-obstacle drying, solver engines, and possibility map.
Stream support, simulated active networks, seepage and drainage operators, with K-sweep diagnostics and network metrics on the Nancon basin.
Inverse-problem formulation, objective construction, and the
numerical behaviour of each calibration method shipped in
hydromodpy.calibration.
Symbol tables with SI units and cross-references, plus the complete bibliography that backs the theory pages.
Where to start#
If you are not sure where to enter, this is a sensible reading order:
Scientific Foundations to see what physical system the toolbox actually models.
Mesh And Spatial Support because mesh choice constrains everything downstream.
Solvers for the MODFLOW family, then Boussinesq Theory if the in-house formulation is in scope.
Hydrology and Forcing for forcing chains and surface coupling.
Calibration once forward simulations are clear.