EPANET export notes

This topic contains the following sections detailing export of InfoWorks WS data to EPANET v2 .INP data format:

Exporter limitations

The exporter currently supports asset data, limited control data, and demand diagram data.

The table below lists the EPANET 2 sections that are not exported and the reason that the section is not exported:

EPANET 2 section Export limitation

[TITLE]

No IWWS equivalent

[EMITTERS]

Not currently supported.

[ENERGY]

Export of Electricity Tariff is not currently supported.

[CONTROLS]

[RULES]

EPANET logical rules modelling is not directly equivalent to logical rules modelling in InfoWorks.

[QUALITY]

[REACTIONS]

[SOURCES]

[MIXING]

Export of Water Quality parameters is not currently supported.

[REPORT]

[LABELS]

[BACKDROP]

[TAGS]

No IWWS equivalent

General

Options

The EPANET [OPTIONS] section defines various simulation options. The majority of options are not set on export and will be set to the EPANET default values.

The following options are set on export:

Units

IWWS networks are exported to EPANET files with units based on the flow units that the user currently has set in InfoWorks.

InfoWorks flow unit EPANET flow unit

l/s

LPS

Acre-feet/d

AFD

ft3/s

CFS

l/min

LPM

m3/d

CMD

m3/hr

CMH

m3/s

LPS

Ml/d

MLD

UK gal/hr

CFS

UK gal/min

CFS

UK gal/s

CFS

UK Mgal/d

IMGD

US gal/min

GPM

US Mgal/d

MGD

US gal/s

CFS

Headloss

EPANET does not support DW friction coefficients or more than one Friction Type in the same network.

If more than one Friction Type exists in the network, a warning message will be exported to the start of the .INP file and the Headloss will be set to 'MIXED'.

If the IWWS friction type is Darcy-Weisbach, a warning message will be exported to the start of the .INP file and the Headloss will be set to 'H-W'. (When exporting pipes the IWWS DW-f value is added to the Local Loss coefficient and exported as the EPANET Minor Loss Coefficient.)

InfoWorks Friction Type EPANET Headloss

CW

D-W

DW

Not supported

HW

H-W

Times

The EPANET [TIMES] section defines various timestep parameters. The only parameter set on export is the PATTERN TIMESTEP.

The PATTERN TIMESTEP is calculated by examining every time profile exported to the [PATTERN] section of the .INP file. The PATTERN TIMESTEP is set to the lowest profile time-step found.

Profiles or demand patterns with time-steps greater than the PATTERN TIMESTEP will have additional values generated to conform to the calculated timestep.

Nodes

Node data is exported to the JUNCTIONS, RESERVOIRS, or TANKS section of the .INP file, depending on the type of node.

X and Y coordinate of nodes are exported to the [COORDINATES] section of the .INP file.

Basic nodes

Node data is exported to the [JUNCTIONS] section of the .INP file.

EPANET Parameter IWWS Export

ID

Node ID

(Spaces in node names will be replaced by underscores.)

ELEVATION

Elevation

BASE DEMAND FLOW

Average demands are calculated and exported to [DEMANDS] section

DEMAND PATTERN ID

Demand patterns are exported to [PATTERNS] section

Demands

Demand at a node is converted into an averaged demand value and exported to the [DEMANDS] section of the .INP file.

EPANET Parameter IWWS Export

JUNCTION

Node ID

(Spaces in node names will be replaced by underscores.)

DEMAND

Average Demand calculated from customer point demand, land use demand, user defined demand or Leakage Loss.

PATTERN

Demand Diagram Category if applicable.

 

If a Demand Diagram is exported in conjunction with the network, the demand diagram categories used by the network are exported to the [PATTERNS] section of the .INP file.

EPANET Parmaeter IWWS Export

PATTERN ID LABEL

Demand Category Name

MULTIPLIERS

Demand Category Daily Profiles

If the Demand Category profile timestep is greater than the timestep set in the [TIMES] section of the .INP file, additional multipliers will be added to the EPANET pattern to conform to the EPANET timestep.

The status of the Linear Interpolation option for the IWWS Demand Category will be taken into account when inserting additional multipliers.

Reservoir nodes

Reservoir node data is exported to the [TANKS] section of the .INP file. Any demands allocated to the reservoir are exported in the same way as demand allocated to Basic nodes.

