View source for Tutorial Module07 Archive

<ol>
=Introduction=
In this module we will incorporate within the tutorial model a more detailed representation of the proposed development first introduced in [[Tutorial Module05_Archive|Module 5]]. We will be utilising a more complex method to alter the ground elevations and will also incorporate 1D elements into the model to represent the drainage network. The method of modelling a bridge demonstrated in the 'FINB2' scenario of [[Tutorial Module06_Archive|Module 6]] will be taken forward for this module to produce a final developed 'DEV' scenario. This will involve:
*Modification of the floodplain topography by the creation of a 3D TIN surface;
*Revising the land use;
*The addition of pipes and pits to represent an underground drainage network; and
*The addition of an inflow into the pipe network.

=GIS 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.

==Define Elevations (Building a TIN) ==
We have provided the GIS layers necessary to modify the ground elevations to represent the proposed development. This part of the tutorial will demonstrate how a TIN is created from these GIS layers. We will also update the GIS defining the road crest level. Follow the instructions below for your preferred GIS package.
* [[Tute_M07_ARC_2D_TIN_Archive | ArcGIS]]
* [[Tute_M07_MI_2D_TIN_Archive | MapInfo]]
* [[Tute_M07_QGIS_2D_TIN_Archive | QGIS]]

==Define Surface Roughness ==
We have provided the GIS layers necessary to modify the land use areas that will change as part of the proposed development. This part of the tutorial will require populating the layer attributes to assign Manning’s n roughness values to each land use. Follow the instructions below for your preferred GIS package.
* [[Tute_M07_ARC_2D_MAT_Archive | ArcGIS]]
* [[Tute_M07_MI_2D_MAT_Archive | MapInfo]]
* [[Tute_M07_QGIS_2D_MAT_Archive | QGIS]]

==Define Pipe Network ==
This part of the module creates the GIS layers that make up a pipe network. The pits of the pipe network will be linked to the 2D domain. We will also create the pit inlet database which links the GIS layers to depth-discharge curves. Follow the instructions below for your preferred GIS package.
* [[Tute_M07_ARC_1D_NWK_Archive | ArcGIS]]
* [[Tute_M07_MI_1D_NWK_Archive | MapInfo]]
* [[Tute_M07_QGIS_1D_NWK_Archive | QGIS]]

==Define Boundary Conditions ==
This part of the module demonstrates how an inflow can be applied directly to the pits of the pipe network. A GIS layer of the inflow boundary has been provided. We will also modify the existing Boundary Conditions Database to include these new inflows. Follow the instructions below for your preferred GIS package.
* [[Tute_M07_ARC_2D_SA_Archive | ArcGIS]]
* [[Tute_M07_MI_2D_SA_Archive | MapInfo]]
* [[Tute_M07_QGIS_2D_SA_Archive | QGIS]]

=Modify Simulation Control Files and Set-up a TUFLOW Scenario=
Now that we have made all of the necessary changes to the GIS layers, we need to update our control files to include all the changes representing the proposed development. [[Tutorial Module06_Archive|Module 6]] introduced a scenario named ‘FIN’ which included changes to an existing structure in the model as part of the final proposed development. For this module, we will incorporate the model changes into this existing scenario. 

==TGC File ==

There have been two changes to the model that impact the TGC file:
*We have created two layers that together form a 3D TIN representing changes to the ground elevations.
*We have created two 2d_mat layers that represent changes to the land use at the location of the proposed development. <br>
We will also be making the necessary amendments to the control files to incorporate the representation of the bridge in the 'FINB2' scenario into a final 'DEV' scenario. 
<br>
<ol>
<li>Begin by opening '''M06_5m_001.tgc''' in your text editor. Save the file as '''M07_5m_001.tgc'''.</li>
</ol>
'''MapInfo Users'''<br>
<ol start="2">
<li>The command lines specifying the active and in-active areas of the model need to be updated for the 'DEV' scenario to match the 'FINB2' scenario. Delete or comment out the command <font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> <tt> mi\2d_bc_M04_HX_001.MIF</tt> and replace it with an ''If Scenario'' to define all scenarios as shown below: 
<br>
<font color="blue"><tt>If Scenario </tt></font> <font color="red"><tt>== </tt></font> <tt> EXG | FINB1 | FINB3 </tt><br>
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> <tt>mi\2d_bc_M04_HX_001.MIF </tt><br>
<font color="blue"><tt>Else If Scenario </tt></font> <font color="red"><tt>== </tt></font> <tt> DEV | FINB2  </tt><br>	
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> <tt> mi\2d_bc_M06_HX_001.MIF  </tt><br>
<font color="blue"><tt>Else</tt></font><br>	
:<font color="blue"><tt>Pause </tt></font> <font color="red"><tt>== </tt></font> <tt> Scenario not recognised  </tt><br>
<font color="blue"><tt>End If </tt></font><br>	
<br>
We will also now delete or comment out the command <font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> <tt> mi\2d_bc_M06_HX_001.MIF</tt> within the FINB2 Scenario at the end of code. The new ''If Scenario'' block we have added means this command is no longer needed. <br>
<br>

