hydromodpy.calibration.materialize

Materialise a self-contained TOML overlay for one calibration candidate.

The overlay inherits the target simulation config via base_config and rewrites each configured parameter at its target dotted path (honouring mode="replace" or "scale"). The resulting file can be loaded by hydromodpy.Project and re-run independently of the calibration session, which makes it the natural hand-off for sharing the best candidate of a session or replaying a single trial.

The overlay is rendered through hydromodpy.core.toml_io.writer so the output remains valid TOML and round-trips through tomllib even in lightweight environments where external TOML writer packages are not installed. The base_config argument accepts either a path to a TOML file on disk or an in-memory HydroModPyConfig instance; the latter is useful when the calibration loop is driven from Python code.

Functions

materialize_candidate(base_config, params, ...)	Write a standalone override TOML for one calibration candidate.
write_overlay_toml(path, payload)	Render payload to TOML at path.