EPANET Parameter IWWS Export

ID

Node ID

(Spaces in node names will be replaced by underscores.)

BOTTOM ELEVATION

Reservoir Bottom Level

INITIAL LEVEL

Initial Depth

(Only exported when Control Data is exported in conjunction with the network)

MINIMUM LEVEL

Calculated as:

Minimum Operating Level - Reservoir Bottom Level

MAXIMUM LEVEL

Last depth value in IWWS depth-volume curve

NOMINAL DIAMETER

For an IWWS reservoir with a single depth-volume pair, the nominal diameter of the EPANET Tank is calculated as:

√(Vol/Depth x 4 /p)

For an IWWS reservoir with more than one depth-volume pair, the nominal diameter of the EPANET Tank is set to zero.

MINIMUM VOLUME

For an IWWS reservoir with a single depth-volume pair, the minimum volume of the EPANET Tank is calculated as:

p x NOMINAL DIAMETER2 / 4 x MINIMUM LEVEL

Where the EPANET values of Nominal Diameter and Minimum Level are calculated as above.

 

For an IWWS reservoir with more than one depth-volume pair, the minimum volume of the EPANET Tank is set to zero.

VOLUME CURVE ID

For an IWWS reservoir with more than one depth-volume pair, the EPANET Volume Curve ID is set to the IWWS Node ID.

The depth-volume values of the reservoir are exported to the [CURVES] section of the .INP file.

EPANET Parameter IWWS Export

CURVE ID

Reservoir Node ID

X VALUE

Depth

Y VALUE

Volume

Transfer nodes

Transfer node data is exported to the [JUNCTIONS] section of the .INP file in the same was as Basic nodes.

If Control Data is exported in conjunction with the Network, Transfer Node Flow Control data is exported to the [DEMANDS] section of the .INP file.

EPANET Parameter IWWS Export

JUNCTION

Node ID

(Spaces in node names will be replaced by underscores.)

DEMAND

Transfer Node Flow Factor

PATTERN

Node ID

Transfer Node flow profiles are exported to the [PATTERNS] section of the .INP file:

EPANET Parameter IWWS Export

PATTERN ID LABEL

Transfer Node Node ID

MULTIPLIERS

Transfer Node time varying flow profile multiplied by -1.

If the timestep between flow profile values is greater than the timestep set in the [TIMES] section of the .INP file, additional multipliers will be added to the EPANET pattern to conform to the EPANET timestep.

The status of the Linear Profile option for the IWWS Transfer Node will be taken into account when inserting additional multipliers.

Fixed Head nodes

Fixed Head node data is exported to the [RESERVOIRS] section of the .INP file.

EPANET Parameter IWWS Export

ID

Fixed Head Node ID

(Spaces in node names will be replaced by underscores.)

HEAD

The Head value exported depends on whether Control Data is exported in conjunction with the network:

  • Control Data included:
    • If the Fixed Head Node does not have a time varying head profile, the EPANET Head is set to IWWS Fixed Head Constant Head
    • If the Fixed Head Node has a time varying head profile and the first value of the head profile is non zero, the EPANET Head is set to the first value in the IWWS time varying head profile.
    • If the Fixed Head Node has a time varying head profile and the first value of the head profile is zero, the EPANET Head is set to the IWWS node Elevation.
  • Control Data not included - EPANET Head is set to IWWS node Elevation

HEAD PATTERN ID

If Control Data is exported in conjunction with the network: for an IWWS Fixed Head with a time varying profile, the EPANET Head Pattern ID is set to the IWWS Node ID.

Fixed head profiles are exported to the [PATTERNS] section of the .INP file:

EPANET Parameter IWWS Export

PATTERN ID LABEL

Fixed Head Node ID

MULTIPLIERS

IWWS Fixed Head time varying head profile values divided by the value exported to the EPANET Reservoir Head field.

If the timestep between head profile values is greater than the timestep set in the [TIMES] section of the .INP file, additional multipliers will be added to the EPANET pattern to conform to the EPANET timestep.

The status of the Linear Profile option for the IWWS Fixed Head Node will be taken into account when inserting additional multipliers.

Wells

Well data is exported to the [JUNCTIONS] or [RESERVOIRS] section of the .INP file.

If Control Data is not exported in conjunction with the network, or the well is in Drawdown mode, well data is exported to the [JUNCTIONS] section of the .INP file (see Basic Nodes).