<li> We will now add the commands to modify the topography to represent the proposed development. Within the ''If Scenario'' logic block for the 'DEV' scenario, comment out or delete the command <font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <tt> mi\2d_zsh_M05_development_001.MIF</tt>. This command is no longer needed as it will be superseded by a more detailed representation of the proposed development. Add the following commands in its place:<br>
<br>
<font color="blue"><tt>Create TIN Zpts WRITE TIN</tt></font> <font color="red"><tt>== </tt></font><tt>mi\2d_ztin_M07_development_001.MIF | mi\2d_ztin_M07_development_001_P.MIF</tt> <br>
<font color="blue"><tt>Read GIS Z HX Line MAX </tt></font> <font color="red"><tt>== </tt></font><tt>mi\2d_bc_M06_HX_001.MIF | mi\2d_bc_M06_HX_001_P.MIF</tt> <br>
<br>
The <font color="blue"><tt>Create TIN Zpts Write TIN</tt></font> command creates and writes an SMS .tin file to the same location as the GIS layer (in this case the '''TUFLOW\model\mi folder'''). The TIN can be viewed, checked and modified in SMS. This can then be read into the model directly using the <font color="blue"><tt>Read TIN zpts</tt></font> command for any subsequent model simulations. <br>
<br>
<li>Our intention for the 2d_mat layers created in this module is for them to build upon the existing commands which modify roughness. We would like for the new layers to overwrite the existing layers at the location of the proposed development. This process of layering and building up the model is a powerful tool in TUFLOW that minimises data duplication and provides a means of quality control. We need to ensure that the commands reading in our new 2d_mat layers are read in after the existing commands. Create another ''If Scenario'' logic block after the command  <font color="blue"><tt>Read GIS Mat</tt></font> <font color="red"><tt>== </tt> </font><tt>mi\2d_mat_M01_002.MIF</tt>, inserting the following:<br>
<br>
<font color="blue"><tt>If Scenario</tt></font> <font color="red"><tt>== </tt></font> <tt>DEV</tt><br>
:<font color="blue"><tt>Read GIS Mat</tt></font> <font color="red"><tt>== </tt></font> <tt>mi\2d_mat_M07_DEV_001.MIF</tt> <br>
:<font color="blue"><tt>Read GIS Mat</tt></font> <font color="red"><tt>== </tt> </font><tt>mi\2d_mat_M07_DEV_Buildings_001.MIF</tt> <br>
<font color="blue"><tt>Else If Scenario</tt></font> <font color="red"><tt>== </tt></font> <tt>EXG | FINB1 | FINB2 | FINB3</tt><br>
<br>
<font color="blue"><tt>Else</tt></font><br>
:<font color="blue"><tt>Pause</tt></font> <font color="red"><tt>== </tt></font> <tt> Scenario not recognised</tt><br>
<font color="blue"><tt>End If</tt></font><br>
<br>
</ol>
'''QGIS or ArcGIS Users'''<br>
<ol start="2">
<li>The command lines specifying the active and in-active areas of the model need to be updated for the 'DEV' scenario to match the 'FINB2' scenario. Delete or comment out the command <font color="blue"><tt>Read GIS Code </tt></font> <font color="red"><tt>== </tt></font> <tt> gis\2d_code_M04_null_creek_001_R.shp</tt> and replace it with an ''If Scenario'' to define all scenarios as shown below: <br>
<font color="blue"><tt>If Scenario </tt></font> <font color="red"><tt>== </tt></font> <tt> EXG | FINB1 | FINB3 </tt><br>
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> <tt>gis\2d_code_M04_null_creek_001_R.shp </tt><br>
<font color="blue"><tt>Else If Scenario </tt></font> <font color="red"><tt>== </tt></font> <tt> DEV | FINB2  </tt><br>	
:<font color="blue"><tt>Read GIS Code BC </tt></font> <font color="red"><tt>== </tt></font> <tt>gis\2d_code_M06_null_creek_001_R.shp  </tt><br>
<font color="blue"><tt>Else</tt></font><br>	
:<font color="blue"><tt>Pause </tt></font> <font color="red"><tt>== </tt></font> <tt> Scenario not recognised  </tt><br>
<font color="blue"><tt>End If </tt></font><br>
<br>
We will also now delete or comment out the command <font color="blue"><tt>Read GIS Code </tt></font> <font color="red"><tt>== </tt></font> <tt> gis\2d_code_M06_null_creek_001_R.shp</tt> within the FINB2 Scenario at the end of code. The new ''If Scenario'' block we have added means this command is no longer needed. <br>
	
