hydromodpy.results.run_environment

Capture host environment metadata for the runs_environment table.

What

capture_environment returns a typed snapshot of the Python runtime, host hardware, git commit (HydroModPy + project root), installed packages, and the SHA-256 of the active solver binary when known. Output matches the column layout of the v2 runs_environment DDL declared in catalog/migrations/0001_initial.sql.

Why

ML pipelines that train on HydroModPy results need to filter / stratify by hardware and software so that model performance is comparable across runs. The snapshot is recorded once per simulation at registration time so the data is reproducible weeks later.

Functions

capture_environment(*[, project_root, ...])	Snapshot the host environment for one simulation (solver-agnostic).
solver_binary_identity(solver_binary_path)	Return (sha256, version_text) for a solver binary, or (None, None).

Classes

EnvironmentSnapshot

Typed dict matching v2 runs_environment columns (solver-agnostic).