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

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.

Minimize image

Edit image

Delete image

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

Minimize image

Edit image

Delete image

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

Minimize image

Edit image

Delete image

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

Minimize image

Edit image

Delete image

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.

Minimize image

Edit image

Delete image

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

Minimize image

Edit image

Delete image

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

Minimize image

Edit image

Delete image

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.

Leave a Reply

Translate »
Scroll to Top

Discover more from SWMM5, ICM SWMM, ICM InfoWorks, Ruby and Vibe Apps, InfoSWMM, InfoSewer

Subscribe now to keep reading and get access to the full archive.

Continue reading