<br>
<li> We will now add the commands to modify the topography to represent the proposed development. Within the ''If Scenario'' logic block for the 'DEV' scenario, comment out or delete the command <font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <tt> gis\2d_zsh_M05_development_001_R.shp</tt>. This command is no longer needed as it will be superseded by a more detailed representation of the proposed development. Add the following commands in its place:<br>
<br>
<font color="blue"><tt>Create TIN Zpts WRITE TIN</tt></font> <font color="red"><tt>== </tt></font><tt>gis\2d_ztin_M07_development_001_R.SHP | gis\2d_ztin_M07_development_001_P.SHP</tt> <br>
<font color="blue"><tt>Read GIS Z HX Line MAX </tt></font> <font color="red"><tt>== </tt></font><tt>gis\2d_bc_M06_HX_001_L.shp | gis\2d_bc_M06_HX_001_P.shp</tt> <br>
<br>

<br>
The <font color="blue"><tt>Create TIN Zpts Write TIN</tt></font> command creates and writes an SMS .tin file to the same location as the GIS layer (in this case the '''TUFLOW\model\gis folder'''). The TIN can be viewed, checked and modified in SMS. This can then be read into the model directly using the <font color="blue"><tt>Read TIN zpts</tt></font> command for any subsequent model simulations. <br>
<br>
<li>Our intention for the 2d_mat layers created in this module is for them to build upon the existing commands which modify roughness. We would like for the new layers to overwrite the existing layers at the location of the proposed development. This process of layering and building up the model is a powerful tool in TUFLOW that minimises data duplication and provides a means of quality control. We need to ensure that the commands reading in our new 2d_mat layers are read in after the existing commands. <br>
Create a second ''If Scenario'' logic block after the command  <font color="blue"><tt>Read GIS Mat</tt></font> <font color="red"><tt>== </tt> </font><tt>mi\2d_mat_M01_002_R.SHP</tt>, inserting the following:<br>
<br>
<font color="blue"><tt>If Scenario</tt></font> <font color="red"><tt>== </tt></font> <tt>DEV</tt><br>
:<font color="blue"><tt>Read GIS Mat</tt></font> <font color="red"><tt>== </tt></font> <tt>gis\2d_mat_M07_FIN_001_R.SHP</tt> <br>
:<font color="blue"><tt>Read GIS Mat</tt></font> <font color="red"><tt>== </tt> </font><tt>gis\2d_mat_M07_FIN_Buildings_001_R.SHP</tt> <br>
<font color="blue"><tt>Else If Scenario</tt></font> <font color="red"><tt>== </tt></font> <tt>EXG | FINB1 | FINB2 | FINB3</tt><br>
<br>
<font color="blue"><tt>Else</tt></font><br>
:<font color="blue"><tt>Pause</tt></font> <font color="red"><tt>== </tt></font> <tt> Scenario not recognised</tt><br>
<font color="blue"><tt>End If</tt></font><br>
<br>

