UND File Conversion - Links

Data in the [MOUSE_LINKS] group of the UND file is imported into the InfoWorks ICM Conduit and Channel table. This topic contains details on the conversion of MOUSE links information to InfoWorks ICM.

Links Group - [MOUSE_LINKS]

MOUSE

Description

InfoWorks ICM Data Field

LINKID

Link name

Asset ID

FROMNODE

Upstream Node

US Node ID

TONODE

Downstream Node

DS Node ID

TYPENO

Link Shape:

TYPENO	Shape
1	Circular
2	CRS (Cross Section)
3	Rectangular
4	O-shaped
5	Egg-shaped
6	Square
7	Natural Channel

MOUSE TYPENO is imported into the InfoWorks ICM Shape IDfield as follows:

MOUSE Shape	InfoWorks ICM Shape
Circular	CIRC
CRS	InfoWorks ICM Shape ID field = MOUSE CRSID. (A user defined shape is created for each cross section defined in the CROSS SECTIONS section of the UND file.)
Rectangular	RECT
O-shaped	EGG
Egg-shaped	EGG
Square	RECT
Natural Channel	A channel link is created rather than a conduit. See the TOPOGRAPHYsection for details.

CRSID

Cross Section Name defining geometry of Cross Section Shape pipe.

A user defined Shape is created with Name = MOUSE CRSID.

Data from the CROSS SECTIONS target in the UND file is imported into the Height and Widtharrays of the conduit Shape.

SCALINGTYPENO

Scaling type, used for CRS shape types:

SCALINGTYPENO	Scaling Type
1	Scale
2	Height and Width

Used to determine the values to be exported to the Conduit Widthand Height fields.

See Note on importing MOUSE User Defined Cross Sections below.

DIAMETER

Diameter of circular pipes

Used for circular, O-shape, egg-shape and square types.

Exported to Conduit Width and Heightfields as follows:

MOUSE Shape	InfoWorks ICM Shape	InfoWorks ICM Data Field
Circular	CIRC	Width = DIAMETER Height = DIAMETER
O-shaped	EGG	Width = DIAMETER Height = DIAMETER x 1.125
Egg-shaped	EGG	Width = DIAMETER/1.5 Height = DIAMETER
Square	RECT	Width = DIAMETER Height = DIAMETER

SCALEORWIDTH

Used for CRS and Rectangular shape types.

For Rectangular shapes:

Width of pipe

For CRS shapes:

If Scaling Type = Scale, this is the scale factor used for cross-sections (CRS types).
If Scaling Type = Height&Width, this is the width of the cross-section.

For MOUSE Rectangular sections:

Exported to conduit Widthfield.

For MOUSE CRS shapes:

If Scaling Type = Scale, Widthis calculated as:

Scale Factor x Maximum CRS Width

If Scaling Type = Height and Width, exported directly to Width field

See Note on importing MOUSE User Defined Cross Sections below for more details.

HEIGHT

Used for CRS (scaling type = Height&Width) and Rectangular shape types.

Height of pipe.

Conduit Height

MATERIALNO

Material:

MATERIALNO	Material
1	Smooth Concrete
2	Normal Concrete
3	Rough Concrete
4	Plastic
5	Iron
6	Ceramics
7	Stone
8	Other

If there is no specific roughness defined for the link in theHydraulic Parameters Section, the material number is used to find the default roughness.

Bottom Roughness andTop Roughness are determined by looking up the default roughness value associated with the material type in the Hydraulic Parameters Section of the MOUSE file.

The default roughness value will be overridden if a specific roughness is specified in the Hydraulic Parameters Section.

UPLEVEL

Upstream invert level.

If UPLEVEL is not specified the upstream invert of the upstream node is used.

US Invert Level

If UPLEVEL is not specified, US Invert Levelwill be taken as upstream invert of the upstream node:

Chamber Floor Levelfor InfoWorks ICM Manholes
User Number 2 for other node types

See Nodes topic for further information.

DWLEVEL

Downstream invert level.

If DWLEVEL is not specified the downstream invert of the downstream node is used.

DS Invert Level

If DWLEVEL is not specified, DS Invert Levelwill be taken as downstream invert of the downstream node:

Chamber Floor Levelfor InfoWorks ICM Manholes
User Number 2 for other node types

See Nodes topic for further information.

INFILTRATION

Infiltration into the pipe per unit length

Inflow calculated as:

INFILTRATION x Pipe Length

SPECIFIEDLENGTH

Pipe Length.

If SPECIFIEDLENGTH is not defined, length is calculated based on the coordinates of the connected nodes.

Length

If SPECIFIEDLENGTH is not defined, Lengthfield is set to #D.

RMAPPROACHNO

Specifies whether the pipe is a pressure main or not:

RMAPPROACHNO	Type of Main
1	Normal Link
2	Pressure Main

Solution Model = FULLif normal link, PRESSURE if Pressure Main

TOPOGRAPHYID

Topography ID.

Cross-sections for Natural Channel shape types are defined in the TOPOGRAPHY section.

For natural channels, i.e. InfoWorks ICM Channel links, Cross Section data is read from the TOPOGRAPHY section.

