HyGeoWorks

Benchmarks: 69 verification cases for the calculation core

The calculation core is checked against published examples, other software, analytical solutions and EPA SWMM 5.2.4. Each case lists its reference value and source, the computed value, the tolerance and why that tolerance was chosen. All 69 cases pass. Handbook misprints and known limits are listed rather than hidden. Run hydro verify-benchmarks to repeat the checks on your own computer.

69 / 69

cases pass

Published examples 51 · Other software 9 · Analytical solutions 7 · Independent implementations 2

0.02%

largest peak flow difference against EPA SWMM 5.2.4 (drainage network, free-surface flow)

Nash-Sutcliffe efficiency at least 0.9997; HEC-22 inlets: 142 cases (128 on grade, 14 in sag), largest difference 0.019%; detention pond routing: peak outflow +0.37%

0.005

tolerance on the factor of safety against Slide2

Anchors, micropiles, soil nails and five-layer reinforcement

4.9 × 10⁻¹⁶

largest relative difference between the online and desktop cores

376 cases and 101,613 values compared on 2026-11-13

Method

Tolerances with a stated basis

Each case states why its tolerance was chosen: half a unit of the last printed digit in the source (a value printed to 0.01 gets ±0.005), the reading accuracy of a chart (for example ±10% for the FHWA HDS-5 nomographs, ±0.03 m for IOGP GIGS), or a strict ΔFS of 0.005 against Slide2.

Misprints shown side by side

Where a handbook contains a misprint or a rounding error in an intermediate value (11 cases), the table keeps the value as printed next to the corrected target. Reference values are not altered to hide a difference.

Repeatable

All inputs are fixed in the source code. The checks use no hidden files, network access, random numbers or thread timing, so every run gives the same report (Markdown, Excel and JSON).

Cross-check with EPA SWMM

Outflow control and detention modules also export a standard EPA SWMM model, so the same case can be run in SWMM and compared.

Case groups

  • Hydrology
  • Culverts
  • Hydraulics (energy dissipation, debris flow)
  • Detention and on-site retention
  • Slope stability
  • Retaining walls, MSE walls and gabions
  • Check dams
  • Bearing capacity
  • 2D flood
  • Coordinate transformation
  • Project workflow (embedded project files run end to end)
  • Liquefaction and piles (independent implementations, not from literature)

Published example or tabulated value · Other software's verification example · Analytical solution · Independent implementation (not from literature)

Case-by-case tables with references, computed values and tolerances (currently in Traditional Chinese)

hydro verify-benchmarks --include-slow

All 69 cases in English (references and sources, tolerances, computed values and results) are published as open data (CC BY 4.0) on GitHub: github.com/hygeoworks/hydrostudio-benchmarks

Case index

Every case and external comparison, grouped as on the detailed page. Reference values, computed values and tolerances for each case are on the Traditional Chinese page (link on each row) and in the open data on GitHub.

Hydrology & SWMM

