Importing SOBEK Network Data

Network data from SOBEK can be imported to InfoWorks ICM using files in the LIT format.

To import SOBEK network data:

Open the network to be updated.
Select Import | Model | from SOBEK network data from the Network menu, and the SOBEK Import dialog is displayed.
Show me
In the SOBEK data folder field, enter the path to the folder which contains the network (LIT file) to be imported, or click to browse for the folder.
When selected, the Network dropdown list is populated with all the network files in the selected folder.
Choose a network from the Network dropdown list.
When selected, the Version dropdown list is populated with all versions of the selected network file.
Choose a version of the selected network from the Version dropdown list.
Click OK to start the import.

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

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

Import Notes

The following files are read by the InfoWorks ICM Importer during the import process:

Layer or File	Type	Notes
Topography layer	net	Base network topography (node and branch coordinates) Branches are split into multiple links according to information from other files
	cpt	Link geometry
	dat	Node storage
Friction layer	bed	Bed friction
Friction layer	exr	Extra friction
Cross section layer	dat	Cross section list and elevations Cross section IDs
	def	Cross section definitions
	net	Cross section locations and storage nodes Cross section nodes

The following sections provide information about the import of network objects from SOBEK to ICMLive Configuration Manager.

Nodes

Nodes may be imported from the SOBEK topography layer or cross section layer. See the Cross section section for information about nodes imported from the cross section layer.

SOBEK

InfoWorks ICM

Notes

Element

Attribute

Parameter

Database name

NODE

Node ID

node_id

NODE

User text 1

user_text_1

Name of node.

NODE

Node type

node_type

SOBEK Attribute Value	InfoWorks ICM Database Value
0	Manhole
1	Storage
2	Manhole
3	Manhole

NODE

Flood type

flood_type

SOBEK Attribute Value	InfoWorks ICM Database Value
0	Stored
1	Sealed
2	Lost

NODE

Chamber plan area

chamber_area

If absent, the maximum from the manhole storage 'ct sw' table sub-element is used.

NODE

Shaft plan area

shaft_area

If absent, the maximum from the manhole storage 'ct sw' table sub-element is used.

NODE

Floodable area

floodable_area

If absent, the maximum from the street storage 'ct ss' table sub-element is used.

NODE

Chamber roof level

chamber_roof

NODE

ct sw, ct ss

Storage array

storage_array

Conduits

Conduits are created based on SOBEK branch information in the topography layer. Conduits may also be generated from nodes in the cross section layer. See the Cross section section for further information.

SOBEK

InfoWorks ICM

Notes

Element

Attribute

Parameter

Database name

BRCH

US node ID

us_node_id

BRCH

DS node ID

ds_node_id

BRCH

Length

conduit_length

Points

point_array

Calculated from the curving point 'ct bc' table in the cpt file.

BDFR

Roughness type

roughness_type

