Checked on every build

Every engine against a reference.

A surge study is only worth the trust you can put in it. Each SurgeSpace engine is compared with an independent reference — EPANET 2.2, published benchmarks, closed-form theory, separate ODE solvers — and the comparisons run in continuous integration on every change.

0.05 %
Joukowsky rise
wave engine against a·ΔV/g
exact
Benchmark Tnet0
a published transient benchmark network
0.012 m
Steady heads
worst difference from EPANET 2.2 on Net3, KY4 and Net6
0.0004 m
Schedules read back
EPANET Net3 written as Excel schedules and rebuilt
iSurge and steady state

The hydraulics.

CheckReferenceResult
Joukowsky rise, wave period, line packingClosed formJoukowsky within 0.05 %
Transient benchmarks Tnet0 and Tnet3Published benchmark resultsTnet0 exact; Tnet3 92 % within 3 m
Transient, Net3 valve closureTSNetSteady state and first waves match
Steady heads and flows (Net3, KY4, Net6)EPANET 2.2Worst 0.012 m
PRV, PSV, FCV, PBV, GPV, TCVEPANET 2.2Heads 0.003 m, flows 0.01 L/s
Check-valve and air-valve slama·v/gAs theory
Surge tank mass oscillationJaeger's formula; wave engineWithin 5 %; engines agree within 1 %
Differential surge tankSciPy ODE integration (independent code)Upsurge equal to 0.01 %
Motor start, direct on lineSciPy ODE integrationRigid 0.03 %, wave 1.2 %
Pipe force on a straight pipeρ·a·V·AWithin 12 % (line packing)
Rigid-column sparse solveDense solveIdentical; 3,000 pipes at about 0.1 s a step
Built-in examplesStored baseline880 values identical
iiDaily operation and water quality

Against EPANET 2.2.

CheckReferenceResult
Extended period, Net1, Net2, Net3EPANET 2.2Heads within 0.04 m
Rule-based controls (Net1, four rules)EPANET 2.2Heads within 0.008 m
Emitters (leakage), Net1 over 24 hEPANET 2.2Heads 0.008 m, demands 0.003 L/s
Pressure-driven demand, Net1 over 24 hEPANET 2.2Heads 0.007 m, demands 0.005 L/s
Chlorine, Net1EPANET 2.2Within 0.003 mg/L
Water age, Net1, Net2, Net3EPANET 2.295 % within 0.2 h
CalibrationSynthetic field dataRecovers roughness ×3 and demand ×1.2
iiiReading documents

The model from your drawings, checked too.

KY4 — a real distribution network of 959 junctions and 1,156 pipes with 2,812 bends, 2 pumps, 4 tanks and a reservoir — was drawn as a CAD plan in feet, with level, size and water-level texts, symbols and clutter. SurgeSpace read it back and was compared item by item with the network it was drawn from.

CheckReferenceResult
Nodes and pipes found between the right nodesKY4 source network99.8 % and 99.5 %
Levels, sizes, lengths along the bendsKY4 source network99.8 % within 1 cm; 99.5 %; 99.8 %
Steady heads of the model read from the planAn independently built modelMedian 0.03 m; 95 % within 0.29 m
Network from schedulesEPANET Net3 as Excel schedulesHeads within 0.0004 m
Pump curve digitised by handA published curve: 2,000 gpm at 80 ftRead as 79.8 ft
Pump curve fitted to pointsAn exact quadraticRecovered exactly

The rest of the KY4 differences are where pipes in the source data pass within a metre of a junction they do not join, which a drawing cannot tell apart. Methods and the full list: Theory and validation.

ivExchange

Files other programs trust.

CheckReferenceResult
DXF exportezdxf (independent reader)No audit errors
QGIS plug-inQGIS 3.34Export, import and results layers
UTM conversionPROJWithin 0.2 mm
EPANET .inp round tripEPANET 2.2Read and written, with vertices