CaseWhat is checkedDetails
X-01Drainage network, dynamic wave: S1 free-surface flow, S2 pressurized flow, S3 backwater from a fixed outfall stage, S4 looped network, S5 tabular storage unit + orifice + weir, S6 pump station, S7 control rules + outlet structures, S8 Type 3 pump + rule-based start/stop; 16 sets in totalCompared with: EPA SWMM 5.2.4 (swmm-toolkit, DYNWAVE, SLOT, 1 s time step)FULL: S1 peak flow difference ≤ 0.02%, manhole depth difference ≤ 0.04%, NSE ≥ 0.9997; S3 ≤ 0.13%, ≤ 0.21%; S4 ≤ 2.25%, ≤ 2.06%; S2 flow difference ≤ 2.9%, manhole depth higher in this program by 5.3%/9.3% (SWMM includes the Sjoberg slot area in the flow area; this program does not). PARTIAL/NONE: flow ≤ 5.0%, depth ≤ 6.4%. S5 ≤ 0.03% (NSE 1.0000); S6 flow ≤ 2.06%, depth ≤ 0.50%, pump starts 1 = 1; S7 flow ≤ 4.47%, depth ≤ 3.73%, gate openings 0.30–1.00 identical to SWMM; S8 flow ≤ 5.1%, pump starts 10 = 10; at the instant of pump start-up (< 1 minute) the surge depth at J2 is +40% (difference in slot storage)Values (Traditional Chinese)
X-02HEC-22 inlet interception: on grade, 8 types × 2 streets × 2 longitudinal slopes × 4 flows; in sag, 7 types × 2 streetsCompared with: EPA SWMM 5.2.4 (STREET cross-section + INLETS)On grade, 128 sets: maximum relative difference 0.019%; in sag, 14 sets: 0.000%Values (Traditional Chinese)
X-03Detention pond level-pool routing (same inflow, same pond geometry and outlet works); pond defined by a depth–area table (200 → 4000 m²)Compared with: EPA SWMM 5.2.4 (swmm-toolkit, dynamic wave)Maximum depth +0.51%, peak outflow +0.37%; both .inp files run without errors, continuity error ≈ 0%. Pond defined by a depth–area table: maximum depth +0.25%, peak outflow −0.39%Values (Traditional Chinese)
X-04Multi-catchment topological routing (demonstration network with series and parallel connections + overflow paths)Compared with: EPA SWMM 5.2.4Maximum depths of the three ponds +0.00%, +0.02%, −0.01%; peak at the network outlet +0.08%; continuity error 0.000%Values (Traditional Chinese)
H-01Dimensionless rainfall intensity formula: P = 4000 mm, T = 50 yr, t = 5 minQuantity checked: Average rainfall intensity I(50, 5)Values (Traditional Chinese)
H-02Dimensionless rainfall intensity formula: P = 4000 mm, T = 50 yr, t = 20 minQuantity checked: Average rainfall intensity I(50, 20)Values (Traditional Chinese)
H-0350-year Horner coefficient expanded from the dimensionless rainfall intensity formula: P = 3000 mmQuantity checked: Horner coefficient a (I = a/(t + 55)^c)Values (Traditional Chinese)
H-04SCS triangular hydrograph base time: Tc = 5 minQuantity checked: Base time Tb = 2.67(√Tc + 0.6Tc) (1-hour lower limit not applied)Values (Traditional Chinese)
H-05SCS triangular hydrograph base time: Tc = 20 minQuantity checked: Base time Tb = 2.67(√Tc + 0.6Tc)Values (Traditional Chinese)
H-06TR-55 Example 3-1 sheet flow, segment ABQuantity checked: Travel time Tt (dense grass n 0.24, L 100 ft, P2 3.6 in, s 0.01)Values (Traditional Chinese)
H-07TR-55 Example 3-1 shallow concentrated flow, segment BCQuantity checked: Travel time Tt (unpaved, s 0.01, L 1400 ft)Values (Traditional Chinese)
H-08SCS Type II 24-hour rainfall distribution: maximum 1-hour rainfall ratioQuantity checked: Maximum 1 h cumulative rainfall ratio (built-in HDS-2 Table 6.5, 0.5 h interval)Values (Traditional Chinese)
H-09MSMA rainfall intensity equation: Ibu Pejabat JPS, 20-year ARI, 30 minQuantity checked: Average rainfall intensity i = λT^κ/(d + θ)^ηValues (Traditional Chinese)
H-10Japanese Cleveland-type rainfall intensity equation: block 1 of the target rainfall table (10 min)Quantity checked: Intensity converted from the maximum 10-min rainfall increment (I = 5361.6/(t^0.831 + 25.995))Values (Traditional Chinese)
D-01Building-site water retention index worked example: new construction of ○○ Elementary School, green-space water retentionQuantity checked: Green-space water retention volume Q1 (A1 = 2957.12 m², f = 10⁻⁵ m/s, t = 86,400 s)Values (Traditional Chinese)
D-02Building-site water retention index worked example: water retention of the original siteQuantity checked: Original-site water retention volume Q0 (A0 = 7803.68 m²)Values (Traditional Chinese)
D-03Building-site water retention index worked example: water retention indexQuantity checked: Water retention index λ = ΣQi/Q0 (the source judges 0.47 < λc 0.5, non-compliant)Values (Traditional Chinese)
D-04Detention pond defined by a depth–area table: frustum volume within an interval (area 100 → 400 m², depth 0 → 2 m), at depth 1 mQuantity checked: Storage volume V(1 m)Values (Traditional Chinese)

