Creating a MsheMouse.pfs file

The MsheMouse.pfs file is an ASCII file that includes all of the specifications for the coupling. The following table defines the structure of the file, along with some information on the parameters. When the MIKE URBAN coupling has been added to the user interface, the creation of this file will be auto­matic.

note00035.jpg 

Note: The pfs format must be adhered to exactly. There is a small utility (pfsEditor.exe) in the installation \bin directly that you can use for editing and testing pfs files that you create.

Table 32.1          MsheMouse.pfs file format and description

Line item

Comment

[MIKESHE_MOUSE_Specifications]

FileVersion = 2

 

Link_SZ_Exchange_Option = 2

1 = Leakage coefficient based only on MIKE URBAN pipe leakage coefficient

2 = Leakage coefficient based on a series connection of the MIKE URBAN pipe leakage coefficient and the MIKE SHE aquifer proper­ties

Mouse_MPR_file name = |.\MOUSE_NAS­SJO\handskeryd.mpr|

(See Note below this table)

Name of the MOUSE .mpr file or the MIKE URBAN .mex file.

The MIKEZero file name format ( | | ) indicates that the file name is relative to the location of this docu­ment.

SZ_Coupling = 1

1 or 0 to include/exclude SZ<->MIKE URBAN coupling

OL_Coupling = 1

1 or 0 to include/exclude Over­land<->MIKE URBAN coupling

Dynamic_Coupling = 1

1 for dynamic coupling. Otherwise the initial MIKE URBAN conditions will be used.

Drainage_To_Manholes = 1

1 to include SZ (and paved area) drain to manholes. In this case the SZ drain option must be Levels and Codes (should rather be named Distributed Option). In the areas with drain to MIKE URBAN the Distributed option code must be 4. For each drain code value found in areas with Distributed code 4 a reference from the code to a MIKE URBAN manhole must be defined in the Drainage_Man­holes section (see below).

Smooth_SZ_Inflow = 1

Smooth_OL_Inflow = 1

Ensures a more smooth calcula­tion of flows to MIKE URBAN when the MIKE SHE time steps are large compared to the MIKE URBAN time step. The MIKE URBAN coupling is only made at every integer multiple of the MIKE SHE time step. If the Smooth option is not activated, the flows to MIKE URBAN can stop after a number of MIKE URBAN time steps because the calculated flow volume exceeds the volume of the MIKE SHE SZ/Overland grid cells. The Smooth option tries to use a reduced flow rate which equals the available volume / coupling time.

[Dynamic_Coupling_Specifications]

 

    Limit_Inflow = 0   :             

Specify 1 if the inflow to MIKE URBAN should be limited so the MIKE URBAN volume + inflow does not exceed a specified frac­tion of the maximum MIKE URBAN volume. This is used to avoid instabilities due to high pres­sure.

    Limit_Outflow = 0   :

Specify 1 if the outflow from MIKE URBAN should be limited so the MIKE URBAN volume - outflow doesn't come below a specified fraction of the maximum MIKE URBAN volume. This is used to avoid instabilities due to drying / negative volume.

    [Inflow_Limitations]

        MaxVolFac_Links = 0.99

        MaxVolFac_Manholes = 0.99

     EndSect  // Inflow_Limitations

     [Outflow_Limitations]

        MinVolFac_Links = 0.05

        MinVolFac_Manholes = 0.05

     EndSect  // Outflow_Limitations

The inflow and outflow fractions are specified here:

 

EndSect // Dynamic_Coupling_Specifications

 

No_Of_Storing_reaches = 2

[Storing_Reaches]

     [Storing_Reach_1]

        No_Of_Links = 2

         LinkName_1 = 'Dike_01l1'

         LinkName_2 = 'Dike_03l1'

     EndSect  // Storing_Reach_1

     [Storing_Reach_2]

        No_Of_Links = 1

         LinkName_1 = 'Dike_04l1'

     EndSect  // Storing_Reach_2

EndSect  // Storing_Reaches

When No_Of_Storing_reaches is greater than 0, the [Stor­ing_Reaches] section must be specified, and inside this the [Stor­ing_Reach_1], [Stor­ing_Reach_2], ... defining the no. of links and link names for each reach.

 

[Drainage_Manholes]

     No_Of_DrainCodes = 8

        [Draincode_1]

           Draincode= 12

           ManholeName='DNB3182'

        Endsect // Draincode_1

        .

        .

        Endsect // Draincode_8

EndSect  // Drainage_Manholes

When No_Of_Storing_reaches is greater than 0, the [Stor­ing_Reaches] section must be specified, and inside this the [Stor­ing_Reach_1], [Stor­ing_Reach_2], ... defining the no. of links and link names for each reach.

EndSect // MIKESHE_MOUSE_Specifica­tions

 

 

note00038.jpg 

Note on file names:

The pfs file line item is always “Mouse_MPR_file name =”

When coupling MIKE SHE to an old MOUSE model, the MOUSE file name has the extension “.mpr”.

When coupling MIKE SHE to MIKE URBAN, the equivalent file is the “.mex” file. This file contains all the necessary information for the coupling and is generated automatically by MIKE URBAN.

To create the .mex file, you must start a sewer simulation from MIKE URBAN. However, since the .mex file is only created when the simulation is launched, if you make changes to the sewer network, then you must re-create the .mex file by first restarting the sewer simulation in MIKE URBAN. Otherwise, your changes to the sewer network will not be reflected in the coupled models.