Difference between revisions of "TUFLOW SWMM Tutorial M02 Check QGIS"

From Tuflow
Jump to navigation Jump to search
(52 intermediate revisions by 4 users not shown)
Line 4: Line 4:
  
 
<ol>
 
<ol>
<li> Open '''TS02_5m_001_swmm.inp''' from '''TUFLOW\results''' in a text editor (for example Notepad++).
+
<li>Navigate to the '''TUFLOW\results''' folder and open '''TS02_5m_001_swmm.inp''' in Notepad++.
<li> Review the Junction, Outfall, Conduit, Losses, and XSections information.  
+
<li>Manual Data Review (Optional): Review the Junction, Outfall, Conduit, Losses, and XSections information in the text file.  
</ol>'''<<video>>'''
+
</ol>
 +
<br>
  
 
=== QGIS Data ===
 
=== QGIS Data ===
The QGIS TUFLOW Plugin SWMM Processing Tool, 'GeoPackage -  Create from SWMM inp' can be used to create a spatial GeoPackage version of the INP data for post simulation review checking.
+
It can be useful to review the inp file created by TUFLOW after all inp files are combined.
 
<ol>
 
<ol>
<li>In the Processing Toolbox, select 'GeoPackage -  Create from SWMM inp'. This opens the dialog shown below.
+
<li>Navigate to the '''TUFLOW\results''' folder and drag '''TS02_5m_001_swmm.inp''' </u>' into QGIS. This opens the dialog shown below.
:*SWMM Input File (inp): Navigate to the '''TUFLOW\results''' folder and select '''TS02_5m_001_swmm.inp'''.
 
 
:*CRS for GeoPackage: Click the drop down menu and select ‘Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
 
:*CRS for GeoPackage: Click the drop down menu and select ‘Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
 
:*SWMM Tags to ignore: leave blank.
 
:*SWMM Tags to ignore: leave blank.
:*GeoPackage output filename: Click the ... and select 'Save to GeoPackage'. Navigate to the '''TUFLOW\check''' folder and set the GeoPackage output filename to '''TS02_5m_001_swmm_check.gpkg'''.
+
:*GeoPackage output filename: Click the ... and select 'Save to File'. Navigate to the '''TUFLOW\check''' folder and set the GeoPackage output filename to '''TS02_5m_001_swmm_check.gpkg'''.
 
<li>Click 'Run'.
 
<li>Click 'Run'.
 
<li>Once the tool has finished, click 'Close'.
 