Culverts, energy dissipation & debris flow

CaseWhat is checkedDetails
C-01HDS-5 Design Example 1.3: 54 in RCP, groove end with headwall, HY-8 polynomial inlet controlQuantity checked: Inlet-control headwater HWi (Q 200 cfs, S 0.01)Values (Traditional Chinese)
C-02HDS-5 Design Example 1.4: 5 ft × 5 ft square-edge box culvert, HY-8 polynomial inlet controlQuantity checked: Inlet-control headwater HWi (Q 300 cfs, S 0.02)Values (Traditional Chinese)
C-03HDS-5 Design Example 1.3: 54 in RCP, HDS-5 (A.3) submerged inlet controlQuantity checked: Inlet-control headwater HWiValues (Traditional Chinese)
C-04HDS-5 Design Example 1.3: 54 in RCP outlet control (ke 0.2, n 0.012, L 200 ft)Quantity checked: Full-flow head loss H (HDS-5 Eq. 3.5)Values (Traditional Chinese)
C-05HDS-5 Design Example 1.3: 54 in RCP outlet velocity (inlet control)Quantity checked: Outlet velocity Vo (normal depth)Values (Traditional Chinese)
C-06HDS-5 Chart 1A = Highway Drainage Design Code (Taiwan) Appendix N.1: D 1050 mm circular pipe, scale 1Quantity checked: HW/D (Q 3.40 m³/s, S 0.02, HDS-5 (A.3))Values (Traditional Chinese)
C-07HDS-5 Chart 8A = Highway Drainage Design Code (Taiwan) Appendix N.2: 1500 × 600 mm box culvert, scale 1Quantity checked: HW/D (Q 2.12 m³/s, S 0.02, HDS-5 (A.3))Values (Traditional Chinese)
R-01USBR Type III stilling basin: basin length ratio (y1 0.322 m, Fr1 6.9, WB 3.0 m)Quantity checked: Basin length ratio L/y2Values (Traditional Chinese)
R-02SAF stilling basin: basin length (y1 0.348 m, Fr1 6.1, WB 3.0 m)Quantity checked: Basin length LBValues (Traditional Chinese)
R-03Debris-flow equilibrium concentration (Takahashi equation): θ 15°, φ 35°, γs 2.65Quantity checked: Equilibrium concentration CdValues (Traditional Chinese)
R-04Debris-flow discharge: Cm 0.7, Qp 47 cmsQuantity checked: Debris-flow peak discharge QD = Cm·Qp/(Cm − Cd)Values (Traditional Chinese)
R-05Debris-flow design example (original riverbed): So 0.268, φ 35°, γs 2.6, Cm 0.68, Qp 40 cms, B 25 mQuantity checked: Debris-flow peak discharge QDValues (Traditional Chinese)
P-01Project-file culvert ([[swc.culverts]]): the 5 ft × 5 ft square-edge box culvert of HDS-5 Design Example 1.4, entered in SI unitsQuantity checked: Inlet-control headwater HWiValues (Traditional Chinese)

2D flood & coordinates

CaseWhat is checkedDetails
X-05GeoTIFF/Shapefile two-way read interoperability, latitude/longitude to TM2 conversion, resampling of latitude/longitude DEMsCompared with: GDAL 3.12 (rasterio, pyogrio), pyshp, PROJAll 42 items pass; latitude/longitude to TM2 differs from PROJ by 0.007 mm; latitude/longitude DEM resampling differs from GDAL bilinear by ≤ 3.5 mmValues (Traditional Chinese)
FL-01Ritter dry-bed dam break (h0 1 m, dam at x 200 m, 400 × 2 cells, Δx 1 m, t = 20 s, frictionless, second order)Quantity checked: Relative L1 error of the depth profile (against the analytical solution h = (2c₀ − ξ)²/(9g))Values (Traditional Chinese)
FL-02Inclined plane at equilibrium under steady rainfall (length 200 m, width 10 m, slope 0.01, n 0.03, 50 mm/hr), 2-hour simulationQuantity checked: Outflow at the downstream end (at equilibrium = rainfall rate × area)Values (Traditional Chinese)
FL-03Inclined plane at equilibrium under steady rainfall: depth at x = 102.5 mQuantity checked: Equilibrium depth (kinematic wave solution h = (i·x·n/√S)^0.6)Values (Traditional Chinese)
G-01Transverse Mercator projection, EPSG worked example: OSGB 1936 / British National Grid, 50°30′N, 0°30′EQuantity checked: Easting EValues (Traditional Chinese)
G-02Transverse Mercator projection, GIGS test 5101 part 1 (WGS 84, origin 49°N 2°W): 3°E, 80°NQuantity checked: Northing NValues (Traditional Chinese)

