Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- IZD Group Flow Basis
-
Default Per-device flow Allowed Per-device flow, Direct group flow
About this input
Derives group flow from device count and flow or uses a direct group flow.
- IZD Area Basis
-
Default Direct irrigated area Allowed Direct irrigated area, Spacing-derived area
About this input
Uses direct area or device count times spacing and layout factor.
- IZD Spacing Pattern Conditional
-
Default Rectangular layout Allowed Rectangular layout, Triangular layout
About this input
Uses a 1.0 rectangular or 0.866 triangular area factor.
- IZD Target Depth Basis
-
Default Uniform zone target Allowed Uniform zone target, Per-group target depth
About this input
Applies one zone depth or the target depth in each group row.
- IZD Schedule Mode
-
Default Cycle-and-soak Allowed Continuous runtime, Cycle-and-soak
About this input
Runs continuously or divides runtime into cycles separated by soak intervals.
- IZD Precipitation Matching
-
Default Check group precipitation match Allowed Check group precipitation match, Ignore group matching
About this input
Checks active-group precipitation deviation or ignores that screen.
- IZD Available Source Flow gpm
-
Unit gal/min Default 120 Range 0.1 to 100000
About this input
Measured or independently established simultaneous source flow.
- IZD Source Dynamic Pressure psi
-
Unit psi Default 70 Range 1 to 300
About this input
Pressure available at the entered simultaneous zone flow.
- IZD Mainline Length ft
-
Unit ft Default 90 Range 1 to 10000
About this input
Equivalent common mainline length.
- IZD Mainline ID in
-
Unit in Default 2 Range 0.25 to 24
About this input
Actual mainline inside diameter used for velocity and Hazen loss.
- IZD Mainline Hazen C
-
Unit coefficient Default 130 Range 40 to 160
About this input
Editable mainline roughness coefficient.
- IZD Common Pressure Loss psi
-
Unit psi Default 8 Range 0 to 200
About this input
Entered meter, backflow, filter, and valve losses common to all groups.
- IZD Uniform Target Depth in Conditional
-
Unit in Default 0.5 Range 0.01 to 20
About this input
Target applied depth for every group in uniform mode.
- IZD Maximum Precipitation Deviation Conditional
-
Unit fraction Default 0.55 Range 0 to 2
About this input
Maximum active-group deviation from the flow-weighted zone precipitation rate.
- IZD Available Watering Window min
-
Unit min Default 360 Range 1 to 1440
About this input
Maximum elapsed runtime plus soak intervals.
- IZD Cycle Count Conditional
-
Unit cycles Default 3 Range 1 to 20
About this input
Whole-number run cycles.
- IZD Soak Time min Conditional
-
Unit min Default 20 Range 0 to 240
About this input
Elapsed soak interval between run cycles.
- IZD Maximum Mainline Velocity ft s
-
Unit ft/s Default 12 Range 0.5 to 30
About this input
Editable velocity screen, not a code requirement.
- IZD Group Grid
-
Default 8 rows
About this input
Exactly eight complete unique group rows. All route-specific flow, area, spacing, branch, pressure, target, and efficiency fields remain numeric.
Column Range or allowed values Include Yes, No Group label Not declared Device count 0 to 10000 Flow per device 0 to 1000 Direct group flow 0 to 100000 Direct area 0 to 10000000 Along spacing 0 to 1000 Across spacing 0 to 1000 Branch length 0 to 10000 Branch ID 0.1 to 24 Branch Hazen C 40 to 160 Elevation rise -100 to 500 Required terminal pressure 0 to 200 Per-group target depth 0 to 20 Application efficiency 0.01 to 1
Outputs
- IZD Active Group Count
-
Unit groups
About this output
Included irrigation groups.
- IZD Total Zone Flow gpm
-
Unit gal/min
About this output
Sum of routed active-group flows.
- IZD Total Irrigated Area ft2
-
Unit ft^2
About this output
Sum of routed active-group areas.
- IZD Weighted Precipitation Rate in hr
-
Unit in/h
About this output
96.3 times total flow divided by total area.
- IZD Minimum Group Precipitation in hr
-
Unit in/h
About this output
Minimum active-group precipitation rate.
- IZD Maximum Group Precipitation in hr
-
Unit in/h
About this output
Maximum active-group precipitation rate.
- IZD Actual Precipitation Deviation
-
Unit fraction
About this output
Largest active-group deviation from the weighted zone rate.
- IZD Mainline Velocity ft s
-
Unit ft/s
About this output
Total zone flow divided by mainline area.
- IZD Mainline Head Loss ft
-
Unit ft
About this output
Hazen-Williams head loss along the common mainline.
- IZD Minimum Pressure Margin psi
-
Unit psi
About this output
Minimum active-group pressure after common, elevation, branch, and terminal requirements.
- IZD Governing Group
-
No unit declared
About this output
Active group with the minimum pressure margin.
- IZD Zone Runtime min
-
Unit min
About this output
Maximum active-group depth runtime after application efficiency.
- IZD Runtime per Cycle min
-
Unit min/cycle
About this output
Zone runtime divided by active cycle count.
- IZD Total Elapsed Schedule min
-
Unit min
About this output
Runtime plus soak intervals.
- IZD Estimated Applied Volume gal
-
Unit gal
About this output
Total zone flow times governing zone runtime.
- IZD Schedule Route Used
-
No unit declared
About this output
Continuous or cycle-and-soak route applied.
- Model Status
-
No unit declared
About this output
OK means active screens pass; CHECK identifies a design gap; NOT VALID identifies intake failure.
Methodology
Purpose and model boundary
Combines eight irrigation groups into a simultaneous zone and audits flow, Hazen losses, pressure margins, precipitation matching, target depth, and cycle-and-soak schedule.
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
- group flow basis: a listed route or text value.
- area basis: a listed route or text value.
- spacing pattern: a listed route or text value.
- target depth basis: a listed route or text value.
- schedule mode: a listed route or text value.
- precipitation matching: a listed route or text value.
- available source flow gpm: entered in gal/min.
- source dynamic pressure psi: entered in psi.
- mainline length ft: entered in ft.
- mainline id in: entered in inches.
- mainline hazen c: entered in coefficient.
- common pressure loss psi: entered in psi.
- uniform target depth in: entered in inches.
- maximum precipitation deviation: entered in fraction.
- available watering window min: entered in min.
- cycle count: entered in cycles.
- soak time min: entered in min.
- maximum mainline velocity ft s: entered in ft/s.
The group grid contains 8 fixed data rows plus one header row with these columns: Include, Group label, Device count (devices), Flow per device (gal/min per device), Direct group flow (gal/min), Direct area (ft^2), Along spacing (ft), Across spacing (ft), Branch length (ft), Branch ID (in), Branch Hazen C (Hazen C), Elevation rise (ft), Required terminal pressure (psi), Per-group target depth (in), Application efficiency (fraction). Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
Group flow and calculated group area are:
Q_j = N_j q_j
A_j = N_j s_along,j s_across,j k_pattern
Group flow may instead be entered directly, and group area may be entered directly. Q_j is in gal/min, A_j is in ft^2, N_j is device count, q_j is per-device flow (gal/min), spacings are feet, and k_pattern is 1 for rectangular spacing or 0.866025403784439 for triangular spacing.
The US-customary Hazen-Williams pressure-loss form used by the workbook is:
DeltaP = 4.52 L Q^1.852/(C^1.852 d^4.87)
Published head loss is:
h_f = 2.31 DeltaP
DeltaP is in psi and h_f is in ft of water. L is equivalent length (ft), Q is flow (gal/min), C is the Hazen-Williams coefficient, and d is inside diameter (in). The minimum group pressure margin is evaluated in psi as:
M_j = P_source - P_common - DeltaP_main - P_terminal,j - z_j/2.31 - DeltaP_branch,j
P_source, P_common, and P_terminal,j are psi and elevation rise z_j is ft. No 4.52 term is divided by 2.31 a second time.
Mainline velocity, precipitation, and runtime are:
v = (Q_total/448.831168831169)/[pi(d/12)^2/4]
p_j = 96.3 Q_j/A_j
t_j = 60 D_j/(p_j eta_j)
v is in ft/s, p_j is in inches per hour, and t_j is in minutes. Zone runtime is max(t_j) over active groups; D_j is target depth (in) and eta_j is application efficiency. Cycle-and-soak divides runtime by cycle count and adds the entered inter-cycle soak intervals to elapsed time.
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
- total zone flow gpm (gal/min): Sum of routed active-group flows.
- total irrigated area ft2 (ft^2): Sum of routed active-group areas.
- weighted precipitation rate in hr (in/h): 96.3 times total flow divided by total area.
- minimum pressure margin psi (psi): Minimum active-group pressure after common, elevation, branch, and terminal requirements.
- governing group: Active group with the minimum pressure margin.
- zone runtime min (min): Maximum active-group depth runtime after application efficiency.
- total elapsed schedule min (min): Runtime plus soak intervals.
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 |
|---|---|
IZD_Inputs_Valid is FALSE |
NOT VALID: correct zone routes, active assumptions, or all eight complete unique group rows |
IZD_Derived_Numerics_Valid_Internal is FALSE |
NOT VALID: irrigation flow, pressure, precipitation, or schedule arithmetic produced a nonfinite result |
IZD_All_Screens_Pass_Internal = 0 |
CHECK: zone flow, pressure, velocity, precipitation match, or watering-window screen fails |
| None of the preceding conditions applies | OK |
Assumptions and limitations
All shipped default device, spacing, branch, and schedule values are synthetic illustrative demonstrations.
Every device, spacing, branch, cost-free hydraulic row, and default is a synthetic editable illustration.
All active groups run simultaneously as one zone.
Source pressure is assumed available at the modeled simultaneous flow.
This does not model emitter pressure-flow curves, distribution uniformity tests, valve Cv, dynamic source curves, soil intake, slope runoff, wind, evapotranspiration, local watering rules, backflow codes, or pipe surge.
Verify device manufacturer data, pressure regulation, field catch-can results, source capacity, soil, plant needs, and local 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 122 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- EPA WaterSense - Primary public context for water-efficient irrigation and reviewed landscape assumptions. Official U.S. government source; no product or rating dataset is embedded.
- USDA NRCS National Engineering Handbook - Primary public engineering context for irrigation hydraulics and water application. Official U.S. government source; equations are independently implemented.
- NIST volume units - Official unit-conversion provenance for gallons and flow. 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.