Tuflow

Tutorial M04: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(7 intermediate revisions by 4 users not shown)
Line 1:
= Introduction =
In this module, bridges are represented within the 2D domain. TopographicThe changestutorial aredemonstrates madetwo to cut through the road and a time series data output created to gain information on a rangeways of hydraulicmodelling parametersbridges. of the bridge.<br>
* Part 1: 2D Layered Flow Constriction
* Part 2: 2D Bridge Structure
 
Topographic changes are made to cut through the road and a time series data output created to gain information on a range of hydraulic parameters of the bridge.<br>
 
The GIS layers are:
:*TGC layers:
<ol><ol>
<ol><ol><li>2d_lfcsh: A layer used for modelling 2D flow under and over bridges, pipes and other obstructions across the waterway. ▼
<li>2d_zsh: A layer used to modify Zpt elevations using points, lines and polygons.
▲<ol><ol><li>2d_lfcsh: A layer used for modelling 2D flow under and over bridges, pipes and other obstructions across the waterway.
<li>2d_bg: A layer used for modelling 2D bridges
</ol></ol>
:*TCF layers:
Line 11 ⟶ 17:
</ol></ol>
'''Module 4 builds from the model created in <u>[[Tutorial_M02 | Module 2]]</u>. The completed Module 2 model is provided in the Module_04\TUFLOW folder.''' <br>
<br>▼
 
= Part 1 - Layered Flow Constriction =
== GIS Inputs ==
Create, import and view input data:<br>
:*<u>[[Tutorial_M04_GIS_Inputs_QGIS | QGIS - SHP]]</u>
:*<u>[[Tutorial_M04_GIS_Inputs_QGIS_GPKG | QGIS - GPKG]]</u>
<br>▼
 
== Simulation Control Files ==
=== TUFLOW Geometry Control File (TGC) ===
<ol>
<li>Save a copy of '''M02_001.tgc''' as '''M04_001.tgc''' in the '''Module_04\TUFLOW\model''' folder.
<li>Open the '''M04_001.tgc''' in a text editor and add the additional lines below the '<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M02_rd_crest_001_L.shp | gis\2d_zsh_M02_rd_crest_001_P.shp</tt></font>' command: <br>
<u>'''QGIS - SHP'''</u><br>
<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_zsh_M02_cut_002_R.shp</tt></font> <font color="green"><tt> ! GIS layer used to define excavation through embankment</tt></font> <br>
<font color="green"><tt> ! 2D BRIDGES</tt></font><br>▼
<font color="blue"><tt>Read GIS Layered FC Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_lfcsh_M04_bridge_001_L.shp</tt></font> <font color="green"><tt> ! Layered flow constriction representing 2D bridge losses</tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
<font color="blue"><tt>Read GIS Z Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_zsh_M02_cut_002_R</tt></font> <font color="green"><tt> ! GIS layer used to define excavation through embankment</tt></font> <br>
<font color="blue"><tt>Read GIS Layered FC Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_lfcsh_M04_bridge_001_L</tt></font> <font color="green"><tt> ! Layered flow constriction representing 2D bridge losses</tt></font> <br>
<li>Save the TGC.
</ol>
The '''2d_zsh_M02_cut_002_R.shp''' file from Module 2 is first read to cut through the embankment. The 2d_lfcsh is then read to represent the structure. The order is important as the 2d_lfcsh has an invert value of 99999, it uses the underlying elevation values to represent the invert of the 2D bridge. If this was read before the 2d_zsh file, it would use the elevation of the embankment crest. <br>
 
=== TUFLOW Control File (TCF) ===
<ol>
<li>Save a copy of '''M02_5m_001.tcf''' as '''M04_5m_001.tcf''' in the '''Module_04\TUFLOW\runs''' folder.
<li>Open the '''M04_5m_001.tcf''' in a text editor and updatemake the following reference to the TGCupdates: <br>
<u>'''QGIS - SHP'''</u> <br>
<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M04_001.tgc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font> <br>
<u>'''QGIS - GPKG'''</u> <br>
<font color="blue"><tt>Spatial Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\M04_001.gpkg</tt></font> <font color="green"><tt> ! Specify the location of the GeoPackage Spatial Database</tt></font> <br>
<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M04_001.tgc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font> <br>
<li>Update both the 2d_po line and point files: <br>
<u>'''QGIS - SHP'''</u> <br>
<font color="blue"><tt>Read GIS PO </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\2d_po_M04_001_L.shp</tt></font> <font color="green"><tt> ! Reads in plot output line</tt></font> <br>
<font color="blue"><tt>Read GIS PO </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\2d_po_M04_001_P.shp</tt></font> <font color="green"><tt> ! Reads in plot output point</tt></font> <br>
<u>'''QGIS - GPKG'''</u> <br>
<font color="blue"><tt>Read GIS PO </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_po_M04_001_L</tt></font> <font color="green"><tt> ! Reads in plot output line</tt></font> <br>
<font color="blue"><tt>Read GIS PO </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_po_M04_001_P</tt></font> <font color="green"><tt> ! Reads in plot output point</tt></font> <br>
<li>Save the TCF.
</ol>
<br>▼
 
== Running the Simulation ==
<ol>
<li>Save a copy of '''_run_M02_HPC.bat''' as '''_run_M04_HPC.bat''' in the '''Module_04\TUFLOW\runs''' folder.
<li>Update the batch file to reference the '''M04_5m_001.tcf''' :<br>
<font color="blue"><tt>'''set'''</tt></font> <font color="black"><tt>exe</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>"..\..\..\exe\2020-10-AF2025.1.0\TUFLOW_iSP_w64.exe"</tt></font> <br>
<font color="blue"><tt>'''set'''</tt></font> <font color="black"><tt>run</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>start "TUFLOW" /wait</tt></font> <font color="orange"><tt> %exe%</tt></font> <font color="black"><tt> -b</tt></font> <br>
<font color="orange"><tt>%run% </tt></font> <font color="black"><tt>M04_5m_001.tcf </tt></font> <br>
<li>Save the batch file and double click it in file explorer to run the simulation.
</ol>
<br>▼
 