If Control Data is exported in conjunction with the network and the well is in Profile mode, well data is exported to the [RESERVOIRS] section of the .INP file.

EPANET Parameter IWWS Export

ID

Well Node ID

(Spaces in node names will be replaced by underscores.)

HEAD

The Head value exported depends on whether a time varying head profile is defined for the Well:

  • If the Well does not have a time varying head profile, the EPANET Head is set to IWWSWell Initial Level value.
  • If the Well has a time varying head profile and the first value of the head profile is non zero, the EPANET Head is set to the first value in the IWWS time varying head profile.
  • If the Well has a time varying head profile and the first value of the head profile is zero, the EPANET Head is set to the IWWS node Elevation.

HEAD PATTERN ID

Well time varying profiles are exported to the [PATTERNS] section of the .INP file:

EPANET Parameter IWWS Export

PATTERN ID LABEL

Well Node ID

MULTIPLIERS

IWWS Well time varying head profile values divided by the value exported to the EPANET Reservoir Head field.

If the timestep between head profile values is greater than the timestep set in the [TIMES] section of the .INP file, additional multipliers will be added to the EPANET pattern to conform to the EPANET timestep.

The status of the Linear Profile option for the IWWS Well will be taken into account when inserting additional multipliers.

Hydrants

Hydrant data is exported to the [JUNCTIONS] section of the .INP file (see Basic Nodes).

Links

Link data is exported to the [PIPES], [PUMPS] or [VALVES] sections of the .INP file, depending on the type of link.

X and Y coordinates of bends in links are exported to the [VERTICES] section of the .INP file.

Pipes

Pipe data is exported to the [PIPES] section of the .INP file.

EPANET Parameter IWWS Export

ID

Constructed from the From Node ID, To Node ID and Link Suffix of the IWWS Link:

<From Node ID>.<To Node ID>.Link Suffix

(Spaces in node names will be replaced by underscores.)

NODE 1

From Node ID

NODE 2

To Node ID

LENGTH

Length

DIAMETER

Diameter

ROUGHNESS COEFFICIENT

Friction Type = Hazen Williams: HW-c

Friction Type = Colebrook - White: CW-k

Note:

  • EPANET does not support DW friction coefficients or more than one Friction Type in the same network.

If Friction Type = Darcy-Weisbach, the IWWS DW-f value is added to the Local Loss coefficient and exported as the EPANET Minor Loss Coefficient. A warning message will be exported to the start of the .INP file.

If more than one Friction Type exists in the network, a warning message will be exported to the start of the .INP file.

MINOR LOSS COEFFICIENT

Local Loss

Note:

  • If Friction Type = Darcy-Weisbach, the IWWS DW-f value is added to the Local Loss coefficient and exported as the EPANET Minor Loss Coefficient. A warning message will be exported to the start of the .INP file.

STATUS

If Control Data is exported in conjunction with the network and the IWWS Pipe Closed option is checked, the EPANET Status of the pipe will be set to CLOSED.

Pump Stations

Pump Station data is exported to the [PUMPS] section of the .INP file. For multi-pump pump stations, each pump is exported as a separate EPANET pump.

EPANET Parameter IWWS Export

ID

Constructed from the From Node ID, To Node ID and Link Suffix of the IWWS Link:

<From Node ID>.<To Node ID>.Link Suffix

For a multi-pump pump station, each pump is exported as the link ID appended by _x where x is the pump number.

(Spaces in node names will be replaced by underscores.)

NODE 1

From Node ID

NODE 2

To Node ID

HEAD CURVE ID

As Pump ID above.

For a pump without an IWWS pump curve, the EPANET curve ID is set to 'NoPumpCurve'.

Pump curve data is exported to the [CURVES] section of the .INP file:

EPANET Parameter IWWS Export

CURVE ID

Pump Station ID as described above.

X VALUE

Pump Curve Flow

Y VALUE

Pump Curve Head (adjusted for number of stages and for differences between nominal speed and pump station maximum speed).

PATTERN ID

As Pump ID above.

Exported if Control data is exported in conjunction with the network and if the PST is of type PLAN.

Pump status profiles are exported to the [PATTERNS] section of the .INP file:

EPANET Parameter IWWS Export

PATTERN ID LABEL