Slope stability

CaseWhat is checkedDetails
S-01ACADS verification example 1(a): homogeneous 2:1 slope (height 10 m, c′ 3 kPa, φ′ 19.6°, γ 20 kN/m³), simplified Bishop method, grid searchQuantity checked: Factor of safety FS of the critical circleValues (Traditional Chinese)
S-02Planar wedge (slope height 8 m, slip plane 30°, c 5 kPa, φ 30°, γ 20), Spencer methodQuantity checked: Factor of safety FSValues (Traditional Chinese)
S-03Duncan & Wright Figure 6.34 = Slide2 #85: φ = 0, single horizontal support 9,000 lb/ft (passive), fixed circle PQuantity checked: Factor of safety FS (simplified Bishop method)Values (Traditional Chinese)
S-04Duncan & Wright Figure 6.34 = Slide2 #85: φ = 0, single horizontal support 9,000 lb/ft (active), fixed circle PQuantity checked: Factor of safety FS (simplified Bishop method)Values (Traditional Chinese)
S-05Yamagami, Jiang & Ueno (2000) = Slide2 #54: without piles, fixed circleQuantity checked: Factor of safety FS (simplified Bishop method)Values (Traditional Chinese)
S-06Yamagami, Jiang & Ueno (2000) = Slide2 #54: single row of micropiles (shear force 10.7 kN, spacing 1 m, passive), fixed circleQuantity checked: Factor of safety FS (simplified Bishop method)Values (Traditional Chinese)
S-07Sheahan & Ho (2003) Amherst soil-nail test wall = Slide2 #47: two rows of passive soil nails, φ = 0, planar wedgeQuantity checked: Factor of safety FS (simplified Janbu method)Values (Traditional Chinese)
S-08Single wedge + one soil nail (H 6 m vertical cut, α 55°, T 150 kN/m, FS-dependent force application), Spencer methodQuantity checked: Factor of safety FSValues (Traditional Chinese)
S-09Generalized Hoek–Brown parameters: GSI 50, mi 10, D 0Quantity checked: mbValues (Traditional Chinese)
S-10Duncan & Wright Figure 7.28 = Slide2 #86: five reinforcement layers at 800 lb/ft, grid search of circles through the toe (33 × 41)Quantity checked: Factor of safety FS of the critical circle (simplified Bishop method)Values (Traditional Chinese)
S-11Duncan & Wright Figure 7.28 = Slide2 #86: noncircular optimization starting from the critical circle of the Spencer grid searchQuantity checked: Factor of safety FS of the critical noncircular slip surface (Spencer method)Values (Traditional Chinese)
S-12Newmark rigid block: rectangular pulse (A 0.5 g, T 0.5 s, ky 0.1)Quantity checked: Permanent displacement DValues (Traditional Chinese)
S-13Newmark rigid block: Cape Mendocino 1992 Petrolia 000 record (Δt 0.02 s, ac 0.1 g, normal polarity)Quantity checked: Permanent displacement DValues (Traditional Chinese)
S-14Jibson (2007) ac/amax regression equation (ac 0.02 g, amax 0.5 g)Quantity checked: Permanent displacement DnValues (Traditional Chinese)

Walls, check dams & foundations