<li>Once the tool has finished, click 'Close'.
<li>'''TS02_5m_001_swmm_check.gpkg''' will now be available in the '''TUFLOW\check''' folder.
+
<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all layers within '''TS02_5m_001_swmm_check.gpkg'''. By default, all items in the available list should have been selected.
<li>In File Explorer, navigate to the '''TUFLOW\check''' folder and drag and drop '''TS02_5m_001_swmm_check.gpkg''' into QGIS.
+
<br><br>
<li>When prompted by QGIS, select 'Add Layers to open all layers within '''TS02_5m_001_swmm_check.gpkg'''. By default, all items in the available list should have been selected.
+
{{Video|name=Animation_TS2_Check_01d.mp4|width=1235}}
<li> Review the '''Link--Conduits''', '''Nodes--Junctions''' and '''Node--Outfalls''' information. This data represents the pipe network details.
+
<br>
<li> Enable "Labels" for the Elevation attribute in '''Nodes--Junctions'''. In the next step, we will compare these pipe invert elevations against the TUFLOW check files reporting the surface inlet details and 1D/2D linkage locations.
+
<li>Manual Data Review (Optional): Review the '''Link--Conduits''', '''Nodes--Junctions''' and '''Node--Outfalls''' information to verify the data matches the input values. This data represents the 1D pipe network details.
</ol>'''<<video>>'''
+
<br><br>
 +
{{Video|name=Animation_TS2_Check_02c.mp4|width=1235}}
 +
<br>
 +
<li>Since the layers in '''TS02_5m_001_swmm_check.gpkg''' have been compared with the input layers, the input layers can be removed from the QGIS workspace.
 +
</ol>
 +
<br>
  
 
== TUFLOW Check Files ==
 
== TUFLOW Check Files ==
 +
Open the TUFLOW check files:
 
<ol>
 
<ol>
<li>In File Explorer, navigate to the '''TUFLOW\check''' folder and drag and drop '''TS02_5m_001_Check.gpkg''' into QGIS.  
+
<li>In Windows File Explorer, navigate to the '''TUFLOW\check''' folder and drag and drop '''TS02_5m_001_Check.gpkg''' and '''TS02_5m_001_DEM_Z.tif''' (hold Ctrl to select multiple) into QGIS.  
<li>When prompted by QGIS, select '''TS02_5m_001_swmm_pit_P''' and '''TS02_5m_001_1d_to_2d_check_R''' (hold Ctrl to select multiple), then click 'Add Layers'.
+
<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select '''TS02_5m_001_1d_to_2d_check_R''' and '''TS02_5m_001_swmm_pit_P''' (hold Ctrl to select multiple). Click 'Add Layers'.
 
<li>Use the 'Apply TUFLOW Styles to Open Layers'.
 
<li>Use the 'Apply TUFLOW Styles to Open Layers'.
<li>Also open, '''TS02_5m_001_DEM_Z''' from '''TUFLOW\check'''. Style the topography check file using the same hillshade styling you used for the input DEM model geometry. Order this Layer lowest in the QGIS Layer panel so all other datasets are visible above the DEM_Z check file raster.  
+
<li>Style '''TS02_5m_001_DEM_Z.tif''' (the topography check file) using the same hillshade styling as '''DEM_Hillshade''':
<li>  
+
:*In the QGIS Layers Panel, right click '''DEM_Hillshade''' and select Styles > Copy Style.
 +
:*Right Click '''TS02_5m_001_DEM_Z.tif''' and select Styles > Paste Style.
 +
<li>In the QGIS Layers Panel, move the '''TS02_5m_001_DEM_Z.tif''' layer below the other check files so that the other datasets are visible.
 +
<br><br>
 +
{{Video|name=Animation_TS2_Check_03d.mp4|width=1235}}
 +
<br>
 +
</ol>
  
 +
Manual Data Review (Optional): Compare the 2D check files information against the the 1D check files to verify the model design is as intended.
 +
<ol>
 +
<li>How does the the pipe network invert elevations '''(Nodes--Junctions)''' compare to the the pit inlet (surface) elevations?
 +
<br>
 
</ol>
 
</ol>
 
+
<br>
'''<<video>>'''
 
 
 
Compare the 2D check files information against the the 1D check files to verify the model design is as intended. For example:
 
 
 
# How does the the pipe network invert elevations ('''Nodes--Junctions)''' compare to the the pit inlet (surface) elevations.
 
# Do the SWMM values for the Ysur and Apond at the pit inlet and closed junction locations vary? Do they match the values we specified when constructing the model?
 
 
 
'''<<video>>'''
 
  
 
== TUFLOW Pipe Integrity Tool ==
 
== TUFLOW Pipe Integrity Tool ==
The manual data review exercises outlined above can be simplified using the visal profile plot tools included in the QGIS TUFLOW Pipe Integrity Toolkit.
+
Some of the optional manual data review exercises suggested in the previous sections can be easily carried out using the QGIS TUFLOW Plugin 'Pipe Integrity Toolkit', specifically the visual profile plot tools.
 
<ol>
 
<ol>
<li>From the TUFLOW plugin, open the 1D Integrity tool.<br>[[File: integrity_tool_in_toolbar.PNG]].<br>
+
<li>Open the '1D Integrity Tool' from the TUFLOW Plugin toolbar.
 +
<br><br>
 +
[[File:tuflow_plugin_1D_integrity.png]]
 +
<br><br>
 +
<li>The resulting dialog will appear.
 +
<br><br>
 +
[[File:1D_Integrity_dialog_2.png]]
 +
<br><br>
 +
<li>Set up the tool for this model:
 +
:*Input Network Lines: Use the dropdown box and select '''TS02_5m_001_swmm_check >> Links--Conduits'''. Click the '+' button to add the layer as an input to the tool.
 +
:*Input Network Points: Using the same process as above, add '''TS02_5m_001_swmm_check >> Nodes--Junctions''' and '''TS02_5m_001_swmm_check  >> Nodes--Outfalls''' to the tool.
 +
:*Input Tables: Leave blank as it is not used for SWMM data review.
 +
:*Input DEM: Tick on and use the dropdown box to select '''TS02_5m_001_DEM_Z'''.
 
</ol>
 
</ol>
The resulting dialogue will pop up.  The numbered fields are described below.<br>
+
'''Note:''' For further information on the 1D Integrity Tool and its functionality, see <u>[[1D Integrity Tool|1D Integrity Tool]]</u>.
 +
<br><br>
 
<ol>
 
<ol>
[[File:integrity_tool_overview.PNG]]<br>
+
{{Video|name=Animation_TS2_Check_04d.mp4|width=1350}}
<br>'''1. Input Network Lines''' - Select '''Link--Conduits'''. Use dropdown box and '+' button to add layers as inputs to tool.<br>'''2. Input Network Points''' - Select '''Nodes--Junctions''' and '''Node--Outfalls'''. Use dropdown box and '+' button to add layers as inputs to tool.<br>'''3. Input Tables''' - Not used for SWMM data review.<br>'''4. Input DEM''' - Select '''TS02_5m_001_DEM_Z'''.<br>'''5. Tool Selection''' - The active tab will determine the active tool. See [[#Tool_Documentation|Tool Documentation]] for information on each tool.<br>'''6.  Status Bar''' - Contains the progress bar and status of the integrity tool. Includes information such as the current active task being performed (if one of the tools is running), and the status of the previously run tool.<br>'''7.  Run''' - Runs the currently active tool (active tool determined by the current active tool tab - prior to plugin version 3.2 a radio button was used to select the active tool).
+
<br>
 +
</ol>
  
<br>The following example demonstrates use of the Flow Trace tool to create a profile plot for data input review.
+
The following example demonstrates the 'Flow Trace' tool. It will be used to create a profile plot for visual review of the 1D pipe network data input.
 
+
<ol>
'''<<video>>'''
+
<li>In the QGIS Layers Panel, right click '''Links--Conduits''' and select 'Zoom to Layer(s)'.
 +
<li>Use the 'Select Features' tool to select conduit 'Pipe6'.
 +
<li>At the bottom of the 1D Integrity tool dialog, there is a list of tools. Select the 'Flow Trace' tab.
 +
<li>Enter the following options:
 +
<br><br>
 +
[[File:1D_Integrity_flow_trace_options.png]]
 +
<br><br>
 +
<li>Click 'Run'.
 +
<li>The tool will select all the upstream conduits and also add another output layer identifying the locations which fail the flow area and invert checks.
 +
<li>A Flow Trace window will appear. It provides a 'long plot' of the long sections of the various upstream paths from the selected conduit, highlighting the areas of continuity failures. The plot should be consistent with the output GIS layer that is also generated by the flow trace tool.
 +
<br><br>
 +
{{Video|name=Animation_TS2_Check_05d.mp4|width=1350}}
 +
<br>
 
</ol>
 
</ol>
 
+
<br><br>
 
 
 
 
 
  
 
{{Tips Navigation
 
{{Tips Navigation

Revision as of 04:40, 16 April 2024

SWMM Check Files

Text Data

When TUFLOW runs SWMM, it can accommodate for multiple INP input files within the SWMM Control file. TUFLOW combines the input INP files into a single combined INP file for the simulation execution. The combined file TUFLOW uses is written to the TUFLOW\results folder.

  1. Navigate to the TUFLOW\results folder and open TS02_5m_001_swmm.inp in Notepad++.
  2. Manual Data Review (Optional): Review the Junction, Outfall, Conduit, Losses, and XSections information in the text file.


QGIS Data

It can be useful to review the inp file created by TUFLOW after all inp files are combined.

  1. Navigate to the TUFLOW\results folder and drag TS02_5m_001_swmm.inp ' into QGIS. This opens the dialog shown below.
    • CRS for GeoPackage: Click the drop down menu and select ‘Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
    • SWMM Tags to ignore: leave blank.
    • GeoPackage output filename: Click the ... and select 'Save to File'. Navigate to the TUFLOW\check folder and set the GeoPackage output filename to TS02_5m_001_swmm_check.gpkg.
  2. Click 'Run'.
  3. Once the tool has finished, click 'Close'.
  4. When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all layers within TS02_5m_001_swmm_check.gpkg. By default, all items in the available list should have been selected.


  5. Manual Data Review (Optional): Review the Link--Conduits, Nodes--Junctions and Node--Outfalls information to verify the data matches the input values. This data represents the 1D pipe network details.


  6. Since the layers in TS02_5m_001_swmm_check.gpkg have been compared with the input layers, the input layers can be removed from the QGIS workspace.


TUFLOW Check Files

Open the TUFLOW check files:

  1. In Windows File Explorer, navigate to the TUFLOW\check folder and drag and drop TS02_5m_001_Check.gpkg and TS02_5m_001_DEM_Z.tif (hold Ctrl to select multiple) into QGIS.
  2. When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select TS02_5m_001_1d_to_2d_check_R and TS02_5m_001_swmm_pit_P (hold Ctrl to select multiple). Click 'Add Layers'.
  3. Use the 'Apply TUFLOW Styles to Open Layers'.
  4. Style TS02_5m_001_DEM_Z.tif (the topography check file) using the same hillshade styling as DEM_Hillshade:
    • In the QGIS Layers Panel, right click DEM_Hillshade and select Styles > Copy Style.
    • Right Click TS02_5m_001_DEM_Z.tif and select Styles > Paste Style.
  5. In the QGIS Layers Panel, move the TS02_5m_001_DEM_Z.tif layer below the other check files so that the other datasets are visible.


Manual Data Review (Optional): Compare the 2D check files information against the the 1D check files to verify the model design is as intended.

  1. How does the the pipe network invert elevations (Nodes--Junctions) compare to the the pit inlet (surface) elevations?


TUFLOW Pipe Integrity Tool

Some of the optional manual data review exercises suggested in the previous sections can be easily carried out using the QGIS TUFLOW Plugin 'Pipe Integrity Toolkit', specifically the visual profile plot tools.

  1. Open the '1D Integrity Tool' from the TUFLOW Plugin toolbar.

    Tuflow plugin 1D integrity.png

  2. The resulting dialog will appear.

    1D Integrity dialog 2.png

  3. Set up the tool for this model:
    • Input Network Lines: Use the dropdown box and select TS02_5m_001_swmm_check >> Links--Conduits. Click the '+' button to add the layer as an input to the tool.
    • Input Network Points: Using the same process as above, add TS02_5m_001_swmm_check >> Nodes--Junctions and TS02_5m_001_swmm_check >> Nodes--Outfalls to the tool.
    • Input Tables: Leave blank as it is not used for SWMM data review.
    • Input DEM: Tick on and use the dropdown box to select TS02_5m_001_DEM_Z.

Note: For further information on the 1D Integrity Tool and its functionality, see 1D Integrity Tool.


The following example demonstrates the 'Flow Trace' tool. It will be used to create a profile plot for visual review of the 1D pipe network data input.

  1. In the QGIS Layers Panel, right click Links--Conduits and select 'Zoom to Layer(s)'.
  2. Use the 'Select Features' tool to select conduit 'Pipe6'.
  3. At the bottom of the 1D Integrity tool dialog, there is a list of tools. Select the 'Flow Trace' tab.
  4. Enter the following options:

    1D Integrity flow trace options.png

  5. Click 'Run'.
  6. The tool will select all the upstream conduits and also add another output layer identifying the locations which fail the flow area and invert checks.
  7. A Flow Trace window will appear. It provides a 'long plot' of the long sections of the various upstream paths from the selected conduit, highlighting the areas of continuity failures. The plot should be consistent with the output GIS layer that is also generated by the flow trace tool.




Up
Go-up.png Back to TUFLOW SWMM Tutorial 2