Extran1 and Extran2 from the Extran Manual for AI, GitHub, SWMM5, used in ICM SWMM and InfoWorks and SWMM5 3rd Party Tests

Autodesk Water Technologist for Storm Sewer and Flood | Expert in ICM InfoWorks ICM SWMM/Ruby | 18 Years at Innovyze/Autodesk | 52 Years with EPASWMM TAC for CIMM.ORG SWMM5+

April 7, 2025

This is a story about two inp files. It shows the continuity in stormwater modeling from 1980 to 2025 onwards. It is about Extran1 (free outfall) and Extran 2 (fixed backwater with a tide gate) from the 1981 Extran Manual. This compact test case, born in the era of punch cards, has validated SWMM across decades—from SWMM3 to SWMM5—and remains a benchmark in 2025. This article explores its history, mechanics, and enduring value for hydraulic engineers.

Why would you be interested in the file? You are a student of SWMM history, and this file has been important since 1981. You want to make a new version of SWMM and need a file from the past that you can compare. You are testing new versions of SWMM and wonder why some files are very small and what they mean.

Origin and Purpose

This test file is an important benchmark in stormwater modeling development, originating in the 1981 EXTRAN 3 manual (CDM/CDM Smith). Its primary function was validating side outlet orifice hydraulics within network simulations. The reason for this blog or article is "Sed fugit interea, fugit irreparabile tempus" or I wanted to document how I learned about this file and why it is still used today by the USEPA and many software vendors (Autodesk is one).

Why does this file matter? Extran1 and Extran2 have been cornerstone files in SWMM’s development, ensuring continuity across versions. I alone have run it hundreds of times for decades. For example, in 1981, it and the Extran 3 manual showed the general mainframe user of SWMM3 how Extran worked. In 1988, it validated the SWMM3-to-SWMM4 transition; in 2006, it verified SWMM5 algorithms by comparing it to SWMM4. Now, it is part of the test suite for newer versions of SWMM5 and used by many vendors using the SWMM5 or part of the SWMM5 engine.

What is a Tide Gate in SWMM5?

In SWMM5 (Storm Water Management Model), a tide gate is a specialized hydraulic control feature typically implemented at an outfall to manage flow between a stormwater or sewer system and a receiving body of water, such as a river or ocean, where tidal influences are present. It is represented in the model as a gate associated with an outfall node, as seen in the "Example 2 of Extran Manual - Tide Gate" input file, where the outfall "10208" is defined with a fixed elevation of 89.9 ft, a stage of 94.4 ft, and a "YES" setting for the gated property. The tide gate allows outflow from the system when the water level upstream exceeds the downstream tidal level, preventing backflow into the system during high tide conditions. In the model, this is further supported by features like flap gates on conduits (e.g., conduit "1030" in the example), which act as one-way valves to enhance flow control.

The tide gate allows outflow from the system when the water level upstream exceeds the downstream tidal level, preventing backflow into the system during high tide conditions.

Development Continuity for SWMM using this file

The file served as a quality assurance test file throughout SWMM's evolutionary progression:

