hydromodpy.data.store

DataStore: unified entry point for all data loading operations.

The DataStore is the main interface for loading data. It manages the catalog (metadata registry backed by DuckDB) and delegates to variable-specific managers.

If workspace_root is provided (path to an hmp workspace init workspace), API results are persisted as CSV files in data/<variable>/ and registered in data/cache.duckdb under the workspace root. Custom data stays at the path specified by the user in the TOML.

If workspace_root is None, data is loaded in memory only (no persistence). Runtime callers may pass an existing catalog and data root so the simulation loader and interactive facade share the same manager instantiation path.

Classes

DataStore(*[, workspace_root, data_root, ...])

Central coordinator for data loading, caching, and project clipping.