<li>Save the file. The tgc file is now ready to be used.
</ol>

==ECF File ==

There have been three changes to the model that impact the ECF file:
*We have created a 1d_nwk layer representing the culverts of the proposed pipe network
*We have created a 1d_nwk layer representing the pits of the proposed pipe network
*We have created a pit inlet database that links depth-discharge curves to the pit inlet type.
Currently the 'DEV' scenario is included within the same If Scenario logic block as the 'EXG' scenario. We will modify this so that each scenario has their own group of commands. 
<ol>
<li>Open '''M06_1d_001.ecf''' in your text editor and save as '''M07_1d_001.ecf'''</li>
</ol>
'''MapInfo Users'''<br>
<ol start="2">
<li>Remove 'DEV' from the command line <font color="blue"><tt>Else If Scenario</tt></font> <font color="red"><tt>== </tt></font><tt>EXG | DEV</tt> so that the <font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font><tt> mi\1d_nwk_M04_culverts_001.MIF</tt> command is only read in for the 'EXG' scenario. <br>
<li>Add a final Else If Scenario logic block after the commands for the 'EXG' scenario as follows: <br>
<font color="blue"><tt>Else If Scenario</tt></font> <font color="red"><tt>== </tt></font><tt>DEV</tt> <br>											
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>mi\1d_nwk_M06_culverts_001.MIF</tt> <br>
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>mi\1d_nwk_M06_bridge_001.MIF</tt> <br>	
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>mi\1d_nwk_M06_weir_001.MIF</tt> <br>	
:<font color="blue"><tt>Read GIS Table Links</tt></font> <font color="red"><tt>== </tt></font><tt>bg\1d_bg_M06_bridge_001.MIF</tt> <br>
:<font color="blue"><tt>Read GIS Table Links</tt></font> <font color="red"><tt>== </tt></font><tt>bg\1d_bg_M06_weir_001.MIF</tt> <br>	
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>mi\1d_nwk_M07_Pipes_001.MIF</tt> <br>				
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>mi\1d_nwk_M07_Pits_001.MIF</tt> <br>				
:<font color="blue"><tt>Pit Inlet Database</tt></font> <font color="red"><tt>== </tt></font><tt>..\pit_dbase\pit_inlet_dbase.csv </tt> <br>		
<br>
</ol>
'''QGIS or ArcGIS Users'''<br>
<ol start="2">
<li>Remove 'DEV' from the command line <font color="blue"><tt>Else If Scenario</tt></font> <font color="red"><tt>== </tt></font><tt>EXG | DEV</tt> so that the <font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font><tt> gis\1d_nwk_M04_culverts_001_L.SHP</tt> command is only read in for the 'EXG' scenario. <br>
<li>Add a final Else If Scenario logic block after the commands for the 'EXG' scenario as follows: <br>
<font color="blue"><tt>Else If Scenario</tt></font> <font color="red"><tt>== </tt></font><tt>DEV</tt> <br>											
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>gis\1d_nwk_M06_culverts_001_L.SHP</tt> <br>
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>gis\1d_nwk_M06_bridge_001_L.SHP</tt> <br>	
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>gis\1d_nwk_M06_weir_001_L.SHP</tt> <br>	
:<font color="blue"><tt>Read GIS Table Links</tt></font> <font color="red"><tt>== </tt></font><tt>bg\1d_bg_M06_bridge_001_L.SHP</tt> <br>
:<font color="blue"><tt>Read GIS Table Links</tt></font> <font color="red"><tt>== </tt></font><tt>bg\1d_bg_M06_weir_001_L.SHP</tt> <br>	
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>gis\1d_nwk_M07_Pipes_001_L.shp</tt> <br>				
:<font color="blue"><tt>Read GIS Network</tt></font> <font color="red"><tt>== </tt></font><tt>gis\1d_nwk_M07_Pits_001_P.shp</tt> <br>				
:<font color="blue"><tt>Pit Inlet Database</tt></font> <font color="red"><tt>== </tt></font><tt>..\pit_dbase\pit_inlet_dbase.csv </tt> <br>
<li>Save the file. The 1D control file is now ready to be used.
</ol>

