Share
 
 

XPSWMM/XPStorm Conversion Notes (SWMM)

XPSWMM/XPStorm network data can be imported from XPX files to SWMM networks.

This topic contains conversion details regarding the import of the files to ICM SWMM network objects, database items and model parameters.

Model Parameters

The following fields in an XPX file are imported to the following fields in the ICM SWMM Model parameter options:

XPX Field ICM Data Field Notes
R_INFILM Infiltration model

EPA_FORCE_MAIN_EQ Force main equation
EPA_ALLOW_PONDING Allow ponding
EPA_INER_DAMPING Inertial damping
EPA_NRML_FLW_LTD Normal flow criterion
AMEN Minimum nodal surface area

SWMM Run

The following fields in an ICM SWMM Run database item can be imported from the following fields in an XPX file:

XPX Field ICM Data Field Notes
KINE

Routing model

EPA_IG_RAINFALL Rainfall
EPA_SKIP_STD_ST Skip steady flow periods
Hydraulics DZERO MOZERO YZERO Runoff R_NDAY R_MONTH R_IYRSTR Start Analysis

Start Time and Start Date combined.

Hydraulics HZERO MZERO SZERO Runoff R_NHR R_NMN R_NSC Start Analysis
Hydraulics DSL MOSL YSL Runoff R_STPDAY R_STPMON R_IYRSTP End Analysis End Time and End Date combined.
Hydraulics HSL MSL SSL Runoff R_STPHR R_STPMN R_STPSC End Analysis
Hydraulics & Runoff DZERO MOZERO YZERO Reporting start
R_KLNBGN_MTH R_KLNBGN_DAY Sweeping start
Combination of:R_KLNEND_MTH R_KLNEND_DAY Sweeping end
R_DRYDAY Antecedent dry days
SAVERES / 3600 SAVERES / 60.0 (if SAVERES_TYPE = 1) Reporting step
R_WET / 3600 Runoff step - wet weather
DRY_STEP / 3600 Runoff step - dry weather
DELT /3600 Routing step
EPA_LENGHT_STEP Conduit lengthening timestep
EPA_VARIABLE_STEP

Adjust variable timesteps %

SWMM Climatology

The following fields in an ICM SWMM Climatology database item can be imported from the following fields in an XPX file:

XPX Field ICM Data Field Notes
R_IVAP

Source of evaporation rates

If the 'Use default' option has been specified for XPX evaporation (i.e. R_IVAP = 0), the Source of evaporation rates is set to Constant value in ICM.

If the 'Direct Input' option was specified for XPX evaporation (i.e. R_IVAP = 1), the Source of evaporation rates is set to Monthly averages in ICM.

If the 'TEMP Interface File' was specified for XPX evaporation (i.e., R_IVAP = 2), evaporation data is not imported to ICM.

Daily evaporation

Imported if R_IVAP = 0.

The Daily evaporation is set to the default XPX value of 0.3 mm or 1 inch.

R_IVAP Month / Average evaporation grid

Imported if the 'Direct Input' option was specified for XPX evaporation (i.e. R_IVAP = 1).

If 'Direct Input' is set to 'Daily Values' (i.e. R_IVAPC =0), the values displayed in the Month / Average evaporation grid in ICM will the imported XPX value for each month.

If 'Direct Input' is set to 'Monthly Values' (i.e. R_IVAPC =1), the values displayed in the Month / Average evaporation grid in ICM will be imported as:

the XPX value for the month
the number of days in the month

Note that the number of days used for February is 28.

R_VAP

R_IVAPC

Network Objects

The following fields can be imported from XPX files to various SWMM network objects in ICM. The applicable field information is contained in the relevant sections in this topic.

Object Category

Object Parameters

Conversion Notes
Nodes Node See Nodes below
Unit hydrograph group See Unit hydrograph group below
Unit hydrograph See Unit hydrograph below
Storage curve See Storage curve below
Links Conduit See Conduit below
Pump Curve See Pump Curve below
Rating Curve See Rating Curve below
Orifice See Orifice below
Outlet See Outlet below
Pump See Pump below
Transect See Transect below
Weir See Weir below
Subcatchments Subcatchment See Subcatchment below
Land use See Land Use below
Pollutant See Pollutant below
LID control See LID Control below
Points Rain gage See Points below
Polygons Polygons See Polygon below
Mesh zones See Mesh Zone below
2D zones See 2D Zone below
Mesh level zone See Mesh Level Zone below
Roughness zone See Roughness Zone below
Lines Boundary lines See 2D Boundary below