MAXDX

Maximum between cross sections

Not Used.

Note on importing MOUSE User Defined Cross Sections

In MOUSE the cross section data for a user defined shape (Type = CRS) is defined in the CROSS SECTIONS section of the UND file.

Each Cross Section is imported into InfoWorks ICM as a user defined Conduit Shape with height and width values adjusted to fall between 0 and 1.

The values imported into the conduit Heightand Width fields for a user defined cross section will depend on the scaling type used by the MOUSE CRS object:

If the Scaling Type of the MOUSE CRS shape is Scale, the Scale Factor is used in conjunction with the CROSS SECTIONS data to calculate conduit Height and Width:

Height = Scale Factor x Maximum Height

Width = Scale Factor x Maximum Width

Where Maximum Height and Maximum Width are the maximum Processed Data values of the cross section associated with the link.

If the Scaling Type of the MOUSE CRS shape is Height and Width, the MOUSE Height and Width values are imported directly to the InfoWorks ICM conduit Height and Width fields.

Note on Headloss Coefficient calculations

In MOUSE, headloss is calculated at the node inlet and the node outlet. In InfoWorks ICM, headloss is calculated at the conduit ends.

Where the equations used by MOUSE and InfoWorks ICM cannot be directly compared, the InfoWorks ICM Headloss Type and Headloss Coefficient values will be set to default values: Headloss Type = NORMAL, Headloss Coefficient= 1.

Downstream Headloss

Headloss at the downstream end of the conduit in InfoWorks ICM is equivalent to the headloss at the connected node inlet in MOUSE.

The InfoWorks ICM and MOUSE equations are not directly compatible (see below), therefore the InfoWorks ICM downstream headloss type and coefficient are always set to the default values:

Downstream Headloss Type= NORMAL
Downstream Headloss Coefficient= 1

Downstream Headloss Calculations

The headloss calculation used by InfoWorks ICM takes the form:

(1)

Where:

Dh= headloss

ku= user defined headloss factor

ks= surcharge ratio coefficient

kv= velocity coefficient

v = flow velocity (m/s)

g = acceleration due to gravity m/s2

The user specifies the values of kuand the headloss type (None, Normal, High, Fixed or User Defined). The headloss type then determines the values of ks and kv. ku represents the change of flow direction at a manhole.

Headloss at the node inlet in MOUSE, is calculated using the difference in velocity heads between the inlet conduit and the node:

(2)

Where:

DH= headloss

i = inlet conduit

v = velocity m/s

m = manhole or node

Upstream Headloss

Headloss at the upstream end of the conduit in InfoWorks ICM is equivalent to the headloss at the connected node outlet in MOUSE.

In MOUSE the user can specify a shape coefficient (Km), contraction head loss coefficient (Contraction HLC) or a total head loss coefficient (Total HLC) to be used in calculating headloss at the node outlet. Only the case in which the total head loss coefficient is specified is compatible with the InfoWorks ICM equation (see Calculations section below). Therefore:

If the MOUSE headloss coefficient is specified as Kmor Contraction HLC, the InfoWorks ICM downstream headloss type and coefficient are set to the default values:

Downstream Headloss Type= NORMAL
Downstream Headloss Coefficient= 1

If the MOUSE headloss coefficient is specified as Total HLC, the InfoWorks ICMdownstream headloss type and coefficient are set to the following values:

Downstream Headloss Type= FIXED
Downstream Headloss Coefficient= MOUSE Total Headloss Coefficient

MOUSE Headloss Type and Headloss Coefficient are imported to User Text 1 and User Number 1 fields.

See below for further details.

Upstream Headloss Calculations

The headloss calculation used by InfoWorks ICM is the same as the downstream headloss calculation (equation 1).

Headloss at the node outlet in MOUSE is calculated as:

(3)

Where:

DHj= headloss

v = velocity

Vdir(j)= change in flow direction headloss coefficient

Vlevel(j)= change in elevation headloss coefficient

Vcontr(j)= change in contraction at outlet headloss coefficient

MOUSE computes losses due to changes in flow direction and elevation internally. The user can specify losses due to changes in contraction at the outlet or the total head loss coefficient.

Losses due to contraction are calculated using:

(4)

Where:

Km= specified outlet shape coefficient for the node

Am = flow cross sectional area in the node

The user can specify either:

Km
Vcontr(j)
Total headloss coefficient

Total headloss coefficient is calculated as:

(5)

Where:

Vtotal(j)= total headloss coefficient

Vdir(j)= change in flow direction coefficient

Vlevel(j)= change in elevation coefficient

Vcontr(j)= change in contraction at outlet coefficient

Combining equations 1, 3 and 5:

(1)

(3)

(5)

The total head loss coefficient is:

(6)

If a Fixed Headloss Type is specified in InfoWorks ICM, by definition ks and kv are set equal to 1.0 for all conditions and ku is the value specified by the user. Thus equation 6 becomes:

(7)

Where InfoWorks ICM Headloss Type = Fixed

UND File Conversion

MOUSE PFS File Conversion Notes