ProjectRunner

class hydromodpy.project.ProjectRunner(project)

Bases: object

Run-phase methods bound to a Project instance.

Composed by Project (project._runner). Holds no state of its own besides the back-reference to project and a delegate for the prepared-run primitives; every call reads or mutates the project’s workflow context directly.

Parameters:

project (Project)

run(*, name=None, resume=None, from_step=None, until_step=None, dry_run=False, frozen=False, no_display=False, parallel=True, **overrides)

Run the simulation through the canonical workflow Pipeline.

parallel (default True) lets the Pipeline dispatch independent Kahn cohorts through a thread pool. Pass parallel=False to force the legacy sequential path (useful for debugging).

Parameters:

• name (str | None)

• resume (str | None)

• from_step (str | int | None)

• until_step (str | int | None)

• dry_run (bool)

• frozen (bool)

• no_display (bool)

• parallel (bool)

Return type:

Run | None

sweep(parameters, *, strategy='enumerate', name_template='{param}_{value:.4g}', parallel=1)

Run N simulations from a parameter table.

parallel > 1 enables the thread-pool backend in hydromodpy.workflow.parallel.run_sweep(). Threads are chosen over processes because the live Project (DuckDB catalog, Zarr store, in-memory WorkflowContext) is not pickle-safe.

Parameters:

• parameters (dict[str, list[float] | dict])

• strategy (str)

• name_template (str)

• parallel (int)