==TBC File ==

There has been one change to the model that impacts the TBC file:
*We have created a 2d_sa layer to define inflows into the pipe network. <br>
Again, we will place these new commands within an ''If Scenario'' logic block specific to the ‘DEV’ scenario. 
<ol>
<li>Open '''M06_5m_001.tbc''' in your text editor and save as '''M07_5m_001.tbc'''</li>
</ol>
'''MapInfo Users'''<br>
<ol start="2">
<li>Insert the following commands after the existing <font color="blue"><tt>Read GIS SA</tt></font> <font color="red"><tt>== </tt></font><tt>mi\2d_sa_M01_002.MIF</tt> command: <br>
<br>
<font color="blue"><tt>If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>DEV </tt><br>					
:<font color="blue"><tt>Read GIS SA PITS </tt></font> <font color="red"><tt>== </tt></font><tt>mi\2d_sa_M07_001.MIF  </tt><br> 	
<font color="blue"><tt>Else If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>EXG | FINB1 | FINB2 | FINB3 </tt> <br>
												
<font color="blue"><tt>Else </tt></font> <br>										
:<font color="blue"><tt>Pause </tt></font> <font color="red"><tt>== </tt></font><tt>Scenario not recognised </tt><br>			
<font color="blue"><tt>End If 	 </tt></font> <br>										
<br>
<li> Modify the existing If Scenario logic block such that the 'DEV' scenario reads in the same set of commands as the 'FINB2' scenario. The second logic block should now look like the following:<br>
<font color="blue"><tt>If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>EXG | FINB1 | FINB3</tt><br>
:<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font><tt>mi\2d_bc_M04_HX_001.MIF</tt><br>
  
<font color="blue"><tt>Else If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>DEV | FINB2</tt><br>			
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font><tt>mi\2d_bc_M06_HX_001.MIF</tt><br>
 
<font color="blue"><tt>Else</tt></font><br>								
:<font color="blue"><tt>Pause </tt></font> <font color="red"><tt>== </tt></font><tt>Scenario not recognised </tt><br>			
<font color="blue"><tt>End If</tt></font><br>								
</ol>
'''QGIS or ArcGIS Users'''<br>
<ol start="2">
<li>Insert the following commands after the existing <font color="blue"><tt>Read GIS SA</tt></font> <font color="red"><tt>== </tt></font><tt>gis\2d_sa_M01_002_R.shp</tt> command: <br>
<br>
<font color="blue"><tt>If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>DEV </tt><br>					
:<font color="blue"><tt>Read GIS SA PITS </tt></font> <font color="red"><tt>== </tt></font><tt>gis\2d_sa_M07_001_R.SHP  </tt><br> 	
<font color="blue"><tt>Else If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>EXG | FINB1 | FINB2 | FINB3 </tt> <br>
												
<font color="blue"><tt>Else </tt></font> <br>										
:<font color="blue"><tt>Pause </tt></font> <font color="red"><tt>== </tt></font><tt>Scenario not recognised </tt><br>			
<font color="blue"><tt>End If 	 </tt></font> <br>										
<br>
<li> Modify the existing If Scenario logic block such that the 'DEV' scenario reads in the same set of commands as the 'FINB2' scenario. The second logic block should now look like the following:<br>
<font color="blue"><tt>If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>EXG | FINB1 | FINB3</tt><br>
:<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font><tt>gis\2d_bc_M04_HX_001_L.shp</tt><br>
  
<font color="blue"><tt>Else If Scenario </tt></font> <font color="red"><tt>== </tt></font><tt>DEV | FINB2</tt><br>			
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font><tt>gis\2d_bc_M06_HX_001_L.shp</tt><br>
 
<font color="blue"><tt>Else</tt></font><br>								
:<font color="blue"><tt>Pause </tt></font> <font color="red"><tt>== </tt></font><tt>Scenario not recognised </tt><br>			
<font color="blue"><tt>End If</tt></font><br>

<li>Save the file. The tbc file is now ready to be used.
</ol>

