Importing XPRAFTS Data

Data from XPRAFTS network models can be imported to an InfoWorks network in InfoWorks ICM using files in the XPX format.

To import XPRAFTS network data:

  1. Open the InfoWorks network to be updated.
  2. Select Import | Model | from XPRAFTS XPX file from the Network menu, and a standard Windows Open dialog is displayed.

    ClosedShow me

  3. Select the .xpx file to be imported.
  4. From the Encoding dropdown list, select which encoding system is used in the xpx file to be imported. Currently supported systems are ANSI, UTF-8 (default) and UTF-8 BOM.
  5. Click Open. The import process starts and an XPRAFTS Import dialog is displayed.

    In this dialog, choose which import options you want to use, and then click OK. For information about the import options, see the XPRAFTS Import Dialog topic.

An import report will be displayed with any import errors or warnings.

For details of the objects imported and any conversions made by the XPRAFTS Importer, see the Import Notes below.

Import Notes

The following sections provide information about the import of network data from XPRAFTS to InfoWorks ICM.

Nodes

The following data from XPRAFTS xpx files is imported as node types of network objects in ICM.

XPCommand

XPRAFTS Field

XPRAFTS Description

ICM Data Field

Conversion Notes
NODE node_type Node type Node type

If the Maintain network connectivity by converting downstream lag links to channel links option is selected in the XPRAFTS Import dialog, XPRAFTS node-type = 133 and XPRAFTS node-type = 134 are imported as a Manhole types of node in ICM.

If the Split network downstream of channel links and maintain lag link data option is selected the XPRAFTS Import dialog, XPRAFTS node-type = 133 is imported as an ICM Storage type of node and XPRAFTS node-type = 134 is imported as a Break type of node in ICM.

node_name Node name Node ID  
X   x  
Y   y  
    System type Set to Storm.
~ ~ ~ Ground level

Set to the invert value of the imported upstream or downstream channel type of link plus the highest depth value of the link's associated channel profile.

For example, if the invert for an upstream channel is 6 mAD and the highest depth value for its associated cross section is 2 m, then the Ground level for the node is set to 8 mAD.

DATA LTYP Retarding Basin flag Relative stages

Applicable to Node type set to Storage.

The Relative stages box is checked if XPRAFTS LTYP is 1.

B2STAGE Level Storage array

Applicable to Node type set to Storage.

XPRAFTS Levels are converted to depths in ICM and are displayed in the Level field on the Storage array grid.

STORAGE Storage

Applicable to Node type set to Storage.

XPRAFTS Storage values in m3 are converted to m2 in ICM, by dividing the storage by the depth, and are displayed in the Area field on the Storage array grid.

Links

The following data from XPRAFTS xpx files is imported as the following types of link types of network objects in ICM.

XPCommand

XPRAFTS Field

XPRAFTS Description ICM Link Object

ICM Data Field

Conversion Notes
LINK link_type Link type Channel Link type

XPRAFTS link type 137 is imported to a Channel type of link in ICM.

