hydromodpy.core#

Core infrastructure layer for HydroModPy.

Keep this package-level module lightweight: importing hydromodpy.core should not eagerly pull the full configuration and data-loading stack. core is the kernel leaf of the import DAG and must not re-export symbols from sibling layers.

Modules

administrative_france

French administrative region name registry shared by config layers.

auth

Authentication and authorisation backends for HydroModPy.

bootstrap_hook

Lazy bootstrap trigger shared across layers.

config

Legacy-free core configuration namespace.

config_kit

Pydantic helpers shared by every HydroModPy configuration model.

contracts

Neutral runtime-state contracts shared across pipeline layers.

exceptions

Typed exception hierarchy for HydroModPy.

field_routing

Pure helpers for drain budgets and mesh routing.

grid_reference

Plain geometric description of a solver grid (kernel-level POPO).

io

Low-level I/O helpers: raster, vector, CRS, JSON, HTTP.

logging

HydroModPy logging subsystem.

metrics

Pure goodness-of-fit metrics shared across layers.

migrations

Generic Alembic-like schema migration runner shared by all DuckDB components.

nodata

Shared nodata sentinels.

rng

Centralized RNG seed derivation.

solver_diagnostics

Stable names for persisted solver diagnostic artifacts.

state

Runtime state models shared by launchers and simulation execution.

time

Shared simulation time-window resolution helpers.

toml_io

TOML I/O and path-resolution helpers shared by every config layer.

tracking

Input-file tracking primitives used across HydroModPy configs.

units

Unit parsing and formatting helpers.

version

Canonical source of the HydroModPy version string.

workspace

Workspace structures used by simulation and launchers.