Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- RWH Yield Basis
-
Default Roof area and rainfall Allowed Roof area and rainfall, Direct captured inflow
About this input
Derives monthly yield from roof rainfall or uses directly reviewed monthly captured inflow.
- RWH Demand Basis
-
Default Daily demand and multiplier Allowed Monthly entered demand, Daily demand and multiplier
About this input
Uses entered monthly demand or daily demand scaled by each month's days and multiplier.
- RWH Tank Mode
-
Default Select passing capacity Allowed Evaluate entered capacity, Select passing capacity
About this input
Evaluates one entered capacity or selects the first passing point on a fixed 21-capacity ladder.
- RWH Initial Storage Mode
-
Default Start empty Allowed Start empty, Entered initial storage
About this input
Starts the annual simulation empty or at an entered volume capped by tank capacity.
- RWH Roof Area ft2 Conditional
-
Unit ft^2 Default 1800 Range 1 to 1000000
About this input
Projected roof area connected to the tank.
- RWH Runoff Coefficient Conditional
-
Unit fraction Default 0.9 Range 0 to 1
About this input
Editable fraction of post-flush rainfall leaving the roof.
- RWH Collection Efficiency Conditional
-
Unit fraction Default 0.85 Range 0 to 1
About this input
Editable conveyance and filter efficiency.
- RWH First Flush Depth in Conditional
-
Unit in/month Default 0.05 Range 0 to 5
About this input
Simplified depth deducted once per modeled month.
- RWH Daily Demand gal Conditional
-
Unit gal/day Default 65 Range 0 to 1000000
About this input
Daily demand multiplied by row days and seasonal multipliers.
- RWH Entered Tank Capacity gal Conditional
-
Unit gal Default 2000 Range 1 to 10000000
About this input
Single capacity used by evaluate mode.
- RWH Minimum Candidate Capacity gal Conditional
-
Unit gal Default 500 Range 1 to 9999999
About this input
First point on the 21-capacity selection ladder.
- RWH Maximum Candidate Capacity gal Conditional
-
Unit gal Default 5500 Range 2 to 10000000
About this input
Last point on the 21-capacity selection ladder; must exceed the minimum.
- RWH Target Reliability
-
Unit fraction Default 0.8 Range 0 to 1
About this input
Required fraction of modeled demand delivered.
- RWH Minimum Ending Reserve Fraction
-
Unit fraction of capacity Default 0 Range 0 to 1
About this input
Required ending storage divided by evaluated capacity.
- RWH Entered Initial Storage gal Conditional
-
Unit gal Default 500 Range 0 to 10000000
About this input
Opening storage capped by evaluated capacity.
- RWH Fixed System Cost
-
Unit user currency Default 1400 Range 0 to 10000000
About this input
Illustrative non-tank installed cost.
- RWH Tank Cost per gal
-
Unit user currency/gal Default 0.8 Range 0 to 10000
About this input
Illustrative linear tank cost.
- RWH Water Value per 1000 gal
-
Unit user currency/1,000 gal Default 12 Range 0 to 100000
About this input
Editable avoided-water value; no tariff dataset is embedded.
- RWH Monthly Grid
-
Default 12 rows
About this input
Exactly twelve complete unique month rows. The days column must total 365 or 366; both route-specific data columns remain fully typed.
Column Range or allowed values Month label Not declared Days 1 to 31 Rainfall 0 to 100 Direct captured inflow 0 to 10000000 Entered demand 0 to 10000000 Daily-demand multiplier 0 to 10
Outputs
- RWH Selected Tank Capacity gal
-
Unit gal
About this output
Entered capacity or first passing fixed-ladder capacity.
- RWH Annual Captured Inflow gal
-
Unit gal/year
About this output
Sum of routed monthly captured inflows.
- RWH Annual Demand gal
-
Unit gal/year
About this output
Sum of routed monthly demand.
- RWH Annual Delivered Water gal
-
Unit gal/year
About this output
Demand less selected-capacity shortfall.
- RWH Annual Shortfall gal
-
Unit gal/year
About this output
Demand unmet by monthly stored water.
- RWH Annual Overflow gal
-
Unit gal/year
About this output
Post-demand water exceeding tank capacity.
- RWH Volumetric Reliability
-
Unit fraction
About this output
One minus annual shortfall divided by annual demand.
- RWH Ending Storage gal
-
Unit gal
About this output
Storage after the twelfth modeled month.
- RWH Minimum Month End Storage gal
-
Unit gal
About this output
Minimum of the twelve month-end storage values.
- RWH Annual Mains Water Offset gal
-
Unit gal/year
About this output
Modeled delivered rainwater, before any local potable-use restriction.
- RWH Annual Water Value
-
Unit user currency/year
About this output
Delivered volume times entered value per 1,000 gallons.
- RWH Simple Payback years
-
Unit years
About this output
Fixed plus linear tank cost divided by annual modeled water value.
- RWH Candidate Capacities Evaluated
-
Unit capacities
About this output
One in evaluate mode or 21 in fixed-ladder select mode.
- RWH Yield Route Used
-
No unit declared
About this output
Captured-inflow route applied to all twelve rows.
- Model Status
-
No unit declared
About this output
OK identifies a passing capacity; CHECK identifies a ladder gap; NOT VALID identifies intake failure.
Methodology
Purpose and model boundary
Runs a twelve-month storage balance across one entered tank or a fixed 21-capacity ladder and exposes reliability, overflow, reserve, and simple economics.
Do not treat this result as a hydraulic or plumbing design, flood-protection guarantee, code-compliance determination, permit approval, equipment selection, safety certification, cost quote, or endorsement by a cited source. Site geometry, rainfall, runoff, soil, pipe, pump, tank, irrigation, manufacturer, locally adopted code, and approval inputs remain the user's responsibility.
Inputs and units
- yield basis: a listed route or text value.
- demand basis: a listed route or text value.
- tank mode: a listed route or text value.
- initial storage mode: a listed route or text value.
- roof area ft2: entered in ft^2.
- runoff coefficient: entered in fraction.
- collection efficiency: entered in fraction.
- first flush depth in: entered in inches per month.
- daily demand gal: entered in gal/day.
- entered tank capacity gal: entered in gal.
- minimum candidate capacity gal: entered in gal.
- maximum candidate capacity gal: entered in gal.
- target reliability: entered in fraction.
- minimum ending reserve fraction: entered in fraction of capacity.
- entered initial storage gal: entered in gal.
- fixed system cost: entered in user currency.
- tank cost per gal: entered in user currency/gal.
- water value per 1000 gal: entered in user currency/1,000 gal.
The monthly grid contains 12 fixed data rows plus one header row with these columns: Month label; fixed/read-only, Days (days), Rainfall (in/month), Direct captured inflow (gal/month), Entered demand (gal/month), Daily-demand multiplier (fraction). Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
Monthly captured inflow is entered directly or calculated as:
Y_m = max(0,R_m-F) A C eta 0.623
Y_m is in gal/month, R_m is monthly rainfall (in), F is monthly first-flush depth (in), A is connected roof area (ft^2), C is runoff coefficient, eta is collection efficiency, and 0.623 converts one inch over one square foot to gallons. Monthly demand is entered directly or calculated as:
D_m = d_base n_m k_m
d_base is gal/day, n_m is days, and k_m is the row multiplier.
For tank capacity K, each month applies:
available_m = S_(m-1)+Y_m
shortfall_m = max(0,D_m-available_m)
overflow_m = max(0,available_m-D_m-K)
S_m = min(K,max(0,available_m-D_m))
Every volume is in gallons. Volumetric reliability is:
Rel = 1 - sum(shortfall_m)/sum(D_m)
or 1 when annual demand is zero.
Evaluate mode runs one entered K; select mode runs 21 evenly spaced capacities from the entered minimum through maximum and selects the first for which Rel meets target and ending storage is at least K times the reserve fraction. Annual delivered water is annual demand less shortfall, annual value is delivered gallons divided by 1,000 times entered water value, installed cost is fixed cost plus K times cost/gal, and simple payback is cost divided by positive annual value.
Calculation sequence
- Validate every active selector, scalar bound, type, and every fixed-grid entry.
- Apply the selected route and ignore values from inactive fields.
- Normalize unit-dependent inputs into the workbook's calculation basis.
- Evaluate every included row or candidate and aggregate the active schedule.
- Calculate primary and supporting outputs, populate the authored chart series, and apply derived numeric checks.
- Return the workbook status with the computed results; invalid input is never converted into a plausible engineering answer.
Outputs and interpretation
- selected tank capacity gal (gal): Entered capacity or first passing fixed-ladder capacity.
- annual delivered water gal (gal/year): Demand less selected-capacity shortfall.
- annual shortfall gal (gal/year): Demand unmet by monthly stored water.
- volumetric reliability (fraction): One minus annual shortfall divided by annual demand.
The chart is an explanatory view of the workbook's named chart ranges. It does not add a separate calculation or replace the numeric outputs.
Validation and status logic
The workbook evaluates Model_Status in the order shown. The first matching condition wins.
| First matching workbook condition | Exact returned status |
|---|---|
RWH_Inputs_Valid is FALSE |
NOT VALID: correct routes, active tank assumptions, or all twelve complete unique month rows |
RWH_Derived_Numerics_Valid_Internal is FALSE |
NOT VALID: monthly water-balance or capacity-ladder arithmetic produced a nonfinite result |
RWH_Selected_Row_Internal = 0 |
CHECK: no evaluated capacity meets reliability and ending-reserve targets |
| None of the preceding conditions applies | OK |
Assumptions and limitations
All shipped default rainfall, demand, cost, and monthly-profile values are synthetic illustrative demonstrations.
Rainfall, demand, costs, and monthly profiles are synthetic editable examples.
One aggregate tank and one monthly time step are used.
Roof yield uses 0.623 gallons per inch-foot squared before entered coefficients.
Monthly aggregation can hide storm timing, drawdown, drought sequences, first-flush event frequency, water-quality constraints, freeze protection, pump energy, and overflow routing.
Verify potable/nonpotable rules, mosquito control, structural support, backflow protection, treatment, setbacks, and permits locally.
Restrictions and non-computing states
Each numeric control offers a working range chosen for usable entry, which is not always the limit this calculator enforces; a value outside that limit is rejected with a message rather than quietly accepted. The calculator additionally enforces allowed choices, active-field types, complete fixed-grid rows, and conditional or cross-field rules before computing.
Unsupported route values, incomplete rows, out-of-domain inputs, relational failures, nonfinite derived arithmetic, and workbook error tokens are non-computing states. Hidden inputs remain in the values sent to the calculator but must not affect results while those fields are inactive.
Errors and warnings
A rejected entry means the submitted state failed the published input rules. Workbook NOT VALID identifies an invalid active domain or unsupported derived arithmetic. Workbook CHECK retains a finite result while flagging a planning condition that needs review. OK means only that the delivered workbook logic closed within the entered assumptions; it is not code compliance, professional approval, or a safety guarantee.
This version is checked against 135 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- EPA Green Infrastructure - Primary public context for rainwater capture and runoff management. Official U.S. government source; no local regulation or dataset is embedded.
- NOAA Atlas 14 precipitation frequency estimates - Primary public reminder that local precipitation inputs require location-specific review. Official U.S. government source; no NOAA rainfall table is embedded.
- NIST volume units - Primary unit-conversion provenance for gallons and cubic volume. Official public U.S. government reference; conversions are independently implemented and no source material is copied.
Licensing conclusion: No licensed, proprietary, manufacturer, utility, product-price, code-table, forecast, or external dataset is embedded. The calculator independently implements general hydraulic, water-balance, and home-project engineering arithmetic from cited public and official sources; all defaults, labels, conductor/load rows, equipment assumptions, diagrams, and test values are synthetic illustrations.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.