Nodes

Data from an XPX file is imported to the following types of Node objects in an ICMSWMM network.

Nodes

The following fields in an XPX file are imported as a Node type of object in an ICM SWMM network:

XPX Field ICM Data Field Notes
<Node Name>

Node ID

Z Invert elevation
GRELEV Ground level For Node Type set to Junction or Storage.
Max depth For Node Type set to Junction or Storage. The Max depth in ICM is calculated by subtracting Z (invert elevation) from GRELEV (spill crest).
Y0 Initial water depth For Node Type set to Junction or Storage.
<Node Name>_ST Initial moisture deficit
CONST Coeff of shape function For Node Type set to Storage.
EXPO Exponent of shape function
AJ1*exp(AJ2) Ponded area For Node Type set to Junction.
GATE Tide gate For Node type set to Outfall.
A1A Fixed stage For Node type set to Outfall, and Outfall Type set to Fixed.
<Node Name>_TD Tidal curve For Node type set to Outfall, and Outfall Type set to Tidal.
pNode->LocationGet().c_dX x
pNode->LocationGet().c_dY y
R_RDII_NAME Unit hydrograph
R_WAREA R_RDII_SEWER (if R_RDII_AREA = 1) Sewershed contributing area
<dfactor> * HDR_SEWAGE * HDR_ASUB (if HDR_DWF_MTD = 1) <dfactor> * HDR_SEWAGE * HDR_ASUB * dDensity (if HDR_DWF_MTD = 2) Base flow
HDR_TMPV + WD Base flow pattern 1
QINST (for HDR) T_QCON (for SAN)

Baseline inflow

Baseline

Unit Hydrograph

The following fields in an XPX file are imported as a Unit Hydrograph type of node object in an ICM SWMM network:

XPX Field ICM Data Field Notes
R_ST_FRACTION Response ratio R - short term
R_ST_TIME Time to peak T - short term
R_ST_RATIO Recession limb ratio K - short term
R_ST_MAXINIT Max initial abstraction depth - short term
R_ST_RECOVERY Initial abstraction recovery rate - short term
R_ST_STORAGE Initial abstraction depth - short term
R_MT_FRACTION Response ratio R - medium term
R_MT_TIME Time to peak T - medium term
R_MT_RATIO Recession limb ratio K - medium term
R_MT_MAXINIT Max initial abstraction depth - medium term
R_MT_RECOVERY Initial abstraction recovery rate - medium term
R_MT_STORAGE Initial abstraction depth - medium term
R_LT_FRACTION Response ratio R - long term
R_LT_TIME Time to peak T - long term
R_LT_RATIO Recession limb ratio K - long term
R_LT_MAXINIT Max initial abstraction depth - long term
R_LT_RECOVERY Initial abstraction recovery rate - long term
R_LT_STORAGE Initial abstraction depth - long term
R_RDII_NAME UH group

Unit Hydrograph Group

The following fields in an XPX file are imported as a Unit Hydrograph Group type of node object in an ICM SWMM network:

XPX Field ICM Data Field Notes
R_RDII_NAME UH group ID
R_RDII_RAIN Rain gage

Storage Curve

The following fields in an XPX file are imported as a Storage Curve type of node object in an ICM SWMM network:

XPX Field ICM Data Field Notes
<NODE Name>_ST Curve ID
QCURRL (for Tabular) GRELEV - Z (for Constant) Depth From the Storage array grid.
QCURA (for Tabular) ASTORE (for Constant) Surface area

Links

Data from an XPX file is imported to the following types of Link objects in an ICM SWMM network.

Conduit

The following fields in an XPX file are imported to a Conduit type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
<Link name> CNAME<Instance number>

Link ID