link_name Link name Asset ID  
node_from US Node US node ID  
node_to DS Node DS node ID  
link_name Link name Shape ID  
DATA DXLR Total Link Length Length If CR_TYPE = 0, CR, LSFLAG will be imported as 1.
LINK link_name Link name Channel shape Shape ID  
~ ~ ~ Roughness type Set to N (Manning's n).
DATA H2STN Station Channel profile X Coordinate Imported for HEC-2 cross sections.
New panel This box is checked where there are changes in Roughness Manning's n.
H2ELEV Elevation Channel profile Depth

Imported for HEC-2 cross sections

Elevation is converted to Depth in ICM by subtracting to the lowest elevation in the HEC-2 coordinates.

Channel Base flow depth Main channel depth. Calculated as the average depth in LBANK (left bank) and RBANK (right bank) * 5%.

CHNL

Left Manning's N

Channel profile Roughness Manning's n

For HEC-2 cross sections:

If X is equal or less than Left Bank Station (LBANK), the value for CHNL is imported
If X is greater than or equal Right Bank Station(RBANK), the value for CHNR is imported.
Otherwise, the value for CHNC is imported.

For RAFTS cross sections:

Values of CHNL are imported for the first 2 entries
Values of CHNC are imported for the last 2 entries
Values of CHNR are imported for the rest of the entries up to a maximum of 8

CHNC Central Manning's N
CHNR Right Manning's N
FSSL Left Far Slope X Coordinate For RAFTS cross sections, these values are calculated using the slopes, widths and heights with the assumption that the width in both Far Slope is the same as the Overflow width.
OSL Left Overbank Slope
SSL Left Side Slope
FSSR Right Far Slope
OSR Right Overbank Slope
SSR Right Side Slope
DL Left Height
OFWL Left Overflow Width
BWD Central Width
DR Right Height
OFWR Right Overflow Width
FSSL Left Far Slope Channel profile Depth
OSL Left Overbank Slope
SSL Left Side Slope
FSSR Right Far Slope
OSR Right Overbank Slope
SSR Right Side Slope
DL Left Height
OFWL Left Overflow Width
BWD Central Width
DR Right Height
OFWR Right Overflow Width
  FSSL Left Far Slope Channel profile New panel This box is checked where there are changes in Roughness Manning's n.
OSL Left Overbank Slope
SSL Left Side Slope
FSSR Right Far Slope
OSR Right Overbank Slope
SSR Right Side Slope
DL Left Height
OFWL Left Overflow Width
BWD Central Width
DR Right Height
OFWR Right Overflow Width
  FSSL Left Far Slope Channel Base flow depth Main channel depth. Calculated as the average depth in LBANK (left bank) and RBANK (right bank) * 5%.
OSL Left Overbank Slope
SSL Left Side Slope
FSSR Right Far Slope
OSR Right Overbank Slope
SSR Right Side Slope
DL Left Height
OFWL Left Overflow Width
BWD Central Width
DR Right Height
OFWR Right Overflow Width
  MSLPX Mean Channel Slope Channel US invert level For the most downstream channel link, the DS invert level is set to 0 and US invert level is calculated from the Mean Channel Slope and Total Link Length. This calculation is then repeated for each upstream channel link.
  DXLR Total Link Length DS invert level
~ ~ ~ Channel System type Set to Storm.
Link link_type Link type Weir Link type XPRAFTS Diversion links are converted to Weirs in ICM.
link_name Link name Asset ID  
node_from US Node US node ID  
node_to DS Node DS node ID  
~ ~ ~ Width Set to 10.
~ ~ ~ System type Set to Storm.

Subcatchments

The following sections provide details of the import of XPRAFTS data to subcatchment data in ICM.

Subcatchments

The following data from XPRAFTS xpx files is imported as subcatchment types of network objects in ICM.

XPCommand

XPRAFTS Field

XPRAFTS Description

ICM Data Field

Conversion Notes
NODE node_name Node name Subcatchment ID This is imported as the node_name and subcatchment id (#1 or #2 ).
~ ~ ~ System type Set to Storm.
NODE node_name Node name Node ID  
DATA ~ ~ Drains to

Set to Subcatchment if the node is connected by a lag type of link; otherwise set to Node.

REFSTR_ICLOSS Rainfall Losses - Initial/Continuing Loss Land use ID

Imported only if Rainfall Loss Method (XPRAFTS Field = LST) is selected or equal to 0.

CA Total Area Total area  
PIMP Impervious Degree urbanisation

Converted to an urbanisation factor (see the Degree of urbanisation (U) table with linear interpolation between points).

CS Vectored Slope Slope The imported value is converted from a % into a ratio of vertical to horizontal by dividing by 100.
PERN Manning's n Equivalent Manning's n  
B Storage Coefficient RAFTS B Imported only if Use Direct Storage Co-efficient(XPRAFTS Field = CBTL) is checked.
NCC Constant RAFTS n  
~ ~ ~ Per surface RAFTS B Checked when the subcatchment is imported using the Combine 1st and 2nd subcatchments into a single polygon option in the Import XPRAFTS dialog.
CATCHMENT ~ Vertices Points If there is no subcatchment polygon set, ICM will create a circular boundary with an area equal to the Total Area (XPRAFTS Field = CA) with the node at the centre.
LINK node_to DS Node To Subcatchment ID Only imported if the node is upstream of lag link in XPRAFTS.
LAG Hydrograph Lag Output lag

Only imported if the node is upstream of lag link in XPRAFTS.

Set to 0 for subcatchment#2; otherwise the hydrograph lag link value is imported.

~ ~ Bypass runoff This box is checked if the node is upstream of lag link in XPRAFTS.
~ ~ ~ Area measurement type

Set to Percent if the subcatchment being imported has both a pervious and impervious value in the xpx file.

Otherwise set to Absolute.

Also set to Absolute if the Combine 1st and 2nd subcatchments into a single polygon option is used to import the subcatchment, and values are set for the XPRAFTS Second Subcatchment

~ ~ ~ Runoff area 1

Set to either the:

  • Pervious percentage value in the xpx file if the subcatchment being imported has both a pervious and impervious value.
  • Area of the XPRAFTS First Subcatchment (#1) if the Combine 1st and 2nd subcatchments into a single polygon option is used to import the subcatchment.
~ ~ ~ Runoff area 2

Set to either the:

  • Impervious percentage value in the xpx file if the subcatchment being imported has both a pervious and impervious value.
  • Area of the XPRAFTS Second Subcatchment (#2) if the Combine 1st and 2nd subcatchments into a single polygon option is used to import the subcatchment, and values are set for the XPRAFTS Second Subcatchment.

Land use

The following data from XPRAFTS xpx files is imported as land use types of network objects in ICM.

XPCommand

XPRAFTS Field

XPRAFTS Description

ICM Data Field

Conversion Notes
GLDBITEM object name Global Data Name Landuse ID

Imported with the format:

per_surface_<number> where the number is increased by 1 for each Land use object created.

GLDBITEM

ILOSS / CLOSS

Initial Loss

Continuing Loss

Description Imported with the format:
IL=<ILOSS>_CL=<CLOSS>

where ILOSS and CLOSS are the imported values, and surface type is the

~ ~ ~ Runoff surface 1  
~ ~ ~ Default area 1 Set to 100.

Runoff Surface

A runoff surface is added for each subcatchment imported from the xpx file.

If the Combine 1st and 2nd subcatchments into a single polygon option is used to import subcatchments, a runoff surface will be added for each XPRAFTS First and Second Subcatchments included in the combined subcatchment in ICM.

The following data from XPRAFTS xpx files is imported as runoff surface types of network objects in ICM.

XPCommand

XPRAFTS Field

XPRAFTS Description

ICM Data Field

Conversion Notes
      Runoff surface ID  
GLDBDATA ILOSS Initial Loss Description Imported with the format:
IL=<ILOSS>_CL=<CLOSS>

where ILOSS and CLOSS are the imported values.

CLOSS

Continuing Loss

~ ~ ~ Surface type Set to Unknown.
~ ~ ~ Routing model Set to RAFTS.
~ ~ ~ User-specified RAFTS B

This box is checked (x) if the Split 1st and 2nd subcatchments to separate polygons is used to import the subcatchment data.

This box is not checked if the Combine 1st and 2nd subcatchments into a single polygon option is used to import the subcatchment data.

~ ~ ~ Runoff routing value Set to 1.000.
~ ~ ~ Ground slope Not set (null).
~ ~ ~ Runoff volume type Set to DefConLoss.
~ ~ ~ Fixed runoff coefficient Set to 1.00000.
GLDBDATA

CLOSS

Continuing Loss

Infiltration loss coefficient The value for the XPRAFTS Continuing loss is only imported if the Continuing loss type is set to Absolute in XPRAFTS.
~ ~ ~ Initial loss porosity Set to 1.000.
~ ~ ~ Initial loss type Set to Abs.
GLDBDATA

ILOSS

Initial Loss

Maximum deficit  
DATA PERN Manning's n Equivalent Manning's n Imported if the Combine 1st and 2nd subcatchments into a single polygon option is used to import subcatchments.
DATA BX   RAFTS adapt factor

 

 

Importing Network Data

XPRAFTS Import Dialog