• SWMM3 → SWMM4 transition validation,` 1981
• SWMM4 → SWMM5 algorithm verification, 1988
• Cross-platform computational consistency assessment - vendors
• Used currently by the USEPA as part of the suite of test files on GitHub and is part of most (all?) software vendors for SWMM5 and even SWMM4 (XPSWMM). It is also part of the QA/QC test files in the 2006 report STORM WATER MANAGEMENT MODEL QUALITY ASSURANCE REPORT: Dynamic Wave Flow Routing By Lewis A. Rossman Water Supply and Water Resources Division National Risk Management Research Laboratory, Cincinnati, OH 45268
• It is also—and I just managed to notice this - a part of the download for the PDF as part of the SWMM5 download These ZIP files, archived in 2006, contain test cases still used today, available via EPA’s GitHub

STORM WATER MANAGEMENT MODEL QUALITY ASSURANCE REPORT: Dynamic Wave Flow Routing By Lewis A. Rossman Water Supply and Water Resources Division National Risk Management Research Laboratory, Cincinnati, OH 45268

Contemporary Applications in 2025

This test case has relevance across modern hydraulic modeling platforms:

• Implemented in InfoWorks ICM SWMM network daily build validation protocols, It is also used in Autodesk Water InfoDrainage software.
• Integrated into EPA's GitHub repository as a standardized test model
• Functions as a cross-platform verification instrument for hydraulic solver validation

Why it is Good

Extran1 and Extran2 from the Extran Manual was an excellent test model for SWMM back in the early 1980s precisely because it combined several challenging hydraulic elements (multiple inflows, free outfall or a tide gate with fixed backwater, and dynamic wave routing) into a relatively compact network that could be run on what were then very limited computer resources (we used punch cards or terminals and a mainframe computer at UF). At the time, personal computers were not invented for SWMM3, and while they existed by the time of SWMM4, they were slow, and large-memory mainframes were not readily accessible to most modelers, so every model had to be small enough to fit into limited RAM and run in a feasible amount of CPU time. Yet this example still demonstrated SWMM’s powerful capability to capture unsteady flow conditions—like surcharging, backwater effects, and control structures—in one integrated simulation.

The inclusion of a free outfall or a tide gate, various pipe shapes, and multiple inflow hydrographs showcased SWMM’s flexibility to handle both standard conveyance links and special hydraulic controls, confirming that dynamic wave routing could be effectively computed given the technology of the day. Overall, it illustrated that, despite modest hardware and software constraints, SWMM was already advanced enough to handle complex urban drainage systems, laying the groundwork for today’s much larger and more detailed models.

Derived from the 1981 Extran Manual, these seven test cases remain benchmarks and were used in SWMM4, SWMM5. There are what I call the Seven Classic SWMM5 Hydraulics Test Files from Extran3 in 1981

1. Base Pipe System
2. Tide Gate outfall
3. Sump Orifice Diversion
4. Weir Diversion
5. Storage Facility with Side Outlet Orifice
6. Off-Line Pump Station
7. In-Line Pump Station

Seven Classic SWMM5 Hydraulics Test Files from Extran3 in 1981 later used in SWMM4 and SWMM5 Testing

Example 7 of Extran Manual - Type2 Pump

SWMM5 QA/QC Manual Compares these files to SWMM4 Results

This rigorous validation ensured SWMM5’s reliability as it was rewritten C code based on the SWMM4 Fortran code.

Extran 1981 Manual. Beyond its technical value, the 1981 manual holds personal significance as my entry into Extran modeling.

Summary of the Extran2.inp created with AI Help.

The provided SWMM5 input file models a drainage system with a tide gate, based on Example 2 from the EXTRAN manual. Below is a detailed breakdown of its components and configuration:

## Model Configuration

- Simulation period: January 1, 2002 (00:00:00 to 08:00:00)

- Flow units: CFS (cubic feet per second)

- Routing method: Dynamic Wave (DYNWAVE) for pressurized pipe flow and backwater effects

- Infiltration method: Horton equation

- Reporting interval: 15 minutes

## Network Components

Junctions (9 nodes):

- Elevations range from 89.9 ft (outfall) to 128.2 ft (node 81009)

- Example: Node 82309 has invert elevation 112.3 ft and max depth 42.7 ft

Conduits (9 links):

- Lengths range from 300 ft to 5,100 ft

- Roughness coefficients: 0.015-0.034 (Manning's n)

- Example: Conduit 8040:

- 1,800 ft long circular pipe (4 ft diameter)

- Connects nodes 80408 (124.6 ft) to 80608 (118.3 ft)

Special Elements:

- Tide gate: Outfall 10208 uses fixed stage (94.4 ft) with flap gate

- Trapezoidal channels: Links 1030/1630 have 9ft base width and 3:1 side slopes

Inflows:

Three nodal hydrographs with triangular patterns:

- Node 80408: 45 CFS peak (3-hour duration)

- Node 81009: 50 CFS peak (3-hour duration)

- Node 82309: 40 CFS peak (3-hour duration)

## System Characteristics

- Tidal influence: Fixed-stage outfall with anti-backflow gate

- Dynamic routing: Accounts for pressure flow and surcharging

- Simplified hydrology: Constant 0.0 evaporation rate (no ET losses)

- No water quality parameters: Focused on hydraulic performance

This model is designed to test tide gate functionality under multiple inflow scenarios, using EXTRAN-based network configurations. The combination of circular pipes and trapezoidal channels with dynamic wave routing suggests an emphasis on accurate pressure/surcharge modeling[1][2][7].

Citations:

[1] https://help2.innovyze.com/infoworksicm/Content/HTML/ICM_ILCM/SWMM5_Conversion_Notes%20(SWMM).htm

[2] https://www.openswmm.org/Topic/3400/swmm5-version-of-extran-examples

[3] https://www.epa.gov/sites/default/files/2019-02/documents/epaswmm5_1_manual_master_8-2-15.pdf

[4] https://www.openswmm.org/Topic/29958/understanding-swmm-summary-output

[5] https://swmm5.org/2017/08/14/epa-swmm5-tutorial-with-images-for-swmm-5-1-012/

[6] https://swmm2000.com/forum/topics/swmm-5-example-files

[7] https://www.epa.gov/water-research/storm-water-management-model-swmm

[8] https://nepis.epa.gov/Exe/ZyPURL.cgi?Dockey=P10145M6.TXT

[9] https://www.openswmm.org/Topic/2636/swmm5-average-flow-time-patterns

[10] https://www.epa.gov/system/files/documents/2022-04/swmm-users-manual-version-5.2.pdf

[11] https://swmm5.org/2016/09/07/how-do-you-interpret-the-flow-and-hydrology-summary-tables-in-swmm-5-1/

[12] https://help.innovyze.com/space/infoswmm/17597955

[13] https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume1_Hydrology_P100NYRA.pdf

[14] https://www.pcswmm.com/Downloads/USEPASWMM

[15] https://www.swmm456.com/2024/04/the-two-main-reference-manuals-for.html

[16] https://www.youtube.com/watch?v=H1XhSLI7-bM

[17] https://www.openswmm.org/Topic/3994/swmm-5-applications-manual-now-available

How does this look in ICM InfoWorks and ICM SWMM?

You can import the Extran5.inp file into both ICM SWMM and ICM InfoWorks networks. For true fidelity you can also convert the ICM SWMM networks from the imported Extran5.inp file internally to an ICM InfoWorks network.

Extran1 (free outfall) and Extran 2 (fixed backwater with a tide gate) both in ICM SWMM networks and ICM InfoWorks Networks

Full Reference for the 1981 version of Extran for SWMM3

Full Reference for the 1981 version of Extran for SWMM3

EPA-600/2-84-109b
Final Draft, November 1981
Sixth Printing, July 1983

STORMWATER MANAGEMENT MODEL USER'S MANUAL VERSION III Addendum I EXTRAN
by
Larry A. Roesner
Robert P. Shubinski
John A. Aldrich
Camp Dresser & McKee Inc.
Annandale, Virginia 22003

EPA COOPERATIVE AGREEMENT NO. CR8O5664
Project Officer
Douglas C. Ammon
Storm and Combined Sewer Section
Wastewater Research Division
Municipal Environmental Research Laboratory
Cincinnati, Ohio 45268

Extran 6.inp File as an example for the future. This also reminds me of the original 1981 Extran manual which had both the inp files and model output in the printed pages.

[TITLE]
;;Project Title/Notes
Example 2 of Extran Manual -
Tide Gate

[OPTIONS]
;;Option Value
FLOW_UNITS CFS
INFILTRATION HORTON
FLOW_ROUTING DYNWAVE
LINK_OFFSETS DEPTH
MIN_SLOPE 0
ALLOW_PONDING NO
SKIP_STEADY_STATE NO

START_DATE 01/01/2002
START_TIME 00:00:00
REPORT_START_DATE 01/01/2002
REPORT_START_TIME 00:00:00
END_DATE 01/01/2002
END_TIME 08:00:00
SWEEP_START 01/01
SWEEP_END 12/31
DRY_DAYS 0
REPORT_STEP 00:15:00
WET_STEP 00:15:00
DRY_STEP 01:00:00
ROUTING_STEP 0:00:20

INERTIAL_DAMPING NONE
NORMAL_FLOW_LIMITED BOTH
FORCE_MAIN_EQUATION H-W
VARIABLE_STEP 0.00
LENGTHENING_STEP 0
MIN_SURFAREA 0
MAX_TRIALS 0
HEAD_TOLERANCE 0
SYS_FLOW_TOL 5
LAT_FLOW_TOL 5
MINIMUM_STEP 0.5
THREADS 1

[FILES]
;;Interfacing Files

[EVAPORATION]
;;Data Source Parameters
;;-------------- ----------------
CONSTANT 0.0
DRY_ONLY NO

[JUNCTIONS]
;;Name Elevation MaxDepth InitDepth SurDepth Aponded
;;-------------- ---------- ---------- ---------- ---------- ----------
80408 124.6 13.4 0 0 0
80608 118.3 16.7 0 0 0
81009 128.2 8.8 0 0 0
81309 117.5 12.5 0 0 0
82309 112.3 42.7 0 0 0
10309 101.6 9.4 0 0 0
15009 111.5 13.5 0 0 0
16009 102 18 0 0 0
16109 102.8 22.2 0 0 0

[OUTFALLS]
;;Name Elevation Type Stage Data Gated Route To
;;-------------- ---------- ---------- ---------------- -------- ----------------
10208 89.9 FIXED 94.4 YES

[CONDUITS]
;;Name From Node To Node Length Roughness InOffset OutOffset InitFlow MaxFlow
;;-------------- ---------------- ---------------- ---------- ---------- ---------- ---------- ---------- ----------
8040 80408 80608 1800 0.015 0 0 0 0
8060 80608 82309 2075 0.015 0 2.2 0 0
8100 81009 81309 5100 0.015 0 0 0 0
8130 81309 15009 3500 0.015 0 0 0 0
1030 10309 10208 4500 0.016 0 0 0 0
1570 15009 16009 5000 0.0154 0 0 0 0
1600 16109 16009 500 0.015 0 0 0 0
1630 16009 10309 300 0.015 0 0 0 0
1602 82309 16109 5000 0.034 0 0 0 0

[XSECTIONS]
;;Link Shape Geom1 Geom2 Geom3 Geom4 Barrels Culvert
;;-------------- ------------ ---------------- ---------- ---------- ---------- ---------- ----------
8040 CIRCULAR 4 0 0 0 1
8060 CIRCULAR 4 0 0 0 1
8100 CIRCULAR 4.5 0 0 0 1
8130 CIRCULAR 4.5 0 0 0 1
1030 TRAPEZOIDAL 9 0 3 3 1
1570 CIRCULAR 5.5 0 0 0 1
1600 CIRCULAR 6 0 0 0 1
1630 TRAPEZOIDAL 9 0 3 3 1
1602 CIRCULAR 5 0 0 0 1

[LOSSES]
;;Link Kentry Kexit Kavg Flap Gate Seepage
;;-------------- ---------- ---------- ---------- ---------- ----------
1030 0 0 0 YES 0

[INFLOWS]
;;Node Constituent Time Series Type Mfactor Sfactor Baseline Pattern
;;-------------- ---------------- ---------------- -------- -------- -------- -------- --------
80408 FLOW 80408 FLOW 1.0 1.0
81009 FLOW 81009 FLOW 1.0 1.0
82309 FLOW 82309 FLOW 1.0 1.0

[TIMESERIES]
;;Name Date Time Value
;;-------------- ---------- ---------- ----------
82309 0 0
82309 0.25 40
82309 3.0 40
82309 3.25 0
82309 12.0 0
;
80408 0 0
80408 0.25 45
80408 3.0 45
80408 3.25 0
80408 12 0
;
81009 0 0
81009 0.25 50
81009 3.0 50
81009 3.25 0
81009 12 0

[REPORT]
;;Reporting Options
INPUT NO
CONTROLS NO
SUBCATCHMENTS ALL
NODES ALL
LINKS ALL

[TAGS]

[MAP]
DIMENSIONS 0.000 0.000 10000.000 10000.000
Units None

[COORDINATES]
;;Node X-Coord Y-Coord
;;-------------- ------------------ ------------------
80408 10115.790 7536.840
80608 7463.160 7536.840
81009 9989.470 2421.050
81309 7568.420 2421.050
82309 4957.890 7536.840
10309 389.470 2421.050
15009 4978.950 2421.050
16009 2494.740 2421.050
16109 2494.740 7536.840
10208 -578.950 4947.370

[VERTICES]
;;Link X-Coord Y-Coord
;;-------------- ------------------ ------------------

[LABELS]
;;X-Coord Y-Coord Label
2431.580 1052.630 "EXAMPLE 2 OF EXTRAN MANUAL" "" "Arial" 12 1 1
9821.050 7157.890 "Inflow" "" "Arial" 10 0 0
4663.160 7200.000 "Inflow" "" "Arial" 10 0 0
9694.740 2084.210 "Inflow" "" "Arial" 10 0 0

What the input file looked like in 1981 in fixed format

What the input file looked like in 1981 in fixed format

Closing Note

These two files Extran1 (free outfall) and Extran 2 (fixed backwater with a tide gate) reveals more than just technical specifications—it documents a remarkable continuity in hydraulic modeling spanning over four decades. From punch cards to GitHub repositories, this compact test case has served as a critical benchmark through multiple generations of software and hardware evolution. What began as a simple example in a 1981 manual has become an enduring standard for hydraulic solver validation across platforms and vendors.

The longevity of this test file demonstrates both the fundamental soundness of SWMM's early hydraulic principles and the engineering community's commitment to maintaining computational consistency in modeling tools. As stormwater management faces increasingly complex challenges from climate change and urbanization, these foundational test cases provide the reliable bedrock upon which modern solutions can confidently build.

Terminology Note

What is the difference between EPA SWMM and Extran?

EPA SWMM (Storm Water Management Model) is a comprehensive computer model developed by the Environmental Protection Agency for planning, analysis, and design of stormwater runoff, combined sewers, sanitary sewers, and other drainage systems. It's a complete package that can simulate rainfall, runoff quantity and quality, and system hydraulics for both single events and continuous simulations.

Extran (Extended Transport) was specifically the hydraulic flow routing module within earlier versions of SWMM (particularly SWMM3 and SWMM4). It handled the complex hydraulic calculations needed to model dynamic wave flow routing through pipes, channels, and control structures. Extran was developed to solve the complete Saint-Venant equations for gradually varied unsteady flow, allowing it to model pressurized flow, backwater effects, flow reversal, and complex networks with various hydraulic structures like weirs, pumps, and orifices.

In modern versions of SWMM (SWMM5 and later), the Extran module's functionality has been integrated into the main program, but hydraulic professionals still sometimes reference "Extran" when discussing the dynamic wave routing capabilities of SWMM, particularly when referencing historic benchmarks like the example files you're discussing in your article.