US Node Name Start Node
DS Node Name End Node
LEN Length
ROUGH Manning's N
(ZP1 - Z) Upstream elevation
(ZP2 - Z) Downstream elevation
QO Initial flow
NKLASS NKCTL(If NKLASS is Special) ISQRND (for Orifice) Shape For conduits with a Shape set to: CIRCULAR, FORCE_MAIN, FILLED_CIRCULAR, RECT_CLOSED, RECT_OPEN, TRAPEZOIDAL, TRIANGULAR, HORIZ_ELLIPSE, VERT_ELLIPSE, ARCH, PARABOLIC, POWER, RECT_TRIANGULAR, RECT_ROUND, MODBASKETHANDLE, EGG, HORSESHOE, GOTHIC, CATENARY, SEMIELLIPTICAL, BASKETHANDLE, SEMICIRCULAR, CUSTOM or IRREGULAR.
DEEP sqrt(((4.0 * AORIF)/PI)) (for Circular Orifice) DORIF (For RECT_CLOSED Orifice) YTOP - YCREST (for Weir) Conduit height For conduits with a Shape set to: Rect_closed, Rect_open, Trapezoidal, Triangular, Horiz_ellipse, Vert_ellipse, Arch, Parabolic Power, Rect_triangular, Rect_round, ModBasketHandle, Egg, Horseshoe, Gothic, Catenary, Semielliptical, Baskethandle and Semicircular.
TTHETA (For Trapezoidal) PTHETA( For Power) DEEP (For Horizontal and vertical ellipse) WIDE^2 / (8.0*(DEEP - AFULL)) + (DEEP - AFULL)/ 2 (For Rectangular Round bottom) Concrete size code For Shape set to Arch and Standard size material set to Concrete.
TPHI (For Trapezoidal) Right slope For conduits with Shape set to Trapezoidal.
BARREL Number of barrels
<Link name>_DW Shape curve For conduits with a Shape set to Custom.
NATS_SHAPE Transect For conduits with a Shape set to Irregular.
PLC KU + (KUCONST^2) - 1.0 : (If LOSSTYPE =1) US headloss coefficient
GEOFF DS headloss coefficient

Pump Curve

The following fields in an XPX file are imported to a Pump Curve type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
PSEL Curve ID
IPTYP Pump curve type
PSFACT ^2 * PRATEX Inlet volume increment For Pump curve type set to PUMP1 (Inlet volume increment).
Inlet depth increment For Pump curve type set to PUMP2 (Inlet depth increment).
Head difference For Pump curve type set to PUMP3 (Head difference).
Continuous depth For Pump curve type set to PUMP4 (Continuous depth).
PSFACT ^2 * PRATEY Flow

Rating Curve

The following fields in an XPX file are imported to a Rating Curve type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
pMLSpecial->GetName() Rating curve ID
SC3V1 Head difference From the Rating array grid.
SC3V2 Outlet flow

Orifice

The following fields in an XPX file are imported to an Orifice type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
ORIFNAME Link ID
US Node Name Start node
DS Node Name End node
ONKLASS Type
ZP - Z Invert level
CORIF Discharge coefficient

Outlet

The following fields in an XPX file are imported to the an Outlet type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
<Instance number> Link ID
US Node Name Start node
DS Node Name End node
SPECNAME Rating curve For Rating curve type set to Tabular/Depth or Tabular/Head.

Pump

The following fields in an XPX file are imported to a Pump type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
PNAME Link ID
US Node Name Start node
DS Node Name End node
PSEL Pump curve ID
Ideal pump
PON - Z(USNode) Startup depth
POFF - Z(USNode) Shutoff depth

Transect

The following fields in an XPX file are imported to a Transect type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
EL Elevation From the Profile grid.
STA Station
NSGD_XNL Left bank roughness
NSGD_XNR Right bank roughness
NSGD_XNCH Channel roughness
NATS_SHAPE Transect ID
NSGD_STCHL Left bank offset
NSGD_STCHR Right bank offset

Weir

The following fields in an XPX file are imported to a Weir type of link object in an ICM SWMM network:

XPX Field ICM Data Field Notes
WEIRNAME Link ID
US Node Name Start node
DS Node Name End node
KWEIR Weir type
YCREST - Z Crest height
COEFF Discharge coefficient
CNTLW Flap gate

Subcatchments

Data from an XPX file is imported to the following types of Subcatchment objects in an ICM SWMM network.

Subcatchment

