Pump-state series

Overview

pump-state-series classifies well depth into pumping, recovering, and static episodes using a trailing ceiling.

Example configuration

source: series:///sensors/well  # Required: example exact source URL.
time_column: timestamp         # Required: source event-time column.
depth_column: depth            # Required: source depth column.
lookback: 60m                  # Required: example trailing ceiling window.
disturbance_drop: 1.0           # Required: example drop in source depth units.
valid_depth_min: 0.0           # Required: example inclusive lower depth bound.
valid_depth_max: 100.0          # Required: example inclusive upper depth bound.

There are no default thresholds. These numbers illustrate the shape; choose depth bounds and disturbance criteria for your actual data.

Use and behavior

Install with pond mknod pump-state-series /derived/pump-state --config-path pump.yaml, then inspect and query the resulting view.

The source URL must be exact, without wildcards. Depth limits must be finite and ordered, and lookback must be positive whole minutes. This is analytical classification, not pump control or a safety alarm.

Full configuration

Settings

FieldAccepted typeRequiredDefaultDescription
depth_columnstringyesnot specifiedSource well-depth column.
disturbance_dropnumberyesnot specifiedMinimum depth drop below the trailing ceiling that starts disturbance. Constraints: format="double".
lookbackstringyesnot specifiedWidth of the trailing ceiling.
sourceWatertown Urlyesnot specifiedExact logical source URL.
time_columnstringyesnot specifiedSource event-time column.
valid_depth_maxnumberyesnot specifiedInclusive valid depth ceiling. Constraints: format="double".
valid_depth_minnumberyesnot specifiedInclusive valid depth floor. Constraints: format="double".

Watertown Url

Accepted value: string.