Difference between revisions of "Tutorial M04"

From Tuflow
Jump to navigation Jump to search
 
(3 intermediate revisions by 3 users not shown)
Line 15: Line 15:
 
= GIS Inputs =
 
= GIS Inputs =
 
Create, import and view input data:<br>
 
Create, import and view input data:<br>
:*<u>[[Tutorial_M04_GIS_Inputs_QGIS | QGIS]]</u>
+
:*<u>[[Tutorial_M04_GIS_Inputs_QGIS | QGIS - SHP]]</u>
 +
:*<u>[[Tutorial_M04_GIS_Inputs_QGIS_GPKG | QGIS - GPKG]]</u>
 
<br>
 
<br>
  
Line 22: Line 23:
 
<ol>
 
<ol>
 
<li>Save a copy of '''M02_001.tgc''' as '''M04_001.tgc''' in the '''Module_04\TUFLOW\model''' folder.
 
<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>
+
<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>' 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="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>
 
<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.
 
<li>Save the TGC.
 
</ol>
 
</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>
+
The '''2d_zsh_M02_cut_002_R''' 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) ===
 
=== TUFLOW Control File (TCF) ===
 
<ol>
 
<ol>
 
<li>Save a copy of '''M02_5m_001.tcf''' as '''M04_5m_001.tcf''' in the '''Module_04\TUFLOW\runs''' folder.  
 
<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 update the reference to the TGC: <br>
+
<li>Open the '''M04_5m_001.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_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>
 
<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>
 
<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_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>
 
<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.
 
<li>Save the TCF.
 
</ol>
 
</ol>
Line 46: Line 58:
 
<li>Save a copy of '''_run_M02_HPC.bat''' as '''_run_M04_HPC.bat''' in the '''Module_04\TUFLOW\runs''' folder.
 
<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>
 
<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-AF\TUFLOW_iSP_w64.exe"</tt></font> <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\2023-03-AF\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="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>
 
<font color="orange"><tt>%run% </tt></font> <font color="black"><tt>M04_5m_001.tcf </tt></font> <br>
Line 60: Line 72:
 
= Check Files =
 
= Check Files =
 
While the model is running, review the added features are specified correctly:
 
While the model is running, review the added features are specified correctly:
:*<u>[[Tutorial_M04_Check_Files_QGIS | QGIS]]</u>
+
:*<u>[[Tutorial_M04_Check_Files_QGIS | QGIS - SHP]]</u>
 +
:*<u>[[Tutorial_M04_Check_Files_QGIS_GPKG | QGIS - GPKG]]</u>
 
<br>
 
<br>
  

Latest revision as of 16:40, 19 September 2024

Introduction

In this module, bridges are represented within the 2D domain. 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.

The GIS layers are:

  • TGC layers:
    1. 2d_lfcsh: A layer used for modelling 2D flow under and over bridges, pipes and other obstructions across the waterway.
    2. 2d_zsh: A layer used to modify Zpt elevations using points, lines and polygons.
  • TCF layers:
    1. 2d_po: A time series data output from 2D domains, for a range of hydraulic parameters.

Module 4 builds from the model created in Module 2. The completed Module 2 model is provided in the Module_04\TUFLOW folder.

GIS Inputs

Create, import and view input data:


Simulation Control Files

TUFLOW Geometry Control File (TGC)

  1. Save a copy of M02_001.tgc as M04_001.tgc in the Module_04\TUFLOW\model folder.
  2. Open the M04_001.tgc in a text editor and add the additional lines below the 'Read GIS Z Shape' command:
    QGIS - SHP
    Read GIS Z Shape == gis\2d_zsh_M02_cut_002_R.shp ! GIS layer used to define excavation through embankment
    Read GIS Layered FC Shape == gis\2d_lfcsh_M04_bridge_001_L.shp ! Layered flow constriction representing 2D bridge losses
    QGIS - GPKG
    Read GIS Z Shape == 2d_zsh_M02_cut_002_R ! GIS layer used to define excavation through embankment
    Read GIS Layered FC Shape == 2d_lfcsh_M04_bridge_001_L ! Layered flow constriction representing 2D bridge losses
  3. Save the TGC.

The 2d_zsh_M02_cut_002_R 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.

TUFLOW Control File (TCF)

  1. Save a copy of M02_5m_001.tcf as M04_5m_001.tcf in the Module_04\TUFLOW\runs folder.
  2. Open the M04_5m_001.tcf in a text editor and make the following reference updates:
    QGIS - SHP
    Geometry Control File == ..\model\M04_001.tgc ! Reference the TUFLOW Geometry Control File
    QGIS - GPKG
    Spatial Database == ..\model\gis\M04_001.gpkg ! Specify the location of the GeoPackage Spatial Database
    Geometry Control File == ..\model\M04_001.tgc ! Reference the TUFLOW Geometry Control File
  3. Update both the 2d_po line and point files:
    QGIS - SHP
    Read GIS PO == ..\model\gis\2d_po_M04_001_L.shp ! Reads in plot output line
    Read GIS PO == ..\model\gis\2d_po_M04_001_P.shp ! Reads in plot output point
    QGIS - GPKG
    Read GIS PO == 2d_po_M04_001_L ! Reads in plot output line
    Read GIS PO == 2d_po_M04_001_P ! Reads in plot output point
  4. Save the TCF.


Running the Simulation

  1. Save a copy of _run_M02_HPC.bat as _run_M04_HPC.bat in the Module_04\TUFLOW\runs folder.
  2. Update the batch file to reference the M04_5m_001.tcf :
    set exe="..\..\..\exe\2023-03-AF\TUFLOW_iSP_w64.exe"
    set run=start "TUFLOW" /wait %exe% -b
    %run% M04_5m_001.tcf
  3. Save the batch file and double click it in file explorer to run the simulation.


Troubleshooting

See tips on common mistakes and troubleshooting steps if the model doesn't run:


Check Files

While the model is running, review the added features are specified correctly:


Results

When the model is finished, review the results:


Conclusion

  • A 2d_lfcsh was 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.
  • 2d_po structure group was setup and described to enable more detailed result viewing through the structure.
  • 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.


Up
Go-up.png Back to Tutorial Introduction Main Page