Reservoir Topup Overflow Gap Tool

Description

Form initialVolume+addedVolume-removedVolume, report its excess above capacity as overflow, cap expectedFinal at capacity, and return measuredFinal minus expectedFinal.

A water balance tracks additions, withdrawals, storage changes, and a residual over one declared interval. A remainder can reveal inconsistency without identifying whether it came from leakage, timing, or measurement error.

Form initialVolume+addedVolume-removedVolume, report its excess above capacity as overflow, cap expectedFinal at capacity, and return measuredFinal minus expectedFinal.

When to use this tool

Use Reservoir Topup Overflow Gap when you need one transparent water-volume or storage-accounting component.

How to use the tool and how it works

Enter initialVolume, addedVolume, removedVolume, capacity, measuredFinal. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read predictedBeforeOverflow, overflow, expectedFinal, residual. Use the output convention below.

Form initialVolume+addedVolume-removedVolume, report its excess above capacity as overflow, cap expectedFinal at capacity, and return measuredFinal minus expectedFinal.^[1]

Input field	Meaning and units	Accepted input
initialVolume	Initial Volume	Required. Finite number; minimum 0.
addedVolume	Added Volume	Required. Finite number; minimum 0.
removedVolume	Removed Volume	Required. Finite number; minimum 0.
capacity	Capacity	Required. Finite number; minimum 0.
measuredFinal	Measured Final	Required. Finite number; minimum 0.

Output field	Interpretation	Returned shape
predictedBeforeOverflow	Predicted Before Overflow	Required. Finite number.
overflow	Overflow	Required. Finite number.
expectedFinal	Expected Final	Required. Finite number.
residual	Residual	Required. Finite number.

json

{
  "input": {
    "initialVolume": 80,
    "addedVolume": 40,
    "removedVolume": 10,
    "capacity": 100,
    "measuredFinal": 95
  },
  "output": {
    "predictedBeforeOverflow": 110,
    "overflow": 10,
    "expectedFinal": 100,
    "residual": -5
  }
}

Limitations and assumptions

Inputs are nonnegative, initial volume fits capacity, and removals cannot exceed available volume. Overflow is an ideal accounting cap, not a hydraulic prediction or equipment-safety assessment.
Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Reconcile all flows and storage observations on a common interval and investigate residuals using independent measurements.

References

Calculation and input contract: hydroponics/reservoir-topup-overflow-gap — tool.io

Similar or alternative tools

Reservoir Topup Volume Delta
Return afterVolume-beforeVolume and add withdrawalsDuringTopup for inferredAddedVolume, requiring nonnegative volumes and a nonnegative inferred addition.
Hydroponic Daily Water Balance Residual
Form opening+topup-drain-evaporated for expectedClosing and return measuredClosing minus that expectation, with all inputs nonnegative.