CaseWhat is checkedDetails
W-01Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: moment at the base of the stemQuantity checked: Design moment MuValues (Traditional Chinese)
W-02Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: shear at the base of the stemQuantity checked: Design shear VuValues (Traditional Chinese)
W-03Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: shear strength of the stemQuantity checked: φVc = 0.75·0.53·√fc′·b·dValues (Traditional Chinese)
W-04Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: required reinforcement area for the stemQuantity checked: Required reinforcement area AsValues (Traditional Chinese)
W-05Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: overturning moment in the stability analysisQuantity checked: Overturning moment Mo (surcharge lateral pressure 7.98 t/m @ 3.1 m, active earth pressure 9.89 t/m @ 2.067 m)Values (Traditional Chinese)
W-06FHWA MSE Example E4 (steel grid reinforcement, H 25.64 ft) external stability: slidingQuantity checked: Strength I (critical) sliding CDRValues (Traditional Chinese)
W-07FHWA MSE Example E4 external stability: bearingQuantity checked: Strength I (maximum) bearing CDRValues (Traditional Chinese)
W-08FHWA MSE Example E4 internal stability: maximum tensile force in reinforcement layer 4Quantity checked: Tmax (per 5 ft panel)Values (Traditional Chinese)
W-09FHWA MSE Example E1 (geogrid, broken backslope) external stability: slidingQuantity checked: Sliding CDR for the critical combination (Pd 32.15, Rr 36.0 kip/ft)Values (Traditional Chinese)
W-10FHWA MSE Example E1 internal stability: maximum tensile force in reinforcement layer 2 (Sv 2.0 ft)Quantity checked: TMAXValues (Traditional Chinese)
W-11Gabion rock-fill unit weight: γs 26 kN/m³, porosity 35%Quantity checked: Gabion unit weight γgValues (Traditional Chinese)
W-12USFS gabion wall Example 4D (simplified trapezoidal section, H 18 ft, β = φ = 38°): active earth pressureQuantity checked: Resultant active earth force PAValues (Traditional Chinese)
W-13USFS gabion wall Example 4D: factor of safety against overturningQuantity checked: Overturning FSValues (Traditional Chinese)
K-01Check dam design example, Case 1: not filled with sediment, Hm 8.12 m, earthquake, ordinary flowQuantity checked: Factor of safety against sliding (f1·ΣV + Pp)/ΣHValues (Traditional Chinese)
K-02Check dam design example, Case 3: filled with sediment, maximum flow (h 2.0, hc 1.38, hck 1.0)Quantity checked: Factor of safety against slidingValues (Traditional Chinese)
K-03Check dam design example, Case 4: filled with sediment, earthquake, ordinary flowQuantity checked: Factor of safety against slidingValues (Traditional Chinese)
K-04Check dam design example: seismic active earth pressure coefficient (φ 35°, δ 21.8°, Kh 0.22)Quantity checked: Kae (standard Mononobe–Okabe, inclined wall face and sediment surface)Values (Traditional Chinese)
K-05Check dam design example: static active earth pressure coefficient (φ 35°, δ 21.8°, α 10.13°, ε̄ 38.66°)Quantity checked: Kac (Eq. 2.1.13)Values (Traditional Chinese)
F-01Bearing capacity factors: φ = 30°Quantity checked: Nγ (Vesic)Values (Traditional Chinese)
F-02Bearing capacity factors: φ = 30°Quantity checked: NcValues (Traditional Chinese)
P-02Project-file check dam ([[swc.check_dams]] + body): Handbook Appendix 4.1 design example, Case 1Quantity checked: Total horizontal force ΣHValues (Traditional Chinese)
I-01Liquefaction potential, HBF method (R4 L-1: N 10, ER 70%, FC 15%, z 6 m, groundwater level 2 m, A 0.24 g, Mw 7.3)Quantity checked: Factor of safety against liquefaction FLValues (Traditional Chinese)
I-02Laterally loaded pile (Chang's method, R4 C-1: D 1 m, Ec 2.5×10⁶ tf/m², N 10, L 30 m, free head)Quantity checked: Coefficient of horizontal subgrade reaction kHValues (Traditional Chinese)

Frequently asked questions

Who ran these checks?

HyGeoWorks, with the program itself. The reference values come from the cited publications, software verification examples and analytical solutions; the page does not claim third-party certification.

Can I repeat them?

Yes. Run hydro verify-benchmarks on a computer with HydroStudio installed; add --include-slow for the long cases. The trial can also produce this report.

Do the online calculators give the same results as the desktop edition?

They use the same Rust source code compiled to WebAssembly. On 2026-11-13, 376 cases and 101,613 values were compared and the largest relative difference was 4.9 × 10⁻¹⁶.