Description
Sum depth*area into potentialVolume, depth*area*fraction into capturedVolume, and verified contributions into supportedCapturedVolume.
Garden and resource-design calculations combine measured lengths, areas, water volumes, material fractions, travel, and evidence records. A useful budget needs consistent units and clear overlap, exclusion, and denominator rules. Supplied geometry and efficiencies describe a model rather than verified site performance.
Sum depth*area into potentialVolume, depth*area*fraction into capturedVolume, and verified contributions into supportedCapturedVolume.
When to use this tool
Use Rain Capture Support Share when you have supplied site dimensions or resource records and need the stated geometry, budget, or coverage measure.
How to use the tool and how it works
- Enter rainDepths, catchmentAreas, captureFractions, sourceVerified. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read potentialVolume, capturedVolume, supportedCapturedVolume, supportedShare, defined. Inspect defined before interpreting the associated values.
Require aligned nonnegative rainDepths and catchmentAreas, captureFractions in [0,1], and sourceVerified flags. Sum depth*area into potentialVolume, depth*area*fraction into capturedVolume, and verified contributions into supportedCapturedVolume. Return supportedShare over capturedVolume when positive, otherwise zero with defined=false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| rainDepths | Rain Depths | Required. Array of finite number; maximum items 256. |
| catchmentAreas | Catchment Areas | Required. Array of finite number; maximum items 256. |
| captureFractions | Capture Fractions | Required. Array of finite number; maximum items 256. |
| sourceVerified | Source Verified | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| potentialVolume | Potential Volume | Required. Finite number. |
| capturedVolume | Captured Volume | Required. Finite number. |
| supportedCapturedVolume | Supported Captured Volume | Required. Finite number. |
| supportedShare | Supported Share | Required. Finite number. |
| defined | Whether the associated denominator or quantity is defined; read before using a zero placeholder. | Required. Boolean. |
{
"input": {
"rainDepths": [
1,
2
],
"catchmentAreas": [
10,
5
],
"captureFractions": [
0.5,
1
],
"sourceVerified": [
true,
false
]
},
"output": {
"potentialVolume": 20,
"capturedVolume": 15,
"supportedCapturedVolume": 5,
"supportedShare": 0.3333333333333333,
"defined": true
}
}Limitations and assumptions
- Depth and area units determine the common volume product. Catchment overlap and source-verification flags are not checked; supportedShare measures supplied evidence coverage rather than collection performance or water safety.
- 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. Signed zero is exported as zero.
Alternative or Complementary methods
Use verified site measurements and suitable physical or resource models for a complete design. Check units, overlap, losses, capacity, and whether an accounting share represents the intended quantity.
References
Similar or alternative tools
- Water Catchment Yield Factor
Ideal supplied rainfall-area capture equivalent with an explicit runoff fraction and compatible volume conversion.
- Rainwater Earthwork Catchment Depth Factor
For nonnegative areaM2 and depthMm and captureFraction in [0,1] return capturedLiters=areaM2*depthMm*captureFraction.