Difference between revisions of "Flood Modeller Tutorial Module01"

From Tuflow
Jump to navigation Jump to search
 
(97 intermediate revisions by 7 users not shown)
Line 2: Line 2:
 
In this module we will link an existing 2D TUFLOW domain to an existing Flood Modeller 1D model. The 2D TUFLOW domain will represent the floodplain in the study area, and the 1D Flood Modeller model will represent the watercourse and all online structures. <br>
 
In this module we will link an existing 2D TUFLOW domain to an existing Flood Modeller 1D model. The 2D TUFLOW domain will represent the floodplain in the study area, and the 1D Flood Modeller model will represent the watercourse and all online structures. <br>
  
1D-2D linked models are able to utilise the individual benefits of 1D and 2D solution schemes. In this example, the 1D Flood Modeller scheme is used to represent the watercourses where the flow is essentially one-directional. A 2D scheme is suited to the representation of floodplains where a more detailed flow patterns may occur. <br>
+
1D-2D linked models are able to utilise the individual benefits of 1D and 2D solution schemes. In this example, the 1D Flood Modeller scheme is used to represent the watercourses where the flow is essentially uni-directional. A 2D scheme is suited to the representation of floodplains where more complex flow patterns may occur. <br>
 
<br>
 
<br>
As [[Tutorial_Module01#Reviewing_Model_Performance | discussed in Module 1]], the main creek channel is not very well represented using the 5m 2D cell size. In parts, the creek is only 5-10m wide and the 5m cell size could be considered too coarse to accurately represent the creek topography. Refer to the below figure.<br>
+
As [[Tutorial_Module01_Archive#Reviewing_Model_Performance | discussed in Module 1 of the TUFLOW Tutorial Model]], the main watercourse channel is not very well represented using the 5m 2D cell size. In parts, the watercourse is only 5-10m wide and the 5m cell size could be considered too coarse to accurately represent the watercourse topography.<br>
 
[[file:Poor_2d_rep.png|400px]]<br>
 
[[file:Poor_2d_rep.png|400px]]<br>
Using a cell size that is coarse relative to the width of the creek channel may reduce the accuracy of the conveyance in the channel and introduce a source of mass error to the model.  There are two options for improving the representation of the creek channel:<br>
+
Using a cell size that is coarse relative to the width of the watercourse channel may reduce the accuracy of the conveyance in the channel.  There are two options for improving the representation of the creek channel:<br>
 
* decrease the width of the 2D cells; and/or
 
* decrease the width of the 2D cells; and/or
 
* model the channel as a 1D network, dynamically linked to the 2D domain (the floodplain).
 
* model the channel as a 1D network, dynamically linked to the 2D domain (the floodplain).
In the [[Tutorial_Module01#Advanced_.28Optional.29 | optional section of module 1]], we looked at reducing the cell size to get a better representation of the channel. In this module we will adopt the second approach of modelling the creek as 1D elements in Flood Modeller.<br>
+
In the [[Tutorial_Module01_Archive#Advanced_-_Model_Resolution_.28Optional.29 | optional section of Module 1 of the TUFLOW Tutorial Model]], we looked at reducing the cell size to get a better representation of the channel. In this module we will adopt the second approach of modelling the creek as 1D elements using Flood Modeller.<br>
<br>
+
 
 
TUFLOW may be dynamically linked to 1D networks using the hydrodynamic solutions of ESTRY (TUFLOW 1D), Flood Modeller (previously ISIS), XP-SWMM and 12D Solutions’ Dynamic Drainage.<br>
 
TUFLOW may be dynamically linked to 1D networks using the hydrodynamic solutions of ESTRY (TUFLOW 1D), Flood Modeller (previously ISIS), XP-SWMM and 12D Solutions’ Dynamic Drainage.<br>
Setting up a 1D/2D model where the 1D channel cuts through the 2D domain is probably the most time-consuming type of a model to setup.  However, the reduction in simulation time can be beneficial and make this a good approach.  For this module, the complete Flood Modeller 1D model has been provided, so you can progress through the module in a relatively short period of time.<br>
+
 
 +
Setting up a 1D/2D model where the 1D channel cuts through the 2D domain is probably the most time-consuming type of a model to setup.  However, the reduction in simulation time can be beneficial and make this a good approach.  For this module, the complete Flood Modeller 1D model has been provided, to allow for progressing through the module in a relatively short period of time.<br>
  
 
=Existing Model Data=
 
=Existing Model Data=
This tutorial builds upon the 2D TUFLOW domain that was constructed as part of [[Tutorial Module01|Module 1]] and [[Tutorial Module02|Module 2]] of the TUFLOW Tutorial Models.<br>
+
This tutorial builds upon the 2D TUFLOW domain that was constructed as part of [[Tutorial Module01_Archive|Module 1]] and [[Tutorial Module02_Archive|Module 2]] of the TUFLOW Tutorial Model.<br>
The model developed in these tutorial modules already contains some culverts modelled as 1D elements. The culverts are modelled in ESTRY, TUFLOW's internal 1D engine. One of these culverts will be kept in ESTRY and the other will be changed to Flood Modeller.<br>
+
The model developed in these tutorial modules already contains some culverts modelled as 1D elements. The culverts are modelled in ESTRY, TUFLOW's internal 1D engine. One of these culverts will be kept in ESTRY and the other will be added to the Flood Modeller model.<br>
 
The 2D boundary conditions (upstream inflows and downstream stage-discharge boundary) will be removed from the model. These will instead be represented in Flood Modeller as it is a more typical schematisation for a 1D/2D linked model.<br>
 
The 2D boundary conditions (upstream inflows and downstream stage-discharge boundary) will be removed from the model. These will instead be represented in Flood Modeller as it is a more typical schematisation for a 1D/2D linked model.<br>
 
The existing TUFLOW model consists of:
 
The existing TUFLOW model consists of:
Line 24: Line 25:
 
*1D/2D boundary links to connect the 1D ESTRY culverts to the 2D TUFLOW domain.
 
*1D/2D boundary links to connect the 1D ESTRY culverts to the 2D TUFLOW domain.
  
If you need more information on these elements, we recommend that you work through [[Tutorial Module01|Module 1]] and [[Tutorial Module02|Module 2]].
+
For further information on these elements, please refer to [[Tutorial Module01_Archive|Module 1]] and [[Tutorial Module02_Archive|Module 2]] of the TUFLOW Tutorial Model.
  
 
==Flood Modeller==
 
==Flood Modeller==
Line 33: Line 34:
 
*<b>IEF</b>: A blank folder in which to store Flood Modeller Event Files used to simulate the model.  
 
*<b>IEF</b>: A blank folder in which to store Flood Modeller Event Files used to simulate the model.  
 
*<b>RES</b>: A blank folder in which to write the Flood Modeller result files.
 
*<b>RES</b>: A blank folder in which to write the Flood Modeller result files.
For further information on each file type, please refer to the [http://help.floodmodeller.com/floodmodeller/ Flood Modeller User Manual].<br>
+
For further information on each file type, please refer to the [https://help.floodmodeller.com/docs Flood Modeller User Manual].<br>
 
For this tutorial, the floodplain of the study area will be modelled entirely in TUFLOW.  
 
For this tutorial, the floodplain of the study area will be modelled entirely in TUFLOW.  
 
The cross-sections in the Flood Modeller 1D model have been trimmed to the top of bank to ensure there is no double-counting of storage within the floodplain.  
 
The cross-sections in the Flood Modeller 1D model have been trimmed to the top of bank to ensure there is no double-counting of storage within the floodplain.  
Upstream and downstream boundary data is contained separately within the IED files. These will be referenced and linked to the Flood Modeller 1D model via the IEF 1D simulation file.
+
Upstream and downstream boundary data is contained separately within the IED files. These will be referenced and linked to the Flood Modeller 1D model via the IEF simulation file.
  
 
=GIS and Model Inputs=
 
=GIS and Model Inputs=
The steps necessary to modify each of the GIS inputs are demonstrated in MapInfo, ArcGIS and QuantumGIS (QGIS). At each stage please select your GIS package to view relevant instructions.
+
The steps necessary to modify each of the GIS inputs are demonstrated in MapInfo, ArcGIS and QGIS. At each stage please select your GIS package to view relevant instructions.
  
 
==Define the External 1D Networks==
 
==Define the External 1D Networks==
This part of the module creates the GIS layers that specify the geographic location of the Flood Modeller nodes that are to be connected to the 2D domain. Follow the instructions below for your preferred GIS package.
+
This part of the module creates the GIS layers that specify the location of the Flood Modeller nodes that are to be connected to the 2D domain. Follow the instructions below for your preferred GIS package.
 
* [[FM Tute M01_ARC_x1D_Nodes | ArcGIS]]
 
* [[FM Tute M01_ARC_x1D_Nodes | ArcGIS]]
 
* [[FM Tute M01_MI_x1D_Nodes  | MapInfo]]
 
* [[FM Tute M01_MI_x1D_Nodes  | MapInfo]]
Line 68: Line 69:
 
Now that we have made all of the necessary changes to the GIS layers, we need to update the TUFLOW control files and Flood Modeller Simulation Files to create a linked model.
 
Now that we have made all of the necessary changes to the GIS layers, we need to update the TUFLOW control files and Flood Modeller Simulation Files to create a linked model.
 
==TUFLOW Control Files==
 
==TUFLOW Control Files==
==TCF File==
+
==TUFLOW Geometry Control File==
 +
We will first update the TUFLOW Geometry Control (TGC) file. The following changes have been changes made to the geometry:
 +
* We have deactivated the cells along the watercourse which are represented in the 1D Flood Modeller component of the model
 +
* We have enforced bank elevations along the watercourse.
 +
<br>
 
<ol>
 
<ol>
<li> Firstly save a copy of the TUFLOW file created as a part of module 2 ('''M02_5m_001.tcf''') as '''FMT_M01_001.tcf'''. </li>
+
<li> In the '''FMT_Tutorial\FMT_M01\TUFLOW\model''' folder, save a copy of <b>M01_5m_002.tgc</b> as <b>FMT_M01_001.tgc</b>. </li>
 +
<li> Open <b>FMT_M01_001.tgc</b><br>
 +
 
 +
'''Mapinfo'''<br>
 +
Add an extra command line after <font color="blue"><tt> Read GIS Code </tt></font><font color="red"><tt>==</tt></font>..\model\mi\2d_code_FMT_M01_001_R.MIF </li>
 +
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_FMT_M01_HX_001_R.MIF<font color="green"><tt> ! Deactivates the cells where the watercourse has been modelled in 1D </tt></font>
 +
 
 +
Note that the order of the commands is important. The layer '''2d_code_FMT_M01_001.MIF''' first activates cells within the modelled area then the layer '''2d_bc_FMT_M01_HX_001_R.MIF''' deactivates selected cells along the watercourse.  
 +
 
 +
'''Other GIS'''<br>
 +
Add an extra command line after <font color="blue"><tt> Read GIS Code </tt></font><font color="red"><tt>==</tt></font>..\model\gis\2d_code_FMT_M01_001_R.shp
 +
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_FMT_M01_HX_001_R.shp <font color="green"><tt> ! Deactivates the cells where the watercourse has been modelled in 1D </tt></font>
  
 +
Note that the order of the commands is important. The layer '''2d_code_FMT_M01_001_R.shp''' first activates cells within the modelled area then the layer '''2d_bc_FMT_M01_HX_001_R.shp''' deactivates selected cells along the watercourse.
  
<li> We need to remove the simulation time control commands (shown below) which specify timestep, start time and end time from the tcf and move them to an IEF file. <br>
+
<li> Topography amendments should be added in a new section at the bottom of the TGC. These are: </li>
 +
'''Mapinfo'''<br>
 +
:<font color="blue"><tt>Read GIS Z HX Line MAX </tt></font> <font color="red"><tt>==</tt></font> mi\2d_bc_FMT_M01_HX_001_L.MIF | mi\2d_bc_FMT_M01_HX_001_P.MIF <font color="green"><tt>! Defines the bank crest levels (1D/2D boundary cell elevations). The 'MAX' option prevents any zpt elevations from being lowered </tt></font>
 +
The two GIS layers must be read in together on the same command line. This tells TUFLOW to associate the points within the '''2d_bc_FMT_M01_HX_001_P.MIF''' layer (defining elevation) with the polylines within the '''2d_bc_FMT_M01_HX_001_L.MIF''' layer (defining bank location).  
  
<font color="green"><tt>! SIMULATION TIME CONTROL COMMANDS </tt></font>
+
'''Other GIS'''<br>
:<font color="blue"><tt>Timestep </tt></font> <font color="red"><tt>== </tt></font> 1.<font color="green"><tt>! Specifies a 2D computational timestep of 1.5 seconds </tt></font>
+
:<font color="blue"><tt>Read GIS Z HX Line MAX </tt></font> <font color="red"><tt>==</tt></font> gis\2d_bc_FMT_M01_HX_001_L.shp | gis\2d_bc_FMT_M01_HX_001_P.shp <font color="green"><tt>! Defines the bank crest levels (1D/2D boundary cell elevations). The 'MAX' option prevents any zpt elevations from being lowered </tt></font>
:<font color="blue"><tt>Start time </tt></font> <font color="red"><tt>== </tt></font> 0  <font color="green"><tt>! Specifies a simulation start time of 0 hours </tt></font>
+
The two GIS layers must be read in together on the same command line. This tells TUFLOW to associate the points within the '''2d_bc_FMT_M01_HX_001_P.shp''' layer (defining elevation) with the polylines within the '''2d_bc_FMT_M01_HX_001_L.shp''' layer (defining bank location).
:<font color="blue"><tt>End Time </tt></font> <font color="red"><tt>== </tt></font>3    <font color="green"><tt>! Specifies a simulation end time of 3 hours </tt></font> </li>
 
  
 +
<li> Save the file. The geometry control file is now ready to be used.
 +
</ol>
  
 +
==TUFLOW Boundary Condition Control File==
 +
We will now update the TUFLOW Boundary Condition control file (tbc) to reference the model boundary files created in previous steps.
 +
<li> Add the 1D/2D boundaries that link the Flood Modeller open channel to the 2D floodplain</li>
 +
<li> Update the 1D/2D boundaries which link the ESTRY culverts to the 2D floodplain, as some of these culverts are now modelled in Flood Modeller</li>
 +
<li> Remove the external inflows applied to the TUFLOW model, as these are now applied in Flood Modeller</li>
  
<li> Delete the 1D Domain commands (shown below) from the tcf. These commands should be moved to the ecf. This an optional step. <br>
+
<ol>
 +
<li> Open '''M02_5m_001.tbc''' and save a copy as '''FMT_M01_001.tbc'''.
 +
<li> Remove the boundary linking to the TUFLOW inflows by:<br>
 +
'''Mapinfo'''
 +
:Put an exclamation mark before the line reading. This tells TUFLOW to treat this command line as a comment:<br>
 +
:<font color="blue"><tt>Read GIS BC</tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_M01_002_L.MIF
 +
'''Other GIS'''
 +
:Put an exclamation mark before the line reading:<br>
 +
:<font color="blue"><tt>Read GIS BC</tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_M01_002_L.SHP
  
<font color="green"><tt>!1D DOMAIN COMMANDS </tt></font>
+
<li> Update the 1D/2D boundary links at the ESTRY culverts  with the new layer:</li>
:<font color="blue"><tt>Start 1D Domain </tt></font> <font color="green"><tt>! Indicates the start of a block of 1D or ecf (Estry Control File) commands </tt></font> <br>
+
'''Mapinfo'''
:<font color="blue"><tt>Output Folder </tt></font> <font color="red"><tt>== </tt></font> ..\results\M02\1d <font color="green"><tt>! Specifies the location of the 1D output files </tt></font>
+
:<font color="blue"><tt>Read GIS BC</tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_M04_culverts_001_L.MIF <font color="green"><tt>! This command reads in SX boundaries linking the 1D ESTRY culverts to the 2D domain</tt></font>
:<font color="blue"><tt>Write Check Files </tt></font> <font color="red"><tt>== </tt></font> ..\check\1d\ <font color="green"><tt>! Specifies the location of the 1D check files and prefixes them with the .tcf filename </tt></font>
+
'''Other GIS'''
:<font color="blue"><tt>Output Interval (s) </tt></font> <font color="red"><tt>== </tt></font> 180 <font color="green"><tt>! Writes the 1D output every 3 minutes. Note the (s) is required to indicate the value is in seconds </tt></font>
+
:<font color="blue"><tt>Read GIS BC</tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_M04_culverts_001_L.shp <font color="green"><tt>! This command reads in SX boundaries linking the 1D ESTRY culverts to the 2D domain</tt></font>
:<font color="blue"><tt>Timestep  </tt></font> <font color="red"><tt>== </tt></font> 0.75 <font color="green"><tt>! Specifies a 1D computational timestep of 0.75 seconds. We will set the 1D timestep to be half the 2D timestep</tt></font>
 
:<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> ..\model\gis\1d_nwk_M02_culverts_001_L.shp <font color="green"><tt>! Reads the 1d_nwk GIS layer defining culverts within the model</tt></font>
 
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font>..\model\gis\1d_nwk_M02_culverts_001_P.shp <font color="green"><tt>! Reads the 1d_nwk GIS layer defining nodes used to create automatic SX 1D/2D boundaries</tt></font>
 
<font color="blue"><tt>End 1D Domain</tt></font>  </li>
 
  
<li> We need to add the Flood modeller commands, these are: <br> </li>
+
<li> Add reference to the 1D/2D boundary links that connect Flood Modeller to the 2D floodplain:</li>
'''Mapinfo'''<br>
+
'''Mapinfo'''
:<font color="blue"><tt>Read GIS X1D Nodes</tt></font> <font color="red"><tt>== </tt></font>..\model\mi\1d_x1d_FMT_M01_nodes_001.MIF <font color="green"><tt>! GIS layer referencing node IDs from Flood Modeller </tt></font>
+
:<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_FMT_M01_HX_001_p.MIF | mi\2d_bc_FMT_M01_HX_001_L.MIF<font color="green"><tt>! This command reads in HX boundaries linking the 1D Flood Modeller watercourse to the 2D domain</tt></font>
:<font color="blue"><tt>Read GIS X1D Network</tt></font> <font color="red"><tt>== </tt></font>..\model\mi\1d_x1d_FMT_M01_nwk_001.MIF <font color="green"><tt>! GIS layer representing channels to allow for the digitisation of Water Level Lines (optional)</tt></font>
+
'''Other GIS'''
:<font color="blue"><tt>Read GIS X1D WLL</tt></font> <font color="red"><tt>== </tt></font> ..\model\mi\1d_x1d_WLL_FMT_M01_001.MIF <font color="green"><tt>! GIS layer containing WLLs for visualising 1D results in 2D</tt></font>
+
:<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_FMT_M01_HX_001_p.shp | gis\2d_bc_FMT_M01_HX_001_L.shp <font color="green"><tt>! This command reads in HX boundaries linking the 1D Flood Modeller watercourse to the 2D domain</tt></font>
  
 +
<li> Save the file. The boundary control file is now ready to be used.
 +
</ol>
  
'''Other GIS'''<br>
+
==TUFLOW Control File==
:<font color="blue"><tt>Read GIS X1D Nodes</tt></font>  <font color="red"><tt>== </tt></font>..\model\gis\1d_x1d_FMT_M01_nodes_001_p.shp <font color="green"><tt>! GIS layer referencing node IDs from Flood Modeller </tt></font>
+
Finally, we need to edit the TUFLOW control file (.tcf). We will:
:<font color="blue"><tt>Read GIS X1D Network</tt></font> <font color="red"><tt>== </tt></font>..\model\gis\1d_x1d_FMT_M01_nwk_001_L.shp <font color="green"><tt>! GIS layer representing channels to allow for the digitisation of Water Level Lines (optional)</tt></font>
+
<li> Remove reference to model parameters that will be read in from Flood Modeller</li>
:<font color="blue"><tt>Read GIS X1D WLL</tt></font> <font color="red"><tt>== </tt></font> ..\model\gis\1d_x1d_WLL_FMT_M01_001_p.shp <font color="green"><tt>! GIS layer containing WLLs for visualising 1D results in 2D</tt></font>
+
<li> Read in the GIS layer of the Flood Modeller Nodes </li>
 +
<li> Read in the GIS layers to create Water Level Lines along the Flood Modeller component of the model (optional) </li>
 +
<li> Add a reference to the ESTRY Control File
 +
<li> Update reference to the boundary control file (.tbc) and geometry control file </li>
 +
<br>
 +
<ol>
 +
<li> In the \FMT_Tutorial\FMT_M01\TUFLOW\runs folder, save a copy of the TUFLOW file created as a part of module 2 ('''M02_5m_001.tcf''') as '''FMT_M01_001.tcf'''. </li>
  
<li> This concludes the changes that we need to make to the .tcf, but before we run the model we need to update the .ecf, .tgc, .tbc and bc_dbase files. </li>
+
<li> In a linked Flood Modeller - TUFLOW model, the Start Time, End Time and 2D Timestep are read from the Flood Modeller .ief file. It is best practice to therefore remove these parameters from the tcf. And an exclamation mark in front of each of the below commands.<br>  
  
==TGC File==
+
<font color="green"><tt>! SIMULATION TIME CONTROL COMMANDS </tt></font>
There have been changes made to the geometry:
+
:<font color="blue"><tt>Timestep </tt></font> <font color="red"><tt>== </tt></font> 1.5  <font color="green"><tt>! Specifies a 2D computational timestep of 1.5 seconds </tt></font>
* We have added a third model grid command.
+
:<font color="blue"><tt>Start time </tt></font> <font color="red"><tt>== </tt></font> 0  <font color="green"><tt>! Specifies a simulation start time of 0 hours </tt></font>
*We have added topography amendments.
+
:<font color="blue"><tt>End Time </tt></font> <font color="red"><tt>== </tt></font>3    <font color="green"><tt>! Specifies a simulation end time of 3 hours </tt></font> </li>
  
<li> Open FMT_M01_001.tgc or navigate to the correct tab.
+
<li> We need to read in the GIS layers of the Flood Modeller Nodes. Place the below command line anywhere in the .tcf. It is good practice to create a section within the .tcf to reference all 1D commands: <br> </li>
Add an extra line in <font color="green"><tt> ! Model Grid Commands </tt></font> reading: </li>
 
 
'''Mapinfo'''<br>
 
'''Mapinfo'''<br>
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_FMT_M01_001_HX_001.MIF<font color="green"><tt> ! Deactivates the cells where the creek channel has been modelled in 1D </tt></font>
+
:<font color="blue"><tt>Read GIS X1D Nodes</tt></font> <font color="red"><tt>== </tt></font>..\model\mi\1d_x1d_FMT_M01_nodes_001_P.MIF <font color="green"><tt>! GIS layer referencing node IDs from Flood Modeller </tt></font>
 +
'''Other GIS'''<br>
 +
:<font color="blue"><tt>Read GIS X1D Nodes</tt></font>  <font color="red"><tt>== </tt></font>..\model\gis\1d_x1d_FMT_M01_nodes_001_P.shp <font color="green"><tt>! GIS layer referencing node IDs from Flood Modeller </tt></font>
  
 +
<li> Add commands to read in the GIS layers referencing Water Level Lines drawn along the Flood Modeller component of the model: <br> </li>
 +
'''Mapinfo'''<br>
 +
:<font color="blue"><tt>Read GIS X1D Network</tt></font> <font color="red"><tt>== </tt></font>..\model\mi\1d_x1d_FMT_M01_nwk_001_L.MIF <font color="green"><tt>! GIS layer representing channels to allow for the digitisation of Water Level Lines (optional)</tt></font>
 +
:<font color="blue"><tt>Read GIS X1D WLL</tt></font> <font color="red"><tt>== </tt></font> ..\model\mi\1d_x1d_WLL_FMT_M01_001_L.MIF <font color="green"><tt>! GIS layer containing WLLs for visualising 1D results in 2D (optional)</tt></font>
 
'''Other GIS'''<br>
 
'''Other GIS'''<br>
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_FMT_M01_001_HX_001_p.shp | 2d_bc_FMT_M01_HX_001_L.shp <font color="green"><tt> ! Deactivates the cells where the creek channel has been modelled in 1D </tt></font>
+
:<font color="blue"><tt>Read GIS X1D Network</tt></font> <font color="red"><tt>== </tt></font>..\model\gis\1d_x1d_FMT_M01_nwk_001_L.shp <font color="green"><tt>! GIS layer representing channels to allow for the digitisation of Water Level Lines (optional)</tt></font>
 +
:<font color="blue"><tt>Read GIS X1D WLL</tt></font> <font color="red"><tt>== </tt></font> ..\model\gis\1d_x1d_WLL_FMT_M01_001_L.shp <font color="green"><tt>! GIS layer containing WLLs for visualising 1D results in 2D (optional)</tt></font>
  
<li> Topography amendments should be added in a new section. These are: </li>
+
<li> Add commands to read in the an Esty Control File which contains references to some of the culverts present on the floodplain: <br> </li>
'''Mapinfo'''<br>
+
:<font color="blue"><tt>ESTRY Control File</tt></font> <font color="red"><tt>== </tt></font>..\model\FMT_M01_001.ecf <font color="green"><tt>!Reference the ESTRY Control File </tt></font>
:<font color="green"><tt> ! Read GIS Z Shape </tt></font> <font color="red"><tt>==</tt></font> mi\2d_zsh_M03_thalweg_001.MIF <font color="green"><tt> ! This GIS layer is commented out / removed from the model as the creek channel has been modelled in 1D </tt></font>
 
:<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>==</tt></font> mi\2d_zsh_M03_Rd_Crest_001.MIF<font color="green"><tt> ! GIS layer used to define the road crest </tt></font>
 
:<font color="blue"><tt>Read GIS Z HX Line MAX </tt></font> <font color="red"><tt>==</tt></font> mi\2d_bc_FMT_M01_HX_001.MIF<font color="green"><tt>! Defines the bank crest levels (1D/2D boundary cell elevations). The 'MAX' option prevents any zpt elevations from being lowered </tt></font>
 
  
'''Other GIS'''<br>
+
<li> Finally, update the links to the Geometry control file, the Boundary Condition control file and the bc_dbase file:</li>
:<font color="green"><tt> ! Read GIS Z Shape </tt></font> <font color="red"><tt>==</tt></font> gis\2d_zsh_M03_thalweg_001.shp <font color="green"><tt> ! This GIS layer is commented out / removed from the model as the creek channel has been modelled in 1D </tt></font>
+
:<font color="blue"><tt>Geometry Control File</tt></font> <font color="red"><tt>== </tt></font>..\model\FMT_M01_001.tgc
:<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>==</tt></font> gis\2d_zsh_M03_Rd_Crest_001_L.shp | gis\2d_zsh_M03_Rd_Crest_001_P.shp <font color="green"><tt> ! GIS layer used to define the road crest </tt></font>
+
:<font color="blue"><tt>BC Control File</tt></font> <font color="red"><tt>== </tt></font>..\model\FMT_M01_001.tbc
:<font color="blue"><tt>Read GIS Z HX Line MAX </tt></font> <font color="red"><tt>==</tt></font> gis\2d_bc_FMT_M01_HX_001_L.shp | gis\2d_bc_FMT_M01_HX_001_p.shp <font color="green"><tt>! Defines the bank crest levels (1D/2D boundary cell elevations). The 'MAX' option prevents any zpt elevations from being lowered </tt></font>
+
:<font color="blue"><tt>BC Database</tt></font> <font color="red"><tt>== </tt></font>..\bc_dbase\bc_dbase_FMT_M01.csv
  
<li> Save the file. The geometry file is now ready to be used.
+
This concludes the changes that we need to make to the .tcf
 +
</ol>
  
==TBC File==
+
==Flood Modeller Simulation Files==
<li> Open '''FMT_M01_001.tbc''' or navigate to the correct tab.</li>
+
In the FMT_M01\Flood_Modeller folder, we have provided a complete Flood Modeller model. It is located in the DAT, IED and IEF folders.<br>
 +
The DAT and IED files are complete and will not require any modification to link to TUFLOW.<br>
 +
However, we will alter the IEF to create the link. The IEF alterations can be done either in a text editor of your choice or using the Flood Modeller Interface.<br>
 +
The instructions below have been written for the Flood Modeller Interface version 4.2.<br>
  
 +
==IEF File==
 +
<ol>
 +
<li> Open Flood Modeller. Select 'Load 1D Network'. Navigate to '''\FMT_Tutorial\FMT_M01\Flood_Modeller\DAT''' and load the '''FMT_M01_001.dat'''.</li>
 +
<li> Right click 'Event Data' and select 'Add Item'. Navigate to '''\FMT_Tutorial\FMT_M01\Flood_Modeller\IED''' and load the '''FMT_Inflows.IED'''.</li>
 +
[[file:FMT Load1Dnwk.JPG|500px]]
 +
<li> On the 'Simulation' tab, click New 1D Simulation. Save the file when prompted in the '''\FMT_Tutorial\FMT_M01\Flood_Modeller\IEF''' folder as'''FMT_M01_001.ief'''</li>
 +
<li> On the 'Files' Tab of the simulation window, set the following parameters:</li>
 +
*Event Title: FMT_M01_001
 +
*1D Data File: The full path to the \FMT_Tutorial\FMT_M01\Flood_Modeller\DAT\FMT_M01_001.dat
 +
*Use Initial Conditions from: Network File (.dat)
 +
*Results File: the full path to \FMT_Tutorial\FMT_M01\Flood_Modeller\RES\FMT_M01_001
 +
<li>To the right of the Event Data box, click Add and select the '''FMT_Inflows.IED''' file in the '''\FMT_Tutorial\FMT_M01\Flood_Modeller\IED''' folder.</li>
 +
[[file:FMT Simulation files.JPG|500px]]
 +
<li>On the 'Times' tab, we will replace the simulation time parameters that were removed from TUFLOW. Enter the following parameters:</li>
 +
*Run Type: Unsteady (Fixed Timestep)
 +
*Start Time (hrs): 0
 +
*Finish Time (hrs): 3
 +
*Timestep (s):1
 +
*Save Interval (s): 300
 +
[[file:FMT Simulation times.JPG|500px]]
 +
<li> Add the 'Links' tab by clicking View> Tabs > Links. On the 'Links' tab, enter the following parameters:
 +
*2-d Scheme: TUFLOW
 +
*2-d Timestep: 2
 +
*2-d control file: full path to the '''FMT_M01_001.tcf''' from the '''\FMT_Tutorial\FMT_M01\TUFLOW\runs''' folder
 +
[[file:FMT Simulation links.JPG|500px]]
 +
<li> Add the 'Additional Output' tab by clicking View> Tabs > Additional Output. On the 'Additional Output' tab, select the check box for '2D Flow...'. This will add extra output to check the Flood Modeller and TUFLOW link. We will review this additional output in the following section.</li>
 +
<li> Save the Scenario Data. </li>
 +
</ol>
  
<li> We need to add the internal 1D/2D boundaries. We need to update the culvert boundaries and include the HX boundaries for the open channel sections. </li>
+
=Run the Simulation=
 +
There are a number of different methods in which to start a Flood Modeller – TUFLOW model. Please refer to the [[Running_linked_Flood_Modeller_-_TUFLOW_Models | following page]] for a detailed discussion on each of these methods. <br>
 +
Use your preferred method to start the model <b>FMT_M01_001.ief</b> or follow the guidance below. If the simulation fails to start, please refer to the troubleshooting guidance on this page. <br>
 +
<br>
 +
In the <b>Complete_Model\FMT_M01\Flood_Modeller\IEF</b> folder a batch file has been provided. To use the batch file in this tutorial:<br>
 +
*Ensure that you [https://wiki.tuflow.com/Running_linked_Flood_Modeller_-_TUFLOW_Models set up the installation folders].
 +
*Move the batch file to the  <b>FMT_Tutorial\FMT_M01\Flood_Modeller\IEF</b> folder
 +
*Open the batch file in a text editor. On the 'set FloodModeller=' line, change the path from the one provided to the full path to the ISISf32.exe file that you set up with the installation folders.
 +
*Save and close the file
 +
*Double click the batch file in your file explorer to run the file
 +
<br>
 +
When the simulation is running, the Flood Modeller status window will open. Flood Modeller will then open a tab with the TUFLOW output. <br>
 +
[[file:FMP_Sim_Screen.png|500px]]<br>
 +
The simulation will take a few minutes depending on the hardware setup.<br>
 +
<br>
  
* The 1D/2D boundaries we need to add are
+
=Review the Results=
'''Mapinfo'''
+
Modelled results can be processed, reviewed and visualised in many different packages.<br>
:<font color="blue"><tt>Read GIS BC</tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_M04_culverts_001.MIF <font color="green"><tt>! This command reads in SX boundaries linking the 1D ESTRY culverts to the 2D domain</tt></font>
+
For a complete introduction to the different options, [[Tutorial_Module01_Archive#Viewing_Results | refer to Tutorial Module 1]]. <br>
:<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> mi\2d_bc_FMT_M01_HX_001.MIF <font color="green"><tt>! This command reads in HX boundaries linking the 1D Flood Modeller watercourse to the 2D domain</tt></font>
+
<br>
  
'''Other GIS'''
+
==TUFLOW HPC==
:<font color="blue"><tt>Read GIS BC</tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_M04_culverts_001_L.shp <font color="green"><tt>! This command reads in SX boundaries linking the 1D ESTRY culverts to the 2D domain</tt></font>
 
:<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> gis\2d_bc_FMT_M01_HX_001_p.shp | 2d_bc_FMT_M01_HX_001_P_L.shp <font color="green"><tt>! This command reads in HX boundaries linking the 1D Flood Modeller watercourse to the 2D domain</tt></font>
 
  
<li> Save the file. The boundary file is now ready to be used.
+
To run the linked TUFLOW-Flood Modeller Pro model using HPC we simply need to add a single line to the Tuflow Control File. The HPC solver will only speed up the 2D calculations within the linked 1D-2D model, it will not speed up the 1D calculations that take place in the Flood Modeller Engine.
 +
The relatively small nature of this specific model means that use of HPC on multiple CPU cores may not lead to significant improvements to model run times.  However, should the machine have an NVIDIA GPU card present then it is possible to run the HPC solver on the GPU to significantly improve model runs times.  The larger the 2D domain, the more significant the improvements to model run times through the use of the HPC solver.
 +
To utilise the HPC solver:-
  
==Flood Modeller Simulation Files==
+
<ol>
==IEF File==
+
<li> Save the TUFLOW runfile ( <b>FMT_M01_001.tcf</b>) as <b>FMT_M01_002.tcf</b>.</li>
  
=Run the Simulation=
+
<li> Add the following command to the TCF file:
There are a number of different methods in which to start a Flood Modeller – TUFLOW model. Please refer to the [[Running_linked_Flood_Modeller_-_TUFLOW_Models | following page]] for a detailed discussion on each of these methods.
+
:<font color="blue"><tt> Solution Scheme </tt></font> <font color="red"><tt>== </tt></font>HPC <font color="green"><tt>! Use HPC solver to run the simulation</tt></font>
Using your preferred method, start the model FMT_0100F_001.ief. If the simulation fails to start, please refer to the troubleshooting guidance on this page. <br>
+
<li> If you have a CUDA enabled NVIDIA GPU device, you can also add the following command to run the HPC solver using GPU hardware:
 +
:<font color="blue"><tt> Hardware </tt></font> <font color="red"><tt>== </tt></font>GPU <font color="green"><tt>! Run HPC solver on GPU</tt></font>
 +
<li> Save the TCF file and run the model.Troubleshooting for GPU Simulation
 +
</ol>
 +
===Troubleshooting for GPU Simulation===
 +
If you receive the following error when trying to run the TUFLOW HPC model using GPU hardware:
 +
<pre>TUFLOW GPU: Interrogating CUDA enabled GPUs …
 +
TUFLOW GPU: Error: Non-CUDA Success Code returned
 +
</pre>
 +
or
 +
<pre>ERROR 2785 - No GPU devices found, enabled or compatible.
 +
</pre>
  
 +
Please try the following steps:
 +
<ol>
 +
<li> Check if your GPU card is an NVIDIA GPU card. Currently, TUFLOW does not run on AMD type GPU.
 +
<li> Check if your NVIDIA GPU card is CUDA enabled and whether the latest drivers are installed. Please see <u>[[GPU_Setup | GPU Setup]]</u>.
 +
</ol>
 
<br>
 
<br>
Click [[Flood_Modeller_Tutorial_Model | here]] to return back to the main Flood Modeller - TUFLOW Tutorial page.
+
If you experience an issue that is not detailed above please send an email to support@tuflow.com<br>

Latest revision as of 15:24, 19 July 2024

Introduction

In this module we will link an existing 2D TUFLOW domain to an existing Flood Modeller 1D model. The 2D TUFLOW domain will represent the floodplain in the study area, and the 1D Flood Modeller model will represent the watercourse and all online structures.

1D-2D linked models are able to utilise the individual benefits of 1D and 2D solution schemes. In this example, the 1D Flood Modeller scheme is used to represent the watercourses where the flow is essentially uni-directional. A 2D scheme is suited to the representation of floodplains where more complex flow patterns may occur.

As discussed in Module 1 of the TUFLOW Tutorial Model, the main watercourse channel is not very well represented using the 5m 2D cell size. In parts, the watercourse is only 5-10m wide and the 5m cell size could be considered too coarse to accurately represent the watercourse topography.
Poor 2d rep.png
Using a cell size that is coarse relative to the width of the watercourse channel may reduce the accuracy of the conveyance in the channel. There are two options for improving the representation of the creek channel:

  • decrease the width of the 2D cells; and/or
  • model the channel as a 1D network, dynamically linked to the 2D domain (the floodplain).

In the optional section of Module 1 of the TUFLOW Tutorial Model, we looked at reducing the cell size to get a better representation of the channel. In this module we will adopt the second approach of modelling the creek as 1D elements using Flood Modeller.

TUFLOW may be dynamically linked to 1D networks using the hydrodynamic solutions of ESTRY (TUFLOW 1D), Flood Modeller (previously ISIS), XP-SWMM and 12D Solutions’ Dynamic Drainage.

Setting up a 1D/2D model where the 1D channel cuts through the 2D domain is probably the most time-consuming type of a model to setup. However, the reduction in simulation time can be beneficial and make this a good approach. For this module, the complete Flood Modeller 1D model has been provided, to allow for progressing through the module in a relatively short period of time.

Existing Model Data

This tutorial builds upon the 2D TUFLOW domain that was constructed as part of Module 1 and Module 2 of the TUFLOW Tutorial Model.
The model developed in these tutorial modules already contains some culverts modelled as 1D elements. The culverts are modelled in ESTRY, TUFLOW's internal 1D engine. One of these culverts will be kept in ESTRY and the other will be added to the Flood Modeller model.
The 2D boundary conditions (upstream inflows and downstream stage-discharge boundary) will be removed from the model. These will instead be represented in Flood Modeller as it is a more typical schematisation for a 1D/2D linked model.
The existing TUFLOW model consists of:

  • Definition of Active/In-Active Areas
  • Definition of Land Use
  • 1D ESTRY culverts
  • 1D/2D boundary links to connect the 1D ESTRY culverts to the 2D TUFLOW domain.

For further information on these elements, please refer to Module 1 and Module 2 of the TUFLOW Tutorial Model.

Flood Modeller

A complete Flood Modeller 1D model of the watercourse has been provided for the purposes of this tutorial.
The model data has been arranged in the following folder structure:

  • DAT: Contains the Flood Modeller 1D network file.
  • IED: Contains event data of the model.
  • IEF: A blank folder in which to store Flood Modeller Event Files used to simulate the model.
  • RES: A blank folder in which to write the Flood Modeller result files.

For further information on each file type, please refer to the Flood Modeller User Manual.
For this tutorial, the floodplain of the study area will be modelled entirely in TUFLOW. The cross-sections in the Flood Modeller 1D model have been trimmed to the top of bank to ensure there is no double-counting of storage within the floodplain. Upstream and downstream boundary data is contained separately within the IED files. These will be referenced and linked to the Flood Modeller 1D model via the IEF simulation file.

GIS and Model Inputs

The steps necessary to modify each of the GIS inputs are demonstrated in MapInfo, ArcGIS and QGIS. At each stage please select your GIS package to view relevant instructions.

Define the External 1D Networks

This part of the module creates the GIS layers that specify the location of the Flood Modeller nodes that are to be connected to the 2D domain. Follow the instructions below for your preferred GIS package.

Define the 1D/2D Boundary Links

This part of the module creates the 1D/2D boundaries to link the Flood Modeller 1D component to the TUFLOW 2D domain. Follow the instructions below for your preferred GIS package.

Define Bank Elevations

This part of the module defines the bank elevations of the watercourse which are the elevations of the 1D/2D boundary links created in the previous section. Follow the instructions below for your preferred GIS package.

Deactivate 2D cells

This part of the module describes the steps to deactivate the 2D cells where the 1D model is replacing the 2D solution. Follow the instructions below for your preferred GIS package.

Modify Simulation Control Files

Now that we have made all of the necessary changes to the GIS layers, we need to update the TUFLOW control files and Flood Modeller Simulation Files to create a linked model.

TUFLOW Control Files

TUFLOW Geometry Control File

We will first update the TUFLOW Geometry Control (TGC) file. The following changes have been changes made to the geometry:

  • We have deactivated the cells along the watercourse which are represented in the 1D Flood Modeller component of the model
  • We have enforced bank elevations along the watercourse.


  1. In the FMT_Tutorial\FMT_M01\TUFLOW\model folder, save a copy of M01_5m_002.tgc as FMT_M01_001.tgc.
  2. Open FMT_M01_001.tgc
    Mapinfo
    Add an extra command line after Read GIS Code ==..\model\mi\2d_code_FMT_M01_001_R.MIF
  3. Read GIS Code BC == mi\2d_bc_FMT_M01_HX_001_R.MIF ! Deactivates the cells where the watercourse has been modelled in 1D
    Note that the order of the commands is important. The layer 2d_code_FMT_M01_001.MIF first activates cells within the modelled area then the layer 2d_bc_FMT_M01_HX_001_R.MIF deactivates selected cells along the watercourse. Other GIS
    Add an extra command line after Read GIS Code ==..\model\gis\2d_code_FMT_M01_001_R.shp
    Read GIS Code BC == gis\2d_bc_FMT_M01_HX_001_R.shp  ! Deactivates the cells where the watercourse has been modelled in 1D
    Note that the order of the commands is important. The layer 2d_code_FMT_M01_001_R.shp first activates cells within the modelled area then the layer 2d_bc_FMT_M01_HX_001_R.shp deactivates selected cells along the watercourse.
  4. Topography amendments should be added in a new section at the bottom of the TGC. These are:
  5. Mapinfo
    Read GIS Z HX Line MAX == mi\2d_bc_FMT_M01_HX_001_L.MIF | mi\2d_bc_FMT_M01_HX_001_P.MIF ! Defines the bank crest levels (1D/2D boundary cell elevations). The 'MAX' option prevents any zpt elevations from being lowered
    The two GIS layers must be read in together on the same command line. This tells TUFLOW to associate the points within the 2d_bc_FMT_M01_HX_001_P.MIF layer (defining elevation) with the polylines within the 2d_bc_FMT_M01_HX_001_L.MIF layer (defining bank location). Other GIS
    Read GIS Z HX Line MAX == gis\2d_bc_FMT_M01_HX_001_L.shp | gis\2d_bc_FMT_M01_HX_001_P.shp ! Defines the bank crest levels (1D/2D boundary cell elevations). The 'MAX' option prevents any zpt elevations from being lowered
    The two GIS layers must be read in together on the same command line. This tells TUFLOW to associate the points within the 2d_bc_FMT_M01_HX_001_P.shp layer (defining elevation) with the polylines within the 2d_bc_FMT_M01_HX_001_L.shp layer (defining bank location).
  6. Save the file. The geometry control file is now ready to be used.

TUFLOW Boundary Condition Control File

We will now update the TUFLOW Boundary Condition control file (tbc) to reference the model boundary files created in previous steps.

  • Add the 1D/2D boundaries that link the Flood Modeller open channel to the 2D floodplain
  • Update the 1D/2D boundaries which link the ESTRY culverts to the 2D floodplain, as some of these culverts are now modelled in Flood Modeller
  • Remove the external inflows applied to the TUFLOW model, as these are now applied in Flood Modeller
    1. Open M02_5m_001.tbc and save a copy as FMT_M01_001.tbc.
    2. Remove the boundary linking to the TUFLOW inflows by:
      Mapinfo
      Put an exclamation mark before the line reading. This tells TUFLOW to treat this command line as a comment:
      Read GIS BC == mi\2d_bc_M01_002_L.MIF
      Other GIS
      Put an exclamation mark before the line reading:
      Read GIS BC == gis\2d_bc_M01_002_L.SHP
    3. Update the 1D/2D boundary links at the ESTRY culverts with the new layer:
    4. Mapinfo
      Read GIS BC == mi\2d_bc_M04_culverts_001_L.MIF ! This command reads in SX boundaries linking the 1D ESTRY culverts to the 2D domain
      Other GIS
      Read GIS BC == gis\2d_bc_M04_culverts_001_L.shp ! This command reads in SX boundaries linking the 1D ESTRY culverts to the 2D domain
    5. Add reference to the 1D/2D boundary links that connect Flood Modeller to the 2D floodplain:
    6. Mapinfo
      Read GIS BC == mi\2d_bc_FMT_M01_HX_001_p.MIF | mi\2d_bc_FMT_M01_HX_001_L.MIF! This command reads in HX boundaries linking the 1D Flood Modeller watercourse to the 2D domain
      Other GIS
      Read GIS BC == gis\2d_bc_FMT_M01_HX_001_p.shp | gis\2d_bc_FMT_M01_HX_001_L.shp ! This command reads in HX boundaries linking the 1D Flood Modeller watercourse to the 2D domain
    7. Save the file. The boundary control file is now ready to be used.

    TUFLOW Control File

    Finally, we need to edit the TUFLOW control file (.tcf). We will:

  • Remove reference to model parameters that will be read in from Flood Modeller
  • Read in the GIS layer of the Flood Modeller Nodes
  • Read in the GIS layers to create Water Level Lines along the Flood Modeller component of the model (optional)
  • Add a reference to the ESTRY Control File
  • Update reference to the boundary control file (.tbc) and geometry control file

    1. In the \FMT_Tutorial\FMT_M01\TUFLOW\runs folder, save a copy of the TUFLOW file created as a part of module 2 (M02_5m_001.tcf) as FMT_M01_001.tcf.
    2. In a linked Flood Modeller - TUFLOW model, the Start Time, End Time and 2D Timestep are read from the Flood Modeller .ief file. It is best practice to therefore remove these parameters from the tcf. And an exclamation mark in front of each of the below commands.
      ! SIMULATION TIME CONTROL COMMANDS
      Timestep == 1.5 ! Specifies a 2D computational timestep of 1.5 seconds
      Start time == 0 ! Specifies a simulation start time of 0 hours
      End Time == 3 ! Specifies a simulation end time of 3 hours
    3. We need to read in the GIS layers of the Flood Modeller Nodes. Place the below command line anywhere in the .tcf. It is good practice to create a section within the .tcf to reference all 1D commands:
    4. Mapinfo
      Read GIS X1D Nodes == ..\model\mi\1d_x1d_FMT_M01_nodes_001_P.MIF ! GIS layer referencing node IDs from Flood Modeller
      Other GIS
      Read GIS X1D Nodes == ..\model\gis\1d_x1d_FMT_M01_nodes_001_P.shp ! GIS layer referencing node IDs from Flood Modeller
    5. Add commands to read in the GIS layers referencing Water Level Lines drawn along the Flood Modeller component of the model:
    6. Mapinfo
      Read GIS X1D Network == ..\model\mi\1d_x1d_FMT_M01_nwk_001_L.MIF ! GIS layer representing channels to allow for the digitisation of Water Level Lines (optional)
      Read GIS X1D WLL == ..\model\mi\1d_x1d_WLL_FMT_M01_001_L.MIF ! GIS layer containing WLLs for visualising 1D results in 2D (optional)
      Other GIS
      Read GIS X1D Network == ..\model\gis\1d_x1d_FMT_M01_nwk_001_L.shp ! GIS layer representing channels to allow for the digitisation of Water Level Lines (optional)
      Read GIS X1D WLL == ..\model\gis\1d_x1d_WLL_FMT_M01_001_L.shp ! GIS layer containing WLLs for visualising 1D results in 2D (optional)
    7. Add commands to read in the an Esty Control File which contains references to some of the culverts present on the floodplain:
    8. ESTRY Control File == ..\model\FMT_M01_001.ecf !Reference the ESTRY Control File
    9. Finally, update the links to the Geometry control file, the Boundary Condition control file and the bc_dbase file:
    10. Geometry Control File == ..\model\FMT_M01_001.tgc
      BC Control File == ..\model\FMT_M01_001.tbc
      BC Database == ..\bc_dbase\bc_dbase_FMT_M01.csv
      This concludes the changes that we need to make to the .tcf

    Flood Modeller Simulation Files

    In the FMT_M01\Flood_Modeller folder, we have provided a complete Flood Modeller model. It is located in the DAT, IED and IEF folders.
    The DAT and IED files are complete and will not require any modification to link to TUFLOW.
    However, we will alter the IEF to create the link. The IEF alterations can be done either in a text editor of your choice or using the Flood Modeller Interface.
    The instructions below have been written for the Flood Modeller Interface version 4.2.

    IEF File

    1. Open Flood Modeller. Select 'Load 1D Network'. Navigate to \FMT_Tutorial\FMT_M01\Flood_Modeller\DAT and load the FMT_M01_001.dat.
    2. Right click 'Event Data' and select 'Add Item'. Navigate to \FMT_Tutorial\FMT_M01\Flood_Modeller\IED and load the FMT_Inflows.IED.
    3. FMT Load1Dnwk.JPG
    4. On the 'Simulation' tab, click New 1D Simulation. Save the file when prompted in the \FMT_Tutorial\FMT_M01\Flood_Modeller\IEF folder asFMT_M01_001.ief
    5. On the 'Files' Tab of the simulation window, set the following parameters:
      • Event Title: FMT_M01_001
      • 1D Data File: The full path to the \FMT_Tutorial\FMT_M01\Flood_Modeller\DAT\FMT_M01_001.dat
      • Use Initial Conditions from: Network File (.dat)
      • Results File: the full path to \FMT_Tutorial\FMT_M01\Flood_Modeller\RES\FMT_M01_001
    6. To the right of the Event Data box, click Add and select the FMT_Inflows.IED file in the \FMT_Tutorial\FMT_M01\Flood_Modeller\IED folder.
    7. FMT Simulation files.JPG
    8. On the 'Times' tab, we will replace the simulation time parameters that were removed from TUFLOW. Enter the following parameters:
      • Run Type: Unsteady (Fixed Timestep)
      • Start Time (hrs): 0
      • Finish Time (hrs): 3
      • Timestep (s):1
      • Save Interval (s): 300
      FMT Simulation times.JPG
    9. Add the 'Links' tab by clicking View> Tabs > Links. On the 'Links' tab, enter the following parameters:
      • 2-d Scheme: TUFLOW
      • 2-d Timestep: 2
      • 2-d control file: full path to the FMT_M01_001.tcf from the \FMT_Tutorial\FMT_M01\TUFLOW\runs folder
      FMT Simulation links.JPG
    10. Add the 'Additional Output' tab by clicking View> Tabs > Additional Output. On the 'Additional Output' tab, select the check box for '2D Flow...'. This will add extra output to check the Flood Modeller and TUFLOW link. We will review this additional output in the following section.
    11. Save the Scenario Data.

    Run the Simulation

    There are a number of different methods in which to start a Flood Modeller – TUFLOW model. Please refer to the following page for a detailed discussion on each of these methods.
    Use your preferred method to start the model FMT_M01_001.ief or follow the guidance below. If the simulation fails to start, please refer to the troubleshooting guidance on this page.

    In the Complete_Model\FMT_M01\Flood_Modeller\IEF folder a batch file has been provided. To use the batch file in this tutorial:

    • Ensure that you set up the installation folders.
    • Move the batch file to the FMT_Tutorial\FMT_M01\Flood_Modeller\IEF folder
    • Open the batch file in a text editor. On the 'set FloodModeller=' line, change the path from the one provided to the full path to the ISISf32.exe file that you set up with the installation folders.
    • Save and close the file
    • Double click the batch file in your file explorer to run the file


    When the simulation is running, the Flood Modeller status window will open. Flood Modeller will then open a tab with the TUFLOW output.
    FMP Sim Screen.png
    The simulation will take a few minutes depending on the hardware setup.

    Review the Results

    Modelled results can be processed, reviewed and visualised in many different packages.
    For a complete introduction to the different options, refer to Tutorial Module 1.

    TUFLOW HPC

    To run the linked TUFLOW-Flood Modeller Pro model using HPC we simply need to add a single line to the Tuflow Control File. The HPC solver will only speed up the 2D calculations within the linked 1D-2D model, it will not speed up the 1D calculations that take place in the Flood Modeller Engine. The relatively small nature of this specific model means that use of HPC on multiple CPU cores may not lead to significant improvements to model run times. However, should the machine have an NVIDIA GPU card present then it is possible to run the HPC solver on the GPU to significantly improve model runs times. The larger the 2D domain, the more significant the improvements to model run times through the use of the HPC solver. To utilise the HPC solver:-

    1. Save the TUFLOW runfile ( FMT_M01_001.tcf) as FMT_M01_002.tcf.
    2. Add the following command to the TCF file:
      Solution Scheme == HPC ! Use HPC solver to run the simulation
    3. If you have a CUDA enabled NVIDIA GPU device, you can also add the following command to run the HPC solver using GPU hardware:
      Hardware == GPU ! Run HPC solver on GPU
    4. Save the TCF file and run the model.Troubleshooting for GPU Simulation

    Troubleshooting for GPU Simulation

    If you receive the following error when trying to run the TUFLOW HPC model using GPU hardware:

    TUFLOW GPU: Interrogating CUDA enabled GPUs … 
    TUFLOW GPU: Error: Non-CUDA Success Code returned 
    

    or

    ERROR 2785 - No GPU devices found, enabled or compatible.
    

    Please try the following steps:

    1. Check if your GPU card is an NVIDIA GPU card. Currently, TUFLOW does not run on AMD type GPU.
    2. Check if your NVIDIA GPU card is CUDA enabled and whether the latest drivers are installed. Please see GPU Setup.


    If you experience an issue that is not detailed above please send an email to support@tuflow.com