==TCF File ==
We will need to create a new tcf file that references the new tgc, ecf and tbc files.
<ol>
<li>Open '''M06_5m_~s1~_001.tcf''' and save as '''M07_5m_~s1~_001.tcf'''
<li>Update the following commands:<br>
<font color="blue"><tt>Geometry Control File</tt></font> <font color="red"><tt>== </tt></font><tt>..\model\ M07_5m_001.tgc</tt><br>
<font color="blue"><tt>ESTRY Control File</tt></font> <font color="red"><tt>== </tt></font><tt>..\model\ M07_1d_001.ecf</tt><br>
<font color="blue"><tt>BC Control File</tt></font> <font color="red"><tt>== </tt></font><tt>..\model\ M07_5m_001.tbc</tt><br>
<br>
<li>We have also created a new bc_dbase in this module which will need to be referenced. Update the command as follows:<br>
<font color="blue"><tt>BC Database</tt></font> <font color="red"><tt>== </tt></font><tt>..\bc_dbase\bc_dbase_M07.csv</tt><br>
<br>
<li>Lastly, update the following command to specify a new output folder for the results of this module:<br>
<font color="blue"><tt>Output Folder</tt></font> <font color="red"><tt>== </tt></font><tt>..\results\M07\2d</tt><br>
<br>
<li>Save the file. The tcf file is now ready to be used.
</ol>

