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 automatic.
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.
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 properties |
Mouse_MPR_file name = |.\MOUSE_NASSJO\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 document. |
SZ_Coupling = 1 |
1 or 0 to include/exclude SZ<->MIKE URBAN coupling |
OL_Coupling = 1 |
1 or 0 to include/exclude Overland<->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_Manholes section (see below). |
Smooth_SZ_Inflow = 1 Smooth_OL_Inflow = 1 |
Ensures a more smooth calculation 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 fraction of the maximum MIKE URBAN volume. This is used to avoid instabilities due to high pressure. |
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 [Storing_Reaches] section must be specified, and inside this the [Storing_Reach_1], [Storing_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 [Storing_Reaches] section must be specified, and inside this the [Storing_Reach_1], [Storing_Reach_2], ... defining the no. of links and link names for each reach. |
EndSect // MIKESHE_MOUSE_Specifications |
|
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.