SOBEK Attribute Value	InfoWorks ICM Database Value
1	N (Manning's N)
4	CW (Colebrook-White)

Other roughness types are not supported but will be recorded in import log.

BDFR

mt cp

Top roughness Manning's n

top_roughness_N

When the 'mt cp' attribute is followed by a 0, then the following value is used as the friction value for N (Manning's N) (mf=1).

BDFR

mt cp

Bottom roughness Manning's n

bottom_roughness_N

BDFR

mt cp

Top roughness Colebrook-White

top_roughness_CW

When the 'mt cp' attribute is followed by a 0, then the following value is used as the friction value for CW (Colebrook-White) (mf=4).

BDFR

mt cp

Bottom roughness Colebrook-White

bottom_roughness_CW

Cross section

Cross section data is imported from SOBEK as nodes in InfoWorks ICM.Imported nodes have a either a downstream conduit or channel type of link. See the Links section for further information.

Nodes

SOBEK		InfoWorks ICM		Notes
Element	Attribute	Parameter	Database name	Notes
CRSN	id	Node ID	node_id
CRSN	nm	User text 1	user_text_1	The name of the cross section is imported to the User text 1 field in the node properties.
CRSN	ci	X	x	Identifies which branch (from the net file) the node belongs to.
CRSN	lc	Y	y	Distance along the branch. Together with the branch ID, node location and link geometry, provides the position of the node on the network.
STON	id	Node ID	node_id	If the version number is 1.1 or higher in the net file (i.e. the first line begins with CR_ followed by a number greater than 1.1), then the STON elements are considered as storage nodes in the nodes.dat file and are imported; all other storage nodes are ignored. If the version number is less than 1.1, then all storage nodes are imported.
CRDS	id			Cross-section definition ID. Use for reference from the dat file.
CRDS	ty	Node type	node_type	Node type set to Manhole.

Links

Cross section data is imported from SOBEK as nodes in InfoWorks ICM. Depending on the SOBEK CRDS element and type ('ty') attribute, imported nodes have a either a downstream conduit or downstream channel type of link. See the table below for further information.

SOBEK

InfoWorks ICM

Notes

Element

Attribute

Parameter

Database name

CRSN

US node ID

us_node_id

Set for both conduit and channel types of links.

DS node ID

ds_node_id

Set for both conduit and channel types of links.

CRDS

bl (bed level.)

US invert level

us_invert

The US invert level on the conduit or channel.

CRDS

Shape ID

Width

Height

Springing height

shape

conduit_width

conduit_height

springing_height

This is used to primarily determine type of downstream link (conduit or channel), and the shape and dimensions of the conduit or channel:

SOBEK Attribute Value

InfoWorks ICM Database Value

0 (tabulated)

A conduit type of link with a user-defined shape unless the any of the following are attributes are present in the SOBEK def file:

rw and rh - the conduit Shape ID is set to RECT.
The conduit Width is set the SOBEK 'rw' value and the Height to the 'rh' value. Both values are converted from metres to millimetres.
aw, ah and aa – the conduit Shape ID is set to ARCHSPRUNG.
The conduit Width is set to the SOBEK 'aw' value, the Height to the 'aa' value , and Springing height is calculated by subtracting the SOBEK 'ah' value from the 'aa' value. All values are converted from metres to millimetres.

See the Shapes section for information about cross sections imported as conduits with a user-defined shape.

1 (trapezium)

A conduit type of link. May also have a user-defined shape.

The SOBEK general trapezium shape is not available in InfoWorks ICM however, if the SOBEK bank slope attribute 'bs' value is one of the following then this is imported as an 'OT' user-defined shape in InfoWorks ICM:

SOBEK bs Attribute Value	InfoWorks ICM Shape
0.25	OT4:1
0.5	OT2:1
1.0	OT1:1
2.0	OT1:2
4.0	OT1:4
6.0	OT1:6

If the bank slope attribute 'bs' is not one of the values listed in the table above, a user-defined symmetric trapezoidal shape is generated. See the Shape section for further information cross sections imported as conduits with a user-defined shape.

The conduit Width is set the SOBEK 'bw' value, and the Height is calculated using the SOBEK 'aw' (top width), 'bw' (the base width) and the slope bank slope 'bs' attributes.

All values are converted from metres to millimetres.

2 (open circle )

A conduit type of link and a Shape ID set to CIRC. The conduit Width and Height are set to double the value for the SOBEK radius attribute 'rd', and converted from metres to millimetres.

4 (closed circle )

A conduit type of link and a Shape ID set to CIRC.

The conduit Width and Height are set to double the value for the SOBEK radius attribute 'rd', and converted from metres to millimetres.

6 (egg shape )

A conduit type of link and a Shape ID set to EGG. The conduit Width is set the value of SOBEK 'bo' attribute, converted from metres to millimetres. The conduit Height is calculated as 1.5 times the conduit Width.

10 (yz table )

A channel type of link. See Channels for further information.

11 (asymmetrical trapezoidal )

A channel type of link. See Channels for further information.

Any other value

A conduit type of link. No other properties are set on the conduit.

Shapes

If the SOBEK cross-section data is imported as a node with a downstream conduit with a user-defined shape, the following is imported into ICMLive Configuration Manager as shape data:

SOBEK		InfoWorks ICM		Notes
Element	Attribute	Parameter	Database name	Notes
CRDS	ty =0 (tabulated) or 1 (trapezium)	Shape ID	shape_id
		Shape type	shape_type	Set to Symmetric.
		Geometry	geometry	If SOBEK 'ty' is 0 (tabulated), the SOBEK attribute 'lt lw' is imported as the height and width for a symmetric user-defined non-normalised shape. If SOBEK 'ty' is 1 (trapezium), the geometry is calculated using the SOBEK bed width ('aw' attribute), bed width ('bw' attribute) and bank slope ('bs' attribute) for a symmetric user-defined shape.

Channels

If the SOBEK cross-section data is imported as a node with a downstream channel type of link, the following is imported as ICMLive Configuration Manager channel data:

SOBEK	InfoWorks ICM	Notes
CRDS	ty = 10 (yz table ) or 11 (asymmetrical trapezoidal)	Shape ID	shape_id

SOBEK

InfoWorks ICM

Notes

Element

Attribute

Parameter

Database name

CRDS

ty = 10 (yz table ) or

11 (asymmetrical trapezoidal)

Shape ID

shape_id

Channel shape

If the SOBEK cross-section data is imported as a node with a downstream channel type of link, the following is imported as ICMLive Configuration Manager channel shape parameters:

SOBEK		InfoWorks ICM		Notes
Element	Attribute	Parameter	Database name	Notes
CRDS	ty = 10 (yz table ) or 11 (asymmetrical trapezoidal)	Shape ID	shape_id
		Roughness type	roughness_type	If friction data exists, this will be set accordingly to either Manning's 1/n, Manning's N or Colebrook White.
		Channel profile	profile	Pairs of offsets and levels (SOBEK 'lt yz' attributes) are converted into a channel profile, with extra datapoints added through linear interpolation if a given friction range references co-ordinates that do not exist directly in the table. The imported roughness value, if any, will be displayed in the appropriate roughness type column in the Sections editor.

Importing Network Data

SOBEK Import Dialog