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)
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.
No verification cases match these filters.
Hydrology & SWMM
| Case | What is checked | Details |
|---|---|---|
| X-01 | Drainage 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-02 | HEC-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-03 | Detention 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-04 | Multi-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-01 | Dimensionless rainfall intensity formula: P = 4000 mm, T = 50 yr, t = 5 minQuantity checked: Average rainfall intensity I(50, 5) | Values (Traditional Chinese) |
| H-02 | Dimensionless rainfall intensity formula: P = 4000 mm, T = 50 yr, t = 20 minQuantity checked: Average rainfall intensity I(50, 20) | Values (Traditional Chinese) |
| H-03 | 50-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-04 | SCS 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-05 | SCS triangular hydrograph base time: Tc = 20 minQuantity checked: Base time Tb = 2.67(√Tc + 0.6Tc) | Values (Traditional Chinese) |
| H-06 | TR-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-07 | TR-55 Example 3-1 shallow concentrated flow, segment BCQuantity checked: Travel time Tt (unpaved, s 0.01, L 1400 ft) | Values (Traditional Chinese) |
| H-08 | SCS 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-09 | MSMA rainfall intensity equation: Ibu Pejabat JPS, 20-year ARI, 30 minQuantity checked: Average rainfall intensity i = λT^κ/(d + θ)^η | Values (Traditional Chinese) |
| H-10 | Japanese 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-01 | Building-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-02 | Building-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-03 | Building-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-04 | Detention 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
| Case | What is checked | Details |
|---|---|---|
| C-01 | HDS-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-02 | HDS-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-03 | HDS-5 Design Example 1.3: 54 in RCP, HDS-5 (A.3) submerged inlet controlQuantity checked: Inlet-control headwater HWi | Values (Traditional Chinese) |
| C-04 | HDS-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-05 | HDS-5 Design Example 1.3: 54 in RCP outlet velocity (inlet control)Quantity checked: Outlet velocity Vo (normal depth) | Values (Traditional Chinese) |
| C-06 | HDS-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-07 | HDS-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-01 | USBR Type III stilling basin: basin length ratio (y1 0.322 m, Fr1 6.9, WB 3.0 m)Quantity checked: Basin length ratio L/y2 | Values (Traditional Chinese) |
| R-02 | SAF stilling basin: basin length (y1 0.348 m, Fr1 6.1, WB 3.0 m)Quantity checked: Basin length LB | Values (Traditional Chinese) |
| R-03 | Debris-flow equilibrium concentration (Takahashi equation): θ 15°, φ 35°, γs 2.65Quantity checked: Equilibrium concentration Cd | Values (Traditional Chinese) |
| R-04 | Debris-flow discharge: Cm 0.7, Qp 47 cmsQuantity checked: Debris-flow peak discharge QD = Cm·Qp/(Cm − Cd) | Values (Traditional Chinese) |
| R-05 | Debris-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 QD | Values (Traditional Chinese) |
| P-01 | Project-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 HWi | Values (Traditional Chinese) |
2D flood & coordinates
| Case | What is checked | Details |
|---|---|---|
| X-05 | GeoTIFF/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 mm | Values (Traditional Chinese) |
| FL-01 | Ritter 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-02 | Inclined 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-03 | Inclined 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-01 | Transverse Mercator projection, EPSG worked example: OSGB 1936 / British National Grid, 50°30′N, 0°30′EQuantity checked: Easting E | Values (Traditional Chinese) |
| G-02 | Transverse Mercator projection, GIGS test 5101 part 1 (WGS 84, origin 49°N 2°W): 3°E, 80°NQuantity checked: Northing N | Values (Traditional Chinese) |
Slope stability
| Case | What is checked | Details |
|---|---|---|
| S-01 | ACADS 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 circle | Values (Traditional Chinese) |
| S-02 | Planar wedge (slope height 8 m, slip plane 30°, c 5 kPa, φ 30°, γ 20), Spencer methodQuantity checked: Factor of safety FS | Values (Traditional Chinese) |
| S-03 | Duncan & 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-04 | Duncan & 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-05 | Yamagami, Jiang & Ueno (2000) = Slide2 #54: without piles, fixed circleQuantity checked: Factor of safety FS (simplified Bishop method) | Values (Traditional Chinese) |
| S-06 | Yamagami, 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-07 | Sheahan & 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-08 | Single wedge + one soil nail (H 6 m vertical cut, α 55°, T 150 kN/m, FS-dependent force application), Spencer methodQuantity checked: Factor of safety FS | Values (Traditional Chinese) |
| S-09 | Generalized Hoek–Brown parameters: GSI 50, mi 10, D 0Quantity checked: mb | Values (Traditional Chinese) |
| S-10 | Duncan & 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-11 | Duncan & 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-12 | Newmark rigid block: rectangular pulse (A 0.5 g, T 0.5 s, ky 0.1)Quantity checked: Permanent displacement D | Values (Traditional Chinese) |
| S-13 | Newmark rigid block: Cape Mendocino 1992 Petrolia 000 record (Δt 0.02 s, ac 0.1 g, normal polarity)Quantity checked: Permanent displacement D | Values (Traditional Chinese) |
| S-14 | Jibson (2007) ac/amax regression equation (ac 0.02 g, amax 0.5 g)Quantity checked: Permanent displacement Dn | Values (Traditional Chinese) |
Walls, check dams & foundations
| Case | What is checked | Details |
|---|---|---|
| W-01 | Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: moment at the base of the stemQuantity checked: Design moment Mu | Values (Traditional Chinese) |
| W-02 | Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: shear at the base of the stemQuantity checked: Design shear Vu | Values (Traditional Chinese) |
| W-03 | Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: shear strength of the stemQuantity checked: φVc = 0.75·0.53·√fc′·b·d | Values (Traditional Chinese) |
| W-04 | Soil and Water Conservation Handbook (Taiwan) Appendix 1 cantilever retaining wall example: required reinforcement area for the stemQuantity checked: Required reinforcement area As | Values (Traditional Chinese) |
| W-05 | Soil 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-06 | FHWA MSE Example E4 (steel grid reinforcement, H 25.64 ft) external stability: slidingQuantity checked: Strength I (critical) sliding CDR | Values (Traditional Chinese) |
| W-07 | FHWA MSE Example E4 external stability: bearingQuantity checked: Strength I (maximum) bearing CDR | Values (Traditional Chinese) |
| W-08 | FHWA MSE Example E4 internal stability: maximum tensile force in reinforcement layer 4Quantity checked: Tmax (per 5 ft panel) | Values (Traditional Chinese) |
| W-09 | FHWA 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-10 | FHWA MSE Example E1 internal stability: maximum tensile force in reinforcement layer 2 (Sv 2.0 ft)Quantity checked: TMAX | Values (Traditional Chinese) |
| W-11 | Gabion rock-fill unit weight: γs 26 kN/m³, porosity 35%Quantity checked: Gabion unit weight γg | Values (Traditional Chinese) |
| W-12 | USFS gabion wall Example 4D (simplified trapezoidal section, H 18 ft, β = φ = 38°): active earth pressureQuantity checked: Resultant active earth force PA | Values (Traditional Chinese) |
| W-13 | USFS gabion wall Example 4D: factor of safety against overturningQuantity checked: Overturning FS | Values (Traditional Chinese) |
| K-01 | Check 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)/ΣH | Values (Traditional Chinese) |
| K-02 | Check 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 sliding | Values (Traditional Chinese) |
| K-03 | Check dam design example, Case 4: filled with sediment, earthquake, ordinary flowQuantity checked: Factor of safety against sliding | Values (Traditional Chinese) |
| K-04 | Check 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-05 | Check 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-01 | Bearing capacity factors: φ = 30°Quantity checked: Nγ (Vesic) | Values (Traditional Chinese) |
| F-02 | Bearing capacity factors: φ = 30°Quantity checked: Nc | Values (Traditional Chinese) |
| P-02 | Project-file check dam ([[swc.check_dams]] + body): Handbook Appendix 4.1 design example, Case 1Quantity checked: Total horizontal force ΣH | Values (Traditional Chinese) |
| I-01 | Liquefaction 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 FL | Values (Traditional Chinese) |
| I-02 | Laterally 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 kH | Values (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⁻¹⁶.