MOUSE Text File Conversion Notes
MOUSE network data can be imported from text files exported by MOUSE, or text files based on the Danish Wastewater Committee's Publication No. 19 (SVK-format).
File Formats
The importer recognises both text format 1 and 2 files with or without line numbering.
If your network contains any L4 elements (conduits using the cross-section database) then if you want to import the cross-section database into shapes it should be appended to the text import file.
Conversions
Section 'D' - Subcatchments
The importer creates a set of land use definitions to match the MOUSE area types. The wastewater profiles and washoff surfaces correspond to the following values in the InfoWorks ICM default wastewater and washoff data.
|
Area code/ Land use ID |
Description |
InfoWorks ICM equivalent |
Wastewater Profile |
Pollution Index |
|---|---|---|---|---|
|
1 |
Green Area |
|
0 |
1 |
|
2 |
Detached housing |
Low density residential |
1 |
1 |
|
3 |
Town houses |
Medium density residential |
3 |
3 |
|
4 |
Semi-detached housing |
High density residential |
5 |
5 |
|
5 |
City |
Commercial |
7 |
7 |
|
6 |
Traffic Areas |
Industrial |
9 |
9 |
|
7 |
Industrial area |
Industrial |
9 |
9 |
The default land use definitions for the MOUSE importer are in mouse.lud in the InfoWorks ICM install folder.
The additional inflow is put into the base flow field of a subcatchment.
The importer creates 7 runoff surfaces to correspond with the 7 surfaces of the extended catchment description. These surfaces are meant to replicate the default characteristics of MOUSE Runoff Model B as closely as possible. All surfaces have absolute initial losses; the initial loss is the sum of the wetting loss and surface storage losses. Surfaces 1-3 are fixed runoff with a runoff coefficient of 1.0. Surfaces 4-7 use the Horton runoff volume model. All surfaces use SWMM routing, because this is equivalent to the non-linear reservoir (kinematic wave) model in Runoff Model B.
|
Area/Runoff Index |
Description |
Initial loss (m) |
F0 (mm/hr) |
Fc (mm/hr) |
K (1/hr) |
Routing(n) |
|---|---|---|---|---|---|---|
|
1 |
Steep roof |
0.00005 |
|
|
|
0.013 |
|
2 |
Flat roof |
0.00065 |
|
|
|
0.014 |
|
3 |
Paved area |
0.00065 |
|
|
|
0.014 |
|
4 |
Semi-pervious, large infiltration |
0.00105 |
2.9 |
2.9 |
5.4 |
0.033 |
|
5 |
Semi-pervious, small infiltration |
0.00105 |
2.9 |
2.9 |
5.4 |
0.033 |
|
6 |
Pervious area, unplanted |
0.00205 |
72.0 |
10.8 |
5.4 |
0.083 |
|
7 |
Pervious area, planted |
0.00205 |
72.0 |
10.8 |
5.4 |
0.083 |
If your data uses the simplified catchment description the percent impervious area is assigned to area 3 (paved area).
The default runoff definitions for the MOUSE importer are in mouse.rpf in the InfoWorks ICM install folder.
Section 'KG1' - circular manholes
The converter sets the chamber and shaft areas to p * (diameter / 2)2.
The converter puts the outlet shape code into user number 1; conduits will use this value to set an appropriate headloss.
The floodable area of the node is set to 1000 times the shaft area.
All nodes are of flood type stored with Flood Depth 1 = 1, Flood Depth 2 = 100, Flood Area 1 = 100 and Flood Area 2 = 100
Section 'KG2' - storage nodes
The converter puts the outlet shape code into the User Number 1 field. Conduits will use this value to set an appropriate headloss.
Section 'KG3' - storage node geometry
The converter ignores vertical cross-section data.
Section 'KF1' - weirs
The converter does not distinguish between transverse (type 1) and side (type 2) weirs.
- If the shape is 1 then the weir is set to type WEIR (sharp-crested)
- If the shape is 2 then the weir is set to type BRWEIR (broad-crested)
The converter subtracts the crest level from each level entry for a head-discharge relationship (method = 3).
The head discharge ID will be the same as the link ID for method = 3.
If <Node 2> is 0 (i.e discharge out of the network) then the converter creates an outfall <Node 1>_out, positions it 1 metre to the right of <Node 1>, and sets its ground level to the same as <Node 1>.
Section 'KF2' - pumps
If the pump characteristic is 1 then pumps are set to type SCRPMP (screw pump)
If the pump characteristic is 2 then pumps are set to type ROTPMP (rotodynamic pump)
The converter subtracts the base level from each level entry for a H,Q relationship (rel = 1). The first entry in an InfoWorks head-discharge table must be for Q = 0; the converter will insert a point in the head-discharge table for Q = 0 if the first flow value in the text file H,Q relation is non-zero.
The head discharge ID will be the same as the link ID.
If <Node 2> is 0 (i.e discharge out of the network) then the converter creates an outfall <Node 1>_out, positions it 1 metre to the right of <Node 1>, and sets its ground level to the same as <Node 1>.
Section 'KU' - outfalls
The converter does not convert the outlet water level; you should create an appropriate level object if you wish to apply any constant levels that are above the outfall invert.
The converter sets the ground level at the outfall to the bottom level.
Section 'L1' - conduits
The converter currently sets the roughness value to the following depending on the material code. These correspond to the MOUSE defaults.
|
Code |
Material |
M |
|---|---|---|
|
1 |
Smooth concrete |
84.7 |
|
2 |
Normal concrete |
75.2 |
|
3 |
Rough concrete |
68.0 |
|
4 |
Plastic |
80.0 |
|
5 |
Iron |
69.9 |
|
6 |
Ceramics |
69.9 |
|
7 |
Stone |
80.0 |
|
8 |
Other |
50.0 |
The converter creates a new user-defined shape, DKEGG, for use with conduits of shape number = 2. The height of these shapes is 1.1475 times the width.
The converter sets the upstream headloss to a fixed headloss dependent on the outlet shape of the upstream node (stored in User Number 1):
|
Outlet |
Headloss coefficient |
|---|---|
|
1 |
0.25 |
|
2 |
0.50 |
|
3 |
0.50 |
|
4 |
0.00 |
|
5 |
0.50 |
|
6 |
0.00 |
The converter sets the downstream headloss to none.
Section 'L2' - conduits (trapezoidal section)
The converter converts L2 elements to corresponding channel sections. The centre of the channel is at (0,0), thus the co-ordinates of the section are (-0.5 * width - angle * height, height), (-0.5 * width, 0), (0.5 * width, 0), and (0.5 * width + angle * height, height).
See L1 for roughness and headloss handling.
Section 'L3' - conduits (arbitrary section)
The converter creates a new conduit and user-defined shape for each element in this section. The shape ID will be the same as the link ID.
The converter creates a symmetric user-defined shape from the depth and width values of the geometry description; it ignores the cross-section area and hydraulic radius.
See L1 for roughness and headloss handling.
Section 'L4' - conduits (cross-section database)
The shape name for each element will be "<database name><cross-section ID>". The converter stores the scale factor in User Number 1.
At present the user needs to create user-defined shapes for any L4 elements after importing the text file.
See L1 for roughness and headloss handling.
Section 'T' - text
The contents of any text records will be added to the description of the network.