The following fields in an XPX file are imported to a Subcatchment type of object in an ICM SWMM network:

XPX Field ICM Data Field Notes
R_IROUGH

Impervious roughness

R_PROUGH Pervious roughness
R_WSTOR1 Impervious storage depth
R_WSTOR2 Pervious storage depth
R_PCTZER Percent no storage
R_REDIR_TYPE Routing
<Node Name>#<Catchment Index> Subcatchment ID
R_RAINSEL or reference from storms Rain gage ID
Outlet

If R_REDIR_FLAG == 1 and subcatchment index (R_REDIR_SUBCAT) is selected, the Outlet is set to the appropriate Subcatchment ID.

If R_REDIR_FLAG == 1 and "outlet" is selected, the Outlet is set to the relevant Node ID.

R_WAREA Area
R_WIMP Imperviousness (%)

If R_FSCS is 1, the Imperviousness (%) field is set to 0. Otherwise, it is set to the value of R_WIMP.

R_WIDTH Subcatchment width
R_WSLOPE * 100 Slope
R_WLMAX Initial infiltration

For Infiltration model set to Horton and Modified Horton infiltration.

R_WLMIN Limiting infiltration
R_DECAY * 3600 Decay factor
R_REGEN * 360 (if R_REGENTAG = 1) Drying time For Infiltration model set to Horton, Modified Horton and Curve Number infiltration.
R_MAXINF Maximum infiltration volume For Infiltration model set to Horton and Modified Horton infiltration.
R_SUCT Average capillary suction For Infiltration model set to Green-Ampt and Modified Green-Ampt.
R_HYDCON Saturated hydraulic conductivity
R_SMDMAX Initial moisture deficit
SCS_CN Curve number For Infiltration model set to Curve Number infiltration.
poly->c_dX Points
poly->c_dY Points
R_WQLU Land use From the Land uses grid.
R_WQPAR Area (%)
R_SHAPE Runoff model type

Imported if R_FSCS is 1.

If R_SHAPE = 0, Runoff model type is set to SCS_curvilinear.

If R_SHAPE = 1, Runoff model type is set to SCS_triangular

R_TC Time of concentration Imported if R_FSCS is 1.
Hydraulic length Set to 1 if R_FSCS is 1.
R_SCS_SHF Shape factor Imported if R_FSCS is 1.
R_WIMP Curve number

Imported if R_FSCS is 1.

Imported using the following equation:

{(R_WIMP / 100)* 98 + [1 - (R_WIMP/100)] * R_CN} / 100.0

R_IA Initial abstraction type

Imported if R_FSCS is 1.

If R_IA is 1, Initial abstraction type is set to Depth.

If R_IA is 0, Initial abstraction type is set to Factor.

R_IADEPTH Initial abstraction Imported if R_FSCS is 1 and the Initial abstraction type is set to Depth.
R_IAFRACT Initial abstraction factor

Imported if R_FSCS is 1 and the Initial abstraction type is set to Factor.

The Initial abstraction factor is calculated using the following equation:

R_IAFRACT * 0.2 * (1000 / curve_number - 10)

Land Use

The following fields in an XPX file are imported to a Land Use type of subcatchment object in an ICM SWMM network:

XPX Field ICM Data Field Notes
landuseRec.c_sRecName Land use ID
R_CLFREQ Sweep interval
R_AVSWP / 100 Sweep availability
R_DSLCL Last swept
<CXD_NameRec.c_sRecName> Pollutant From the Build Up grid.
R_GMETH Build-up type
R_GDDLIM Max. build-up
R_GDDFACT2 Power rate constant
R_GDDPOW1 Power time exponent
R_GDDPOW2 Exponential rate constant
R_GDDPOW3 Half saturation constant
R_KACGUT Unit
<CXD_NameRec.c_sRecName> Pollutant From the Washoff grid.
R_EWASH Washoff type
R_ERCOEFF Exponential washoff coefficient
R_EWASHPO Washoff exponent
R_COEFF Rating washoff coefficient
R_QCOEFF1 EMC washoff coefficient

Pollutant

The following fields in an XPX file are imported to a Pollutant type of subcatchment object in an ICM SWMM network:

