Description
Return afterVolume-beforeVolume and add withdrawalsDuringTopup for inferredAddedVolume, requiring nonnegative volumes and a nonnegative inferred addition.
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.
Return afterVolume-beforeVolume and add withdrawalsDuringTopup for inferredAddedVolume, requiring nonnegative volumes and a nonnegative inferred addition.
When to use this tool
Use Reservoir Topup Volume Delta when you need one transparent water-volume or storage-accounting component.
How to use the tool and how it works
- Enter beforeVolume, afterVolume, withdrawalsDuringTopup. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read netChange, inferredAddedVolume. Use the output convention below.
Return afterVolume-beforeVolume and add withdrawalsDuringTopup for inferredAddedVolume, requiring nonnegative volumes and a nonnegative inferred addition.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| beforeVolume | Before Volume | Required. Finite number; minimum 0. |
| afterVolume | After Volume | Required. Finite number; minimum 0. |
| withdrawalsDuringTopup | Withdrawals During Topup | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| netChange | Net Change | Required. Finite number. |
| inferredAddedVolume | Inferred Added Volume | Required. Finite number. |
{
"input": {
"beforeVolume": 10,
"afterVolume": 15,
"withdrawalsDuringTopup": 2
},
"output": {
"netChange": 5,
"inferredAddedVolume": 7
}
}Limitations and assumptions
- Volumes share units; this balance assumes the supplied withdrawals explain concurrent loss and does not distinguish leakage, evaporation, or measurement error.
- 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
Similar or alternative tools
- Reservoir Topup Overflow Gap
Form initialVolume+addedVolume-removedVolume, report its excess above capacity as overflow, cap expectedFinal at capacity, and return measuredFinal minus expectedFinal.
- Hydroponic Daily Water Balance Residual
Form opening+topup-drain-evaporated for expectedClosing and return measuredClosing minus that expectation, with all inputs nonnegative.