Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- GDS Watershed Basis
-
Default Direct projected area Allowed Direct projected area, Eight-section roof plan
About this input
Uses one projected area or a fixed eight-row roof plan with per-section allocation.
- GDS Gutter Geometry
-
Default Rectangular Allowed Rectangular, Semicircular, Custom hydraulic data
About this input
Selects the open-channel geometry used to derive area and hydraulic radius.
- GDS Downspout Mode
-
Default Size required count Allowed Size required count, Check installed layout
About this input
Sizes the required count or checks a complete installed layout.
- GDS Rainfall Intensity in hr
-
Unit in/h Default 3 Range 0.1 to 20
About this input
Project design intensity; no regional rainfall table is embedded.
- GDS Design Flow Factor
-
Unit factor Default 1.1 Range 1 to 3
About this input
Editable multiplier applied after runoff calculation for planning conservatism.
- GDS Direct Roof Area ft2 Conditional
-
Unit ft^2 Default 1600 Range 1 to 100000
About this input
Horizontal contributing area used only in the direct route.
- GDS Direct Runoff Coefficient Conditional
-
Unit fraction Default 0.95 Range 0.01 to 1
About this input
Editable runoff coefficient used only with direct projected area.
- GDS Gutter Run Length ft
-
Unit ft Default 50 Range 1 to 1000
About this input
Length used to calculate the average downspout spacing.
- GDS Manning n
-
Unit dimensionless Default 0.013 Range 0.005 to 0.1
About this input
User-reviewed open-channel roughness; the workbook embeds no material table.
- GDS Gutter Slope
-
Unit ft/ft Default 0.005 Range 0.0001 to 0.25
About this input
Longitudinal energy-slope approximation used by Manning arithmetic.
- GDS Rectangular Width in Conditional
-
Unit in Default 5 Range 0.5 to 36
About this input
Inside flow width for the rectangular route.
- GDS Rectangular Depth in Conditional
-
Unit in Default 2.5 Range 0.1 to 18
About this input
Modeled water depth for the rectangular route.
- GDS Semicircular Diameter in Conditional
-
Unit in Default 6 Range 1 to 36
About this input
Inside diameter of an open semicircular section at brim depth.
- GDS Custom Flow Area ft2 Conditional
-
Unit ft^2 Default 0.08 Range 0.0001 to 10
About this input
User-derived open flow area for a custom section.
- GDS Custom Hydraulic Radius ft Conditional
-
Unit ft Default 0.08 Range 0.0001 to 5
About this input
User-derived flow area divided by wetted perimeter.
- GDS Verified Downspout Capacity gpm
-
Unit gpm Default 35 Range 0.1 to 1000
About this input
Project- or product-specific inlet and outlet capacity; vertical downspout capacity is not inferred from pipe Manning flow.
- GDS Maximum Downspout Spacing ft
-
Unit ft Default 40 Range 1 to 200
About this input
Editable layout spacing limit used independently from hydraulic capacity.
- GDS Installed Downspout Count Conditional
-
Unit downspouts Default 2 Range 1 to 100
About this input
Whole installed count checked only in layout mode.
- GDS Roof Section Grid Conditional
-
Default 8 rows
About this input
Exactly eight complete unique rows; excluded rows remain fully typed so incoming payloads replace every shipped default cell.
Column Range or allowed values Include Yes, No Roof-section label Not declared Projected length 0 to 1000 Projected width 0 to 1000 Runoff coefficient 0 to 1 Allocation 0 to 1
Outputs
- GDS Contributing Area ft2
-
Unit ft^2
About this output
Projected roof area allocated to the subject gutter.
- GDS Effective Runoff Coefficient
-
Unit fraction
About this output
Area-weighted runoff coefficient after roof-section allocation.
- GDS Design Flow cfs
-
Unit ft^3/s
About this output
Rational-method peak flow after the entered design factor.
- GDS Design Flow gpm
-
Unit gpm
About this output
Peak flow converted from cubic feet per second.
- GDS Gutter Capacity cfs
-
Unit ft^3/s
About this output
Open-channel capacity of the selected geometry at entered slope and roughness.
- GDS Gutter Utilization
-
Unit fraction
About this output
Design runoff divided by modeled gutter capacity.
- GDS Hydraulic Downspout Count
-
Unit downspouts
About this output
Count required by verified unit outlet capacity.
- GDS Spacing Downspout Count
-
Unit downspouts
About this output
Count required by gutter length and maximum spacing.
- GDS Required Downspout Count
-
Unit downspouts
About this output
Greater of the hydraulic and spacing counts.
- GDS Layout Count Used
-
Unit downspouts
About this output
Required count in sizing mode or entered installed count in checking mode.
- GDS Average Downspout Spacing ft
-
Unit ft
About this output
Gutter run length divided by the layout count used.
- GDS Downspout Utilization
-
Unit fraction
About this output
Design flow divided by combined verified outlet capacity.
- GDS Watershed Route Used
-
No unit declared
About this output
Active contributing-area route.
- Model Status
-
No unit declared
About this output
OK identifies a finite gutter and outlet screen; CHECK identifies hydraulic or layout shortfall; NOT VALID identifies intake failure.
Methodology
Purpose and model boundary
Routes direct or sectioned roof area through Rational runoff, Manning gutter capacity, and independent outlet-capacity and spacing counts.
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
- watershed basis: a listed route or text value.
- gutter geometry: a listed route or text value.
- downspout mode: a listed route or text value.
- rainfall intensity in hr: entered in inches per hour.
- design flow factor: entered in factor.
- direct roof area ft2: entered in ft^2.
- direct runoff coefficient: entered in fraction.
- gutter run length ft: entered in ft.
- manning n: entered in dimensionless.
- gutter slope: entered in ft/ft.
- rectangular width in: entered in inches.
- rectangular depth in: entered in inches.
- semicircular diameter in: entered in inches.
- custom flow area ft2: entered in ft^2.
- custom hydraulic radius ft: entered in ft.
- verified downspout capacity gpm: entered in gpm.
- maximum downspout spacing ft: entered in ft.
- installed downspout count: entered in downspouts.
The roof section grid contains 8 fixed data rows plus one header row with these columns: Include, Roof-section label, Projected length (ft), Projected width (ft), Runoff coefficient (fraction), Allocation (fraction). Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
Runoff-weighted roof area and design flow are:
A_eff = sum(A_j C_j)
Q_d = 1.008 i (A_eff/43,560) f_d
A_eff is in ft^2 and Q_d is in ft^3/s. The area relationship is evaluated over included roof section j, or as direct area times direct runoff coefficient. i is rainfall intensity (in/h), f_d is the design-flow factor, and 43,560 converts ft^2 to acres.
The selected open gutter uses:
Q_g = (1.486/n) A_g R_h^(2/3) sqrt(S)
R_h = A_g/P_w
Q_g is in ft^3/s. n is Manning roughness, A_g is flow area (ft^2), R_h is hydraulic radius (ft), P_w is wetted perimeter (ft), and S is gutter slope (ft/ft). Rectangular, semicircular, and entered-custom routes supply their own A_g and R_h.
After converting design flow to gal/min, the capacity count, spacing count, and required count are:
N_cap = ceil(Q_d,gpm/q_unit)
N_space = ceil(L_g/s_max)
N_required = max(N_cap,N_space)
q_unit is verified downspout capacity (gal/min), L_g is gutter run (ft), and s_max is maximum spacing (ft).
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
- contributing area ft2 (ft^2): Projected roof area allocated to the subject gutter.
- design flow cfs (ft^3/s): Rational-method peak flow after the entered design factor.
- gutter capacity cfs (ft^3/s): Open-channel capacity of the selected geometry at entered slope and roughness.
- gutter utilization (fraction): Design runoff divided by modeled gutter capacity.
- required downspout count (downspouts): Greater of the hydraulic and spacing counts.
- average downspout spacing ft (ft): Gutter run length divided by the layout count used.
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 |
|---|---|
GDS_Inputs_Valid is FALSE |
NOT VALID: correct routes, active dimensions, or all eight complete unique roof-section rows |
GDS_Derived_Numerics_Valid_Internal is FALSE |
NOT VALID: gutter, runoff, or outlet arithmetic produced a nonfinite result |
GDS_Design_Flow_Internal > GDS_Gutter_Capacity_Internal |
CHECK: modeled runoff exceeds the selected gutter geometry capacity |
GDS_Downspout_Mode = "Check installed layout" and GDS_Layout_Count_Internal < GDS_Required_Count_Internal |
CHECK: installed downspout count or spacing is below the modeled requirement |
| None of the preceding conditions applies | OK |
Assumptions and limitations
All shipped default roof rows, dimensions, and outlet values are synthetic illustrative demonstrations.
Rainfall intensity, runoff coefficients, roughness, dimensions, and downspout capacity are editable project inputs.
Roof areas are horizontal projected areas allocated to one subject gutter.
Semicircular capacity assumes an open half-circle flowing at its entered brim diameter.
This is not a roof-drainage design, overflow-path analysis, inlet-weir model, icing analysis, code determination, or product approval.
A qualified designer must verify local rainfall, roof geometry, gutter freeboard, outlets, leaders, discharge, foundations, erosion, and adopted requirements.
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 137 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- FHWA Urban Drainage Design Manual HEC-22 - Primary public source for Rational and Manning equations. Official U.S. government publication; equations are independently implemented and no table is copied.
- NOAA Atlas 14 precipitation frequency estimates - Official place for users to obtain local rainfall inputs; no rainfall data is embedded. Official U.S. government service; no rainfall table is copied or embedded.
- NIST volume units - Official unit-conversion provenance. 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.