Pump Station ID as described above.

MULTIPLIERS

Pump status time varying profile values.

If the timestep between profile values is greater than the timestep set in the [TIMES] section of the .INP file, additional multipliers will be added to the EPANET pattern to conform to the EPANET timestep.

 

Pump Station Bypass

If the IWWS PST Bypass option is checked, a separate pipe is exported to the [PIPES] section with the same ID as the PST appended by _BP. STATUS is set to CV (unless the IWWS PST Pipe Closed option is checked, in which case STATUS is set to CLOSED).

See Pipes for further export details.

Valves

Valve data is exported to the [VALVES] section of the .INP file.

EPANET Parameter IWWS Export

ID

Constructed from the From Node ID, To Node ID and Link Suffix of the IWWS Link:

<From Node ID>.<To Node ID>.Link Suffix

(Spaces in node names will be replaced by underscores.)

NODE 1

From Node ID

NODE 2

To Node ID

DIAMETER

Valve Diameter

(If the IWWS Valve Diameter is not set, the Pipe Diameter is exported.)

VALVE TYPE

IWWS valve types are exported as the following EPANET valve types:

IWWS Valve Type EPANET Valve Type

THV

TCV

PRV

PRV

PSV

PSV

FRV

FCV

All other valve types (or if Control data is not exported)

TCV

VALVE SETTING

The export of valve setting depends on the type of valve being exported:

IWWS Valve Type EPANET Valve Setting

THV

Loss Coefficient determined from valve curve.

PRV

Constant target Pressure

(Time varying profile will not be exported)

PSV

Constant target Pressure

(Time varying profile will not be exported)

FRV

Constant target Flow

(Time varying profile will not be exported)

All other valve types (or if Control data is not exported)

Loss Coefficient (Open)

MINOR LOSS COEFFICIENT

Valve Loss Coefficient (Open)

If the IWWS Valve Loss Coefficient (Open) is not set, the coefficient is set from the valve curve.

 

If Control Data is exported in conjunction with the network, valves with the IWWS Pipe Closed option checked will be exported to the [STATUS] section of the .INP file.

EPANET Parameter IWWS Export

ID

Constructed from the From Node ID, To Node ID and Link Suffix of the IWWS Link:

<From Node ID>.<To Node ID>.Link Suffix

(Spaces in node names will be replaced by underscores.)

Status/Setting

CLOSED

Float Valves

Float Valve data is exported to the [VALVES] section of the .INP file.

EPANET Parameter IWWS Export

ID

Constructed from the From Node ID, To Node ID and Link Suffix of the IWWS Link:

<From Node ID>.<To Node ID>.Link Suffix

(Spaces in node names will be replaced by underscores.)

NODE 1

From Node ID

NODE 2

To Node ID

DIAMETER

Valve Diameter

(If the IWWS Valve Diameter is not set, the Pipe Diameter is exported.)

VALVE TYPE

TCV

VALVE SETTING

Valve Loss Coefficient (Open)

MINOR LOSS COEFFICIENT

Valve Loss Coefficient (Open)

If the IWWS Valve Loss Coefficient (Open) is not set, the coefficient is set from the valve curve.

 

If Control Data is exported in conjunction with the network, valves with the IWWS Pipe Closed option checked will be exported to the [STATUS] section of the .INP file.

EPANET Parameter IWWS Export

ID

Constructed from the From Node ID, To Node ID and Link Suffix of the IWWS Link:

<From Node ID>.<To Node ID>.Link Suffix

(Spaces in node names will be replaced by underscores.)

Status/Setting

CLOSED

Backfeed Pipe

If the IWWS float valve Backfeed Pipe option is checked, a separate pipe is exported to the [PIPES] section with the same ID as the Float Valve appended by _BF. EPANET NODE 1 and NODE 2 are reversed and STATUS is set to CV (unless the IWWS Float Valve Pipe Closed option is checked, in which case STATUS is set to CLOSED).

See  Pipes for further export details.

Non Return Valves

Non Return Valve data is exported to the [PIPES] section of the .INP file.

The EPANET Pipe STATUS is set to CV by default.

See  Pipes for further export details.

Meters

Meter data is exported to the [PIPES] section of the .INP file.

Note:

See Pipes for further export details.

Exporting to EPANET files

Exporting network data

Exporting control data