=Run the Simulation=
Using your preferred method for starting TUFLOW, run the newly created '''M07_5m_~s1~_001.tcf'''. Please refer to <u>[[Tutorial_Module01_Archive#Run_Simulation | Module 1]]</u> for a detailed description of the various methods for running a TUFLOW simulation.<br>
In this tutorial we are using a batch file to run simulations. The command line in our batch file will be similar to that used in Module 6:<br>
{| class="wikitable " 
|-
|  <tt>set TUFLOWEXE=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iSP_w64.exe</tt><br>
<tt>set RUN=start "TUFLOW" /wait "%TUFLOWEXE%" -b</tt><br>
<br>
<tt>%RUN% <font color="red">-s1 DEV </font> M07_5m_~s1~_001.tcf</tt><br>
|}
If the model fails to start correctly please refer to the <u>[[Tutorial_Module07_Archive#Troubleshooting |troubleshooting section]]</u> at the end of this page.<br>

=Review Check Files=
Once the model has compiled and the simulation started, we can review the check files to ensure the changes have been correctly applied. The following section of this module outlines how the generated check files can be used to review each of the key changes we have made to the model. Note that there is often more than one check file that can be used to review each component of the model. The below steps outline just how some of these check files can be used. <br>

<u>'''Review Model Input Files'''</u><br>
When using the If Scenario commands in a model, one of the most important checks is to confirm that the correct layers have been read into the model for each scenario. This can be done by viewing the automatically generated MapInfo workspace in a text editor. This workspace along with one created for the QGIS package can be found in the TUFLOW\runs\log folder. They can be reviewed individually or compared with each other to highlight any differences. <br>
<br>
<u>'''Review Created TIN'''</u><br>
From the '''TUFLOW\check\2d\''' folder import (into MapInfo) or open (ArcMap and QGIS):<br>
* M07_5m_DEV_001_sh_obj_check 
*2d_ztin_M07_development_001.MIF_T0001.tin
* M07_5m_DEV_001_DEM_Z.flt

<br>
The _sh_obj_check file has been written as we have specified the WRITE TIN option as part of the <font color="blue"><tt>Create TIN Zpts</tt></font> command. The check file shows the triangles that have been generated for the TIN produced from the two 2d_ztin layers that we have read into the tgc that make up the proposed ground elevations of the new development. As mentioned previously, a .TIN file has also been written to the '''TUFLOW\model\mi''' or '''TUFLOW\model\GIS''' folder. This file can be viewed and edited directly in SMS. The M07_5m_DEV_001_DEM_Z.flt is a grid of the final zpts used by TUFLOW after processing of each of the layers within the tgc. It can be read by most mainstream GIS software and also visualised in SMS. <br>
<br>
<u>'''Review Changes to Roughness'''</u><br>
From the '''TUFLOW\check\2d\''' folder import (into MapInfo) or open (ArcMap and QGIS):<br>
* M07_5m_DEV_001_grd_check<br>
<br>
The grd_check file contains information on all cells within the model extent, such as ZC elevation and the location of the cell in relation to the model origin. One of the attributes of this check layer is the Material ID assigned to each cell. A review of this check file is recommended particularly when using multiple GIS layers to define the roughness of a 2D domain. The file can be colour coded to provide a visual representation of the roughness assigned to the entire model extent by:<br>
*Thematically mapping the grd_check layer in MapInfo
*Changing the style of the grd_check file to 'Categorized' by the 'Material' column in QGIS
*By right clicking on the grd_check layer within the table of contents and click Properties. Once the properties dialogue window is open select the Symbology tab. Choose the Unique values option under Categories in the left-hand list and map the Value Field of interest.
<br>
<u>'''Review Pipe Network'''</u><br>
From the '''TUFLOW\check\1d\''' folder import (into MapInfo) or open (ArcMap and QGIS):<br>
* M07_5m_DEV_001_nwk_C_check
* M07_5m_DEV_001_nwk_N_check<br>
<br>
These two check files provide information on the all 1D elements within the model. The _nwk_C_check layer provides information on all 1D channels (including structures) in the model, whilst the _nwk_N_check layer provides information on the nodes. Notice how the _nwk_C check layer shows a series of orange dashed lines at the locations where we have specified pits in the model. These lines represent 'pit channels', zero length channels that connect the 1D pipe network to the 2D floodplain. Viewing in conjunction with the _nwk_N check layer shows two nodes are created at the upstream (ground level) and downstream (invert of the pipe network) ends of the pit channel. The orange triangle at the upstream end provides information on the link created with the 2D floodplain. The blue diamond at the downstream end provides information on the automatically created manhole at the junction between the culverts of the pipe network. <br> 
<br>
<u>'''Review Boundaries and 1D/2D Links'''</u><br>
From the '''TUFLOW\check\2d\''' folder import (into MapInfo) or open (ArcMap and QGIS):<br>
* M07_5m_DEV_001_1d_to_2d_check
* M07_5m_DEV_001_sac_check
<br>
The _1d_to_2d_check layer highlights the location of all 1D/2D boundary links within the model. Where we have digitised the pipe network, this check file shows the SX boundaries that have been created at the location of the pits. This check file also shows the ZC elevation of the SX boundary which can be compared to surrounding ZC elevations by viewing alongside the grd_check layer. The check layer also shows the HX boundaries digitised along the river banks in Module 4. <br>
<br>
The _sac_check layer highlights the 2D cells connected to 1D pits where the 2d_sa inflow boundaries have been applied. The check file has been colour coded to show which 2D cells each of the four inflow boundaries has been applied to. The flow is distributed equally among each of the 2D cells. <br>

=Review the Results=

Open the 2D results in your results viewer or import to your GIS package. It can be seen that during the flood event the capacity of the pipe network is exceeded resulting in flooding of the roads in the proposed development. <br>
[[File:M07 2d Results.PNG|800px]]<br>
<br>
The 1D results can be viewed by importing the time series (_TS.mif or _TS_P.shp from the '''TUFLOW\results\1D''' folder, or opening any of the csv files outputted to '''TUFLOW\results\1d\csv'''. Another useful method for viewing the results of pipe networks is by importing in the _1d_ccA result layer found in the TUFLOW/results/1D folder. For each culvert or bridge within the model extent, this layer will provide information on the performance of the structure. Information such as percentage full and the time (in hours) the structure is at capacity are shown in this result layer. The layer is also automatically colour coded with thicker, dark purple lines highlighting structures that have reached capacity during the simulation. Thinner, pink lines show pipes that still have capacity.<br>
<br>
[[File:M07 ccA Results.PNG|800px]]

=Conclusion=
We have added to the model a final proposed development scenario. Using the Create TIN Zpts command, we have altered the ground elevations to represent the development. We have also added a 1D pipe network which has been linked to the 2D domain. A pit inlet database has been created to specify a depth-discharge relationship for flow into and out of the pits.

=Troubleshooting=
If the TUFLOW simulation fails to start TUFLOW will output the error in a number of locations.  Firstly, check the Console Window or the TUFLOW Log File (.tlf) (located in the '''TUFLOW\runs\log\''' folder with the name '''M07_5m_DEV_001.tlf'''). This file can be opened in a text editor and the error is generally located at the end of the file. You can however search for "Error" if you cannot see the error.  In most cases there is also a spatial location for the error message (if the error reported in the log file is prefixed by XY:).  To check the location of the geographic errors, open the '''M07_5m_DEV_001_messages.mif''' or '''M07_5m_DEV_001_messages_P.shp''' file in your GIS package.<br>
<br>
This section contains links to some possible problems that may occur when progressing through the fourth tutorial module.  If you experience an issue that is not detailed, please email support@tuflow.com or add and describe the problem on the <u>[[Talk%3ATutorial_Module07_Archive | discussion page.]]</u><br>

*[[Save_Date_Error_Archive|Save date of .tab file is later than .mif or .mid]]
*[[Model_Changes_Not_Seen_Archive | When reviewing check files, I can't see the changes]]
*[[TUFLOW_Message_2010 | ERROR 2010 - Material ID must be greater than 0 or less than 32767]]
*[[TUFLOW_Message_1118 | ERROR 1118 - Could not find pit inlet type ",a," in the pit inlet database]]
*[[Batch_File_Not_Running | Batch file does not run properly.]]
<br>

= Advanced - HPC Solver (Optional) =
This section will introduce how to run the model TUFLOW’s HPC (Heavily Parallelised Compute) solver, and how to fix some common issues that may occur when trying to run a simulation using Graphics Processing Unit (GPU) hardware. 

TUFLOW HPC can run between 10 and 100 times faster than TUFLOW Classic using NVidia Graphics Processing Units (GPU)(depending on the model configuration and hardware performance). 

===Model Setup===
To switch on the HPC solver with scenario control, please see <u>[[Tutorial_Module05_Archive#Model_Setup | HPC Model Setup]]</u> section of Module 5 (recommended).<br>
To run the HPC solver using another .tcf file, simply perform the following steps:
<ol>
<li> Save the TUFLOW runfile ('''M07_5m_~s1~_001.tcf''') as '''M07_5m_~s1~_002.tcf'''.
<li> Add the following command to the TCF file:<br>
:<font color="blue"><tt>Solution Scheme </tt></font> <font color="red"><tt>==</tt></font><tt> HPC</tt><font color="green"><tt>    ! Use HPC solver to run the model</tt></font><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:<br>
:<font color="blue"><tt>Hardware </tt></font> <font color="red"><tt>==</tt></font><tt> GPU</tt><font color="green"><tt>           ! Run HPC solver on GPU</tt></font><br>
<li> Save the TCF file.
<li> Update the batch file with the changes highlighted below in red.<br>
{| class="wikitable " 
|-
|  <tt>set TUFLOWEXE=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iSP_w64.exe</tt><br>
<tt>set RUN=start "TUFLOW" /wait "%TUFLOWEXE%" -b</tt><br>
<br>
<tt>%RUN% -s1 DEV M07_5m_~s1~_001.tcf</tt><br>
<tt><font color="red">%RUN% -s1 DEV M07_5m_~s1~_002.tcf</font></tt><br>
|}
<li> Run the TUFLOW Classic and HPC simulations.
<li> Review the results.
</ol>
<br>
''TIP: To switch on the HPC solver via scenario control commands, please see the <u>[[Tutorial_Module05_Archive#Model_Setup | HPC Model Setup]]</u> section of Module 5 (recommended).''<br>
:''Also, to learn how to optimise a HPC simulation to achieve the fastest simulation speed please complete <u>[[Tutorial_Module02_Archive | Tutorial Module 2 ]]</u> and <u>[[Tutorial_Module03_Archive | Tutorial Module 3 ]]</u><br>''

==Results==
Using the methods described above in the <u>[[Tutorial_Module01_Archive#Viewing_Results | Viewing Results]]</u> section of Module 1. 
* Check the simulation logs in the DOS window, .tlf and .hpc.tlf log files.
* View the results in your preferred package.
Do the logs and results appear different to the TUFLOW Classic simulation?

==Troubleshooting for GPU Simulations==
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>
If you experience an issue that is not detailed above please send an email to support@tuflow.com<br>
</ol>