XPX Field ICM Data Field Notes
CXD_NameRec.c_sRecName Name
NDIM Units
R_CONCRN Rainfall concentration
R_GCONC Groundwater concentration
T_PCCON I&I concentration
R_LINKUP Snow only
R_KTO Co-pollutant
R_F1 / 100 Co-fraction

LID Control

The following fields in an XPX file are imported to a LID Control type of subcatchment object in an ICM SWMM network:

XPX Field ICM Data Field Notes
LIDSUBC_NAME LIDS control ID From the LID Controls grid.
LIDSUBC_REPL Number of units
LIDSUBC_AREA_EACH (if iFullArea != 1) R_WAREA * <factor> / LIDSUBC_REPL Area
LIDSUBC_TOP_WIDTH Unit surface width
LIDSUBC_INIT_SAT Initial saturation (%)
LIDSUBC_TREATED_AREA Impervious area treated (%)
LIDSUBC_SEND Outflow to
LIDSUBC_DRAIN_FLG = 1: c_pNet->GetNodeAtIdx(LIDSUBC_DRAIN_IDX) Drain to node
Drain to subcatchment
LIDWSUD_TYPE Control type
LIDSUBC_NAME Control ID
LID_SRFC_DEPTH Berm height
LID_SRFC_VEGE Vegetation volume fraction
LID_SRFC_ROUGHNESS Surface roughness (Manning's n)
LID_SRFC_SLOPE Surface slope For Control type: Bio-retention cell, Rain garden, Green roof, Infiltration trench, Permeable pavement, Rooftop disconnection, Vegetative swale.
LID_SRFC_XSLOPE Swale side slope (run/rise) For the Control type: Vegetative Swale.
LID_SRFC_DEPRSTR Storage thickness For the Control type: Infiltration trench, Permeable pavement.
LID_SOIL_THICKNESS Soil thickness

For the Control type: Bio-retention cell, Rain garden, Green roof, Permeable pavement.

LID_SOIL_POROSITY Soil porosity
LID_SOIL_FIELD_CPC Field capacity
LID_SOIL_WILTING_POINT Wilting point
LID_SOIL_CONDUCTIVITY Conductivity
LID_SOIL_CNDT_SLOPE Conductivity slope
LID_SOIL_SUCTION_HEAD Suction head
LID_PVMT_THICKNESS Pavement thickness

LID_PVMT_VOID_RATIO Pavement void ratio
LID_PVMT_IMP_SURF Impervious surface fraction
LID_PVMT_PERMEABILITY Permeability
LID_PVMT_CLOGGING Pavement clogging factor
LID_STRG_HEIGHT Barrel height For Control type: Rain barrel.
LID_STRG_VOID_RATIO Storage void ratio For Control type: Bio-retention cell, Infiltration trench, Permeable pavement.
LID_STRG_CONDUCTIVITY Seepage rate For Control type: Bio-retention cell, Rain garden, Infiltration trench, Permeable pavement.
LID_STRG_CLOGGING Storage clogging factor For Control type: Bio-retention cell, Infiltration trench, Permeable pavement.
LID_UD_COEFF Flow capacity For Control Type: Rooftop disconnection.
LID_UD_EXP Flow exponent

For Control type: Bio-retention cell, Infiltration trench, Permeable pavement, Rain barrel.

LID_UD_OFFSET Offset height
LID_UD_DELAY Delay For Control Type: Rain barrel.
LID_DMAT_THICKNESS Mat thickness For Control type: Green roof.
LID_DMAT_VOID_RATIO Mat void fraction
LID_DMAT_ROUGHNESS Mat roughness (Manning's n)

Points

The following fields in an XPX file are imported to the following types of Point objects in an ICM SWMM network:

XPX Field

InfoWorks ICM Network/Database

object

InfoWorks ICM Data Field Notes
RECNAME Rain Gage

Rain gage ID

RN#<RainGno> Rainfall profile

Polygons

Data from an XPX file is imported to the following types of Polygon objects in an ICM SWMM network.

Polygon

The following fields in an XPX file are imported to a Polygon type of polygon object in an ICM SWMM network:

XPX Field ICM Data Field Notes
Default Area Type Category

Set to Void in ICM for any polygon whose Default Area Type is 'Inactive' in the XPX file.

Set to Void in ICM for any polygon that is created as a result of importing data to a 2D zone object. See the Boundary array description for 2D Zones below.
Layer Name ID

Applicable for data imported from LAYER in the XPX file.

The format for the ID is:

<Layer name>_<Layer id>_<Polyline id>

Layer ID
Polygon ID
ID

Applicable for data imported from DATA in the XPX file.

The polygon ID is generated based on the XPX layer the polygon is exported from.

The format of the ID is as follows:

  • TOP_<Num> - for polygons exported from a topography layer
  • RGH_<Num> - for polygons exported from a landuse layer
  • REG_<Num> - for polygons exported from any other layer

For a polygon that is created as a result of importing data for a 2D zone object, the format of name of the polygon is:

VP_<number> where the number is sequentially increased for each polygon created.

See the Boundary array description for 2D Zones below for further information.

Area Calculated by ICM using the imported boundary array data.

2D_REG_PNIND

Boundary array

Applicable for data imported from DATA in the XPX file.

The geometry of the polygon.

2D_REG_PX and 2D_REG_PY store the X and Y coordinate of each point within a polygon for all the region type layers. Polygon index is the order in which the X and Y values are stored in the database. 2D_REG_PNIND stores the number of indices per polygon while 2D_REG_ PIND stores the actual indices.

Imported with polygon geometry if 2D_REG_PTYPE = 0

2D_REG_PX

2D_REG_PY
2D_REG_PIND
2D_REG_PTYPE
2D_REG_PVAL
2D_TOP_PNIND Boundary array

Applicable for data imported from DATA in the XPX file.

The geometry of the polygon.

If 2D_TOP_PVAL = 3 (filled), the '2D_TOP' fields are imported as a Mesh zone in ICM; otherwise they are imported as a Polygon.

2D_TOP_PX and 2D_TOP_PY stores the X and Y coordinate of each point within a polygon for all the region type layers. Polygon index is the order in which the X and Y values are stored in the database. 2D_TOP_PNIND stores the number of indices per polygon while 2D_TOP_PIND stores the actual indices.

Imported with polygon geometry if 2D_TOP_PTYPE = 0
2D_TOP_PX
2D_TOP_PY
2D_TOP_PIND
2D_TOP_PTYPE
2D_TOP_PVAL
Boundary array

Applicable for data imported from DATA in the XPX file.

The geometry of the polygon that is created as a result of importing data to a 2D zone object. For further information, see the Boundary array description for 2D Zones below.

X,Y points Boundary array Applicable for data imported from LAYER in the XPX file.

Mesh Zone

The following fields in an XPX file are imported to a Mesh zone type of polygon object in an ICM SWMM network:

XPX Field ICM Data Field Notes
Layer Name ID

Applicable for data imported from LAYER in the XPX file.

The format for the ID is:

<Layer name>_<Layer id>_<Polyline id>

Layer ID
Polygon ID
ID

Applicable for data imported from DATA in the XPX file.

The ID is generated based on the XPX layer the polygon is exported from.

The format of the ID is as follows:

  • TOP_<Num> - for polygons exported from a topography layer
  • RGH_<Num> - for polygons exported from a landuse layer
  • REG_<Num> - for polygons exported from any other layer
Area Calculated by ICM using the imported boundary array data.
2D_TOP_PNIND Boundary array

Applicable for data imported from DATA in the XPX file.

The geometry of the mesh zone.

If 2D_TOP_PVAL = 3 (filled), the '2D_TOP' fields are imported as a Mesh zone in ICM; otherwise they are imported as a polygon.

2D_TOP_PX and 2D_TOP_PY stores all the X and Y coordinate of each point within a polygon for all the region type layers. Polygon index is the order in which the X and Y values are stored in the database. 2D_TOP_PNIND stores the number of indices per polygon while 2D_TOP_PIND stores the actual indices.

2D_TOP_PX
2D_TOP_PY
2D_TOP_PIND
2D_TOP_PTYPE Imported with polygon geometry if 2D_TOP_PTYPE = 0
2D_TOP_PVAL
X,Y points Boundary array Applicable if the Mesh zone is imported from the LAYER, POLYGONS and LAYER_DATA commands in the XPX file.
Grid Step Size Minimum element area Only applicable to the XPX 2D_GRID_EXTENT layer type. The Minimum element area is imported as the value of the 'Grid Step Size' squared (F_2D_EXT_STEP2).

2D Zone

The following fields in an XPX file are imported to a 2D zone type of polygon object in an ICM SWMM network:

XPX Field ICM Data Field Notes
Layer Name ID

Applicable for data imported from LAYER in the XPX file.

The format for the ID is:

<Layer name>_<Layer id>_<Polyline id>

Layer ID
Polygon ID
ID

Applicable for data imported from DATA in the XPX file.

The ID is generated based on the XPSWMM/XPStorm layer the polygon is exported from.

The format of the ID is as follows:

  • EXT_<Num> - for polygons exported from a landuse layer
  • EXT_<Num> - for polygons exported from any other layer
Area

Calculated by ICM using the imported boundary array data.

Boundary array

Applicable for data imported from DATA in the XPX file.

The geometry of the 2D zone is determined by the imported grid extents.

Default Area Type

If the XPX Default Area Type is 'Inactive', data is imported as a 2D zone.

For any area in the XPX file that is not an active area polygon (ie, the XPSWMM/XPStorm polygon's Default Area Type is set to 'Inactive'), the grid extent for the inactive area is subtracted from the active area polygon and the remaining area is imported as the 2D zone boundary array data in ICM. Note that if the result yields any holes, the holes are imported as ICM Polygon objects with their Category property set to Void.

X,Y points Boundary array Applicable for data imported from LAYER in the XPX file.
Grid Step Size Minimum element area Only applicable to the XPX 2D_GRID_EXTENT layer type. The Minimum element area is imported as the value of the 'Grid Step Size' squared (F_2D_EXT_STEP2).

Mesh Level Zone

The following fields in an XPX file are imported to a Mesh level zone type of polygon object in an ICM SWMM network:

XPX Field ICM Data Field Notes
Layer Name ID

The format for the ID is:

<Layer name>_<Layer id>_<Polyline id>

Layer ID
Polygon ID

Vertices

The following XPX fields are imported into the Vertices Editor in ICM.

XPX Field

ICM Data Field

Notes

F_FAR_CONSTELEV Elevation
Vertex elevation type Set to Always.

Roughness Zone

The following fields in an XPX file are imported to a Roughness zone type of polygon object in an ICM SWMM network:

XPX Field ICM Data Field Notes
Layer Type If the Layer Type in the XPX file is 2D_LANDUSE, the data is imported to a Roughness zone object in ICM.
LanduseID ID

The format for the ID is:

<Landuse ID> _ <Count>

Count
Area

Calculated by ICM using the imported boundary array data.

ROUGH_VAL Roughness (Manning's n) Imported if Manning's roughness is set to constant in the XPX file.

2D_RGH_PNIND

Boundary array

Applicable for data imported from DATA in the XPX file.

The geometry of the porous polygon.

2D_RGH_PX and 2D_RGH_PY store all the X and Y coordinates of each point within a polygon for all the region type layers. Polygon index is the order in which the X and Y values are stored in the database. 2D_RGH_PNIND stores the number of indices per polygon while 2D_RGH_PIND stores the actual indices.

2D_RGH_PX

2D_RGH_PY
2D_RGH_PIND
2D_RGH_PTYPE Imported with polygon geometry if 2D_RGH_PTYPE = 0
2D_RGH_PVAL
X,Y points Boundary array Applicable if the Roughness zone is imported from the LAYER, POLYGONS and LAYER_DATA commands in the XPX file.

Lines

Data from an XPX file is imported to the following type of Line object in an ICM SWMM network.

2D Boundary

The following fields in an XPX file are imported to a 2D Boundary type of line object in an ICM SWMM network:

XPX Field ICM Data Field Notes
Layer name

Name

The format for the name is:

<Layer name>_<Layer id>_<Polyline id>

Layer ID
Polyline ID
X,Y points General Line XY Data
Layer type Boundary line type

If the XPSWMM/XPStorm Layer type is set to 2D_HEAD_BOUNDARY, the Boundary line type will be imported as Level in ICM.

If the XPSWMM/XPStorm Layer type is set to 2D_FLOW_BOUNDARY, the Boundary line type will be imported as Flow in ICM.

Was this information helpful?