Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- WHS Velocity Basis
-
Default Flow and diameter Allowed Flow and diameter, Direct velocity
About this input
Uses event flow and pipe diameter or each row's direct velocity.
- WHS Wave Speed Basis
-
Default Derived elastic wave speed Allowed Derived elastic wave speed, Entered wave speed
About this input
Derives elastic wave speed from fluid and pipe properties or uses one reviewed entered value.
- WHS Closure Model
-
Default Finite closure time Allowed Instantaneous closure, Finite closure time
About this input
Applies the full Joukowsky rise or a critical-time-to-closure reduction capped at one.
- WHS Pressure Direction
-
Default Positive pressure rise Allowed Positive pressure rise, Negative pressure drop
About this input
Screens a positive pressure rise or a negative pressure drop.
- WHS Base Line Pressure psi
-
Unit psi Default 55 Range 0 to 1000
About this input
Steady pressure before the modeled velocity change.
- WHS Vapor Pressure psi
-
Unit psi Default 0 Range -15 to 100
About this input
Editable absolute-reference screening floor; must remain below baseline pressure.
- WHS Fluid Specific Gravity
-
Unit relative Default 1 Range 0.1 to 3
About this input
Fluid density relative to water for the Joukowsky calculation.
- WHS Fluid Bulk Modulus psi Conditional
-
Unit psi Default 320000 Range 100000 to 10000000
About this input
Editable fluid bulk modulus used by the derived elastic wave-speed route.
- WHS Entered Wave Speed ft s Conditional
-
Unit ft/s Default 3500 Range 100 to 10000
About this input
Reviewed wave speed applied to every active event in entered mode.
- WHS Velocity Change Fraction
-
Unit fraction Default 1 Range 0 to 2
About this input
Fraction of event velocity lost or gained during the transient.
- WHS Event Grid
-
Default 8 rows
About this input
Exactly eight complete unique event rows. All route-specific velocity and elastic columns remain numeric to prevent default-row persistence.
Column Range or allowed values Include Yes, No Event label Not declared Material label Not declared Flow 0 to 100000 Direct velocity 0 to 100 Closure time 0.001 to 3600 Line length 0.1 to 100000 Pipe ID 0.1 to 120 Wall thickness 0.001 to 12 Elastic modulus 1000 to 100000000 Restraint factor 0 to 5 Allowable peak pressure 0.1 to 10000
Outputs
- WHS Active Event Count
-
Unit events
About this output
Included surge-event rows.
- WHS Controlling Event
-
No unit declared
About this output
Active event with the highest normalized surge severity.
- WHS Controlling Material
-
No unit declared
About this output
Entered material label for the controlling event.
- WHS Controlling Velocity ft s
-
Unit ft/s
About this output
Routed velocity for the controlling event.
- WHS Controlling Wave Speed ft s
-
Unit ft/s
About this output
Derived or entered wave speed for the controlling event.
- WHS Critical Closure Time s
-
Unit s
About this output
Twice the event line length divided by wave speed.
- WHS Closure Reduction Factor
-
Unit fraction
About this output
One for instantaneous closure or critical time divided by actual closure time capped at one.
- WHS Surge Magnitude psi
-
Unit psi
About this output
Joukowsky pressure magnitude after the active closure factor.
- WHS Peak Pressure psi
-
Unit psi
About this output
Baseline plus positive surge, or baseline for a negative event.
- WHS Minimum Pressure psi
-
Unit psi
About this output
Baseline less negative surge, or baseline for a positive event.
- WHS Allowable Peak Pressure psi
-
Unit psi
About this output
Entered allowable peak for the controlling event.
- WHS Peak Pressure Utilization
-
Unit fraction
About this output
Controlling peak divided by its entered allowable peak.
- WHS Low Pressure Margin psi
-
Unit psi
About this output
Controlling minimum pressure minus the entered low-pressure floor.
- WHS Screening Action
-
No unit declared
About this output
Calls for detailed transient review even when the simple pressure screen passes.
- WHS Direction Route Used
-
No unit declared
About this output
Pressure-rise or pressure-drop route applied.
- Model Status
-
No unit declared
About this output
OK means simple screens pass; CHECK means an active event fails; NOT VALID identifies intake failure.
Methodology
Purpose and model boundary
Screens eight valve or pump events with routed velocity, elastic or entered wave speed, critical closure time, and Joukowsky pressure change.
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
- velocity basis: a listed route or text value.
- wave speed basis: a listed route or text value.
- closure model: a listed route or text value.
- pressure direction: a listed route or text value.
- base line pressure psi: entered in psi.
- vapor pressure psi: entered in psi.
- fluid specific gravity: entered in relative.
- fluid bulk modulus psi: entered in psi.
- entered wave speed ft s: entered in ft/s.
- velocity change fraction: entered in fraction.
The event grid contains 8 fixed data rows plus one header row with these columns: Include, Event label, Material label, Flow (gal/min), Direct velocity (ft/s), Closure time (s), Line length (ft), Pipe ID (in), Wall thickness (in), Elastic modulus (psi), Restraint factor (fraction), Allowable peak pressure (psi). Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
Event velocity is entered directly or calculated as:
v = (Q/448.831168831169)/[pi(d/12)^2/4]
v is in ft/s, Q is flow (gal/min), and d is pipe inside diameter (in). Fluid mass density is:
rho = 1.93906023339189 SG
rho is in slug/ft^3 and SG is specific gravity.
Wave speed is entered or calculated as:
a = sqrt[(K*144/rho)/(1 + K d/(E t) r)]
a is in ft/s. K and E are fluid bulk modulus and pipe elastic modulus (psi), t is wall thickness (in), and r is the entered restraint factor. Critical closure time is:
t_c = 2L/a
t_c is in seconds and line length L is in ft. Closure factor is 1 for the instantaneous route or:
f_close = min(1,t_c/t_close)
for finite closure.
Joukowsky pressure magnitude is:
DeltaP = rho a v f_DeltaV f_close / 144
DeltaP is in psi, f_DeltaV is the entered velocity-change fraction, and f_close is closure factor. Positive and negative events use:
P_peak = P_base+DeltaP
P_low = P_base-DeltaP
Each active event passes only when peak pressure is not above its entered allowable pressure and low pressure is not below entered vapor pressure.
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
- controlling event: Active event with the highest normalized surge severity.
- controlling wave speed ft s (ft/s): Derived or entered wave speed for the controlling event.
- surge magnitude psi (psi): Joukowsky pressure magnitude after the active closure factor.
- peak pressure psi (psi): Baseline plus positive surge, or baseline for a negative event.
- minimum pressure psi (psi): Baseline less negative surge, or baseline for a positive event.
- screening action: Calls for detailed transient review even when the simple pressure screen passes.
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 |
|---|---|
WHS_Inputs_Valid is FALSE |
NOT VALID: correct surge routes, scalar assumptions, or all eight complete unique event rows |
WHS_Derived_Numerics_Valid_Internal is FALSE |
NOT VALID: wave-speed or surge arithmetic produced a nonfinite result |
WHS_All_Events_Pass_Internal = 0 |
CHECK: one or more active events exceed peak- or low-pressure screening limits |
| None of the preceding conditions applies | OK |
Assumptions and limitations
All shipped default event, material, wall, and allowable values are synthetic illustrative demonstrations.
All event rows, materials, wall properties, and allowables are synthetic editable examples.
Each event is treated independently in a single uniform line.
The finite-closure reduction is a screening approximation capped at the instantaneous result.
This is not a method-of-characteristics transient simulation and does not model branches, reflections, entrained air, cavitation collapse, pump inertia, check-valve dynamics, viscoelasticity, supports, or arrestor selection.
Have a qualified hydraulic professional verify pressure ratings, absolute pressure reference, restraint, device dynamics, and mitigation.
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 71 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- U.S. Department of Energy MEASUR - Primary public context for pump and fluid-system performance analysis. Official U.S. government source; equations are independently implemented.
- USACE Publications - Primary official gateway for hydraulic engineering manuals and transient-analysis context. Official U.S. government source; no manual table or proprietary data is embedded.
- NIST volume units - Official unit-conversion provenance used in flow and pressure arithmetic. 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.