== Troubleshooting = =
See tips on common mistakes and troubleshooting steps if the model doesn't run:
:*<u>[[Tutorial_Troubleshooting_QGIS | QGIS]]</u>
<br>
 
== Check Files ==
While the model is running, review the added features are specified correctly:
:*<u>[[Tutorial_M04_Check_Files_QGIS | QGIS - SHP]]</u>
:*<u>[[Tutorial_M04_Check_Files_QGIS_GPKG | QGIS - GPKG]]</u>
<br>
 
== Results ==
When the model is finished, review the results:
:*<u>[[Tutorial_M04_Results_QGIS | QGIS]]</u>
▲<br>
 
= Part 2 - 2D Bridge Structure =
Part 2 replaces the 2d_lfcsh layer representing the bridge with a 2d_bg layer.
 
== GIS Inputs ==
Create, import and view input data:<br>
:*<u>[[Tutorial_M04_002_GIS_Inputs_QGIS | QGIS - SHP]]</u>
:*<u>[[Tutorial_M04_002_GIS_Inputs_QGIS_GPKG | QGIS - GPKG]]</u>
 
== Simulation Control Files ==
=== TUFLOW Geometry Control File (TGC) ===
▲<brol>
<li>Save a copy of '''M04_001.tgc''' as '''M04_002.tgc''' in the '''Module_04\TUFLOW\model''' folder.
<li>Open the '''M04_002.tgc''' in a text editor
<li> Comment out the Read GIS Layered FC Shape command and add the Read GIS BG Shape command: <br>
<u>'''QGIS - SHP'''</u><br>
<font color="green"><tt>! Read GIS Layered FC Shape == gis\2d_lfcsh_M04_bridge_001_L.shp</tt></font><br>
<font color="blue"><tt>Read GIS BG Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bg_M04_002_L.shp</tt></font> <font color="green"><tt> ! Bridge structure representing 2D bridge losses</tt></font> <br>
<u>'''QGIS - GPKG'''</u><br>
▲<font color="green"><tt> ! 2DRead GIS Layered FC Shape == BRIDGES2d_lfcsh_M04_bridge_001_L</tt></font><br>
<font color="blue"><tt>Read GIS BG Shape </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2d_bg_M04_002_L</tt></font> <font color="green"><tt> ! Bridge structure representing 2D bridge losses</tt></font> <br>
<li>Save the TGC.
</ol>
 
=== TUFLOW Control File (TCF) ===
▲<brol>
<li>Save a copy of '''M04_5m_001.tcf''' as '''M04_5m_002.tcf''' in the '''Module_04\TUFLOW\runs''' folder.
<li>Open the '''M04_5m_002.tcf''' in a text editor and make the following reference updates: <br>
<u>'''QGIS - SHP'''</u> <br>
<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M04_002.tgc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font> <br>
<u>'''QGIS - GPKG'''</u> <br>
<font color="blue"><tt>Spatial Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\M04_002.gpkg</tt></font> <font color="green"><tt> ! Specify the location of the GeoPackage Spatial Database</tt></font> <br>
<font color="blue"><tt>Geometry Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\M04_002.tgc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font> <br>
<li> Add the following line in the 'Model Inputs' section: <br>
<font color="blue"><tt>Blank BG FLC Approach </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>METHOD A</tt></font> <font color="green"><tt> ! Automatic superstructure FLC values will be calculated based on the ratio of the depth of the pier layer</tt></font> <br>
<li>Save the TCF.
</ol>
 
== Running the Simulation ==
▲<brol>
<li>Update the batch file created in the first part of Module 4 to reference the '''M04_5m_002.tcf''' file.<br>
<li>Save the batch file and double click it in file explorer to run the simulation.
</ol>
 
== Troubleshooting ==
See tips on common mistakes and troubleshooting steps if the model doesn't run:
:*<u>[[Tutorial_Troubleshooting_QGIS | QGIS]]</u>
 
== Check Files ==
While the model is running, review the added features are specified correctly:
:*<u>[[Tutorial_M04_002_Check_Files_QGIS | QGIS - SHP]]</u>
:*<u>[[Tutorial_M04_002_Check_Files_QGIS_GPKG | QGIS - GPKG]]</u>
 
== Results ==
When the model is finished, review the results:
:*<u>[[Tutorial_M04_002_Results_QGIS | QGIS]]</u>
<br>
 
= Conclusion =
:*A 2d_lfcsh wasand 2d_bg layers were supplied and used to represent a bridge structure in the 2D domain. The invert level of this structure was implied from the underlying topography created by cutting through the road embankment. <br>
:*2d_po structure group was setup and described to enable more detailed result viewing through the structure. <br>
:*Check files were used to review the 2D bridge application.
:*Results were visualised to show water passing through the 2D bridge and the structure group results were assessed. <br>
:*For further training opportunities see <u>[https://tuflow.com/training/training-course-catalogue/ TUFLOW Training Catalogue]</u> and/or contact <u>[mailto:training@tuflow.com training@tuflow.com]</u>. <br>
:*Alternatively, see the <u>[[TUFLOW_Example_Models#Example_Model_Catalogue | TUFLOW Example Models]]</u> to explore the full list of TUFLOW features.
<br>
{{Tips Navigation
Retrieved from "https://wiki.tuflow.com/Tutorial_M04"