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

From Tuflow
Jump to navigation Jump to search
(70 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Review SWMM Check Files ==
+
== SWMM Check Files ==
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 that TUFLOW uses is written to the '''TUFLOW\results''' folder. The QGIS TUFLOW Plugin SWMM Processing Tool, 'GeoPackage -  Create from SWMM inp' can be used to create a spatial GeoPackage version of the data for post simulation review checking.
+
===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.  
  
 
<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 open '''TS02_5m_001_swmm.inp''' in Notepad++.
:*SWMM Input File (inp): Navigate to the '''TUFLOW\results''' folder and select '''TS02_5m_001_swmm.inp'''.
+
<li>Manual Data Review (Optional): Review the Junction, Outfall, Conduit, Losses, and XSections information in the text file.  
 +
</ol>
 +
<br>
 +
 
 +
=== QGIS Data ===
 +
It can be useful to review the inp file created by TUFLOW after all inp files are combined.
 +
<ol>
 +
<li>Navigate to the '''TUFLOW\results''' folder and drag '''TS02_5m_001_swmm.inp''' </u>' 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’.
 
:*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}}
 +
<br>
 +
<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.
 +
<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 ==
 +
Open the TUFLOW check files:
 +
<ol>
 +
<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, 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>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.
 +
<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>
 
<br><br>
<li>Review the '''Links--Conduit''', '''Node--Junction''', '''Nodes--Outfall''' and '''Project--Options''' information to verify the data matches the input values that were entered. <br>
+
{{Video|name=Animation_TS2_Check_03d.mp4|width=1235}}
For a description of the attribute meanings, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD TUFLOW 2023-03-AD release notes]</u>.
+
<br>
 
</ol>
 
</ol>
  
'''<< video >>>'''
+
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>
 +
<br>
  
== Review the TUFLOW Check Files ==
+
== 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.
 
<ol>
 
<ol>
<li>In File Explorer, navigate to the '''TUFLOW\check''' folder and drag and drop '''TS02_5m_001_Check.gpkg''' into QGIS.  
+
<li>Open the '1D Integrity Tool' from the TUFLOW Plugin toolbar.
<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'.
+
<br><br>
<li>Use the 'Apply TUFLOW Styles to Open Layers'.
+
[[File:tuflow_plugin_1D_integrity.png]]
<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.  
+
<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>
 +
'''Note:''' For further information on the 1D Integrity Tool and its functionality, see <u>[[1D Integrity Tool|1D Integrity Tool]]</u>.
 +
<br><br>
 +
<ol>
 +
{{Video|name=Animation_TS2_Check_04d.mp4|width=1350}}
 
<br>
 
<br>
'''<< video >>>'''
+
</ol>
  
 +
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>
 +
<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>
 
<br>
 +
</ol>
 +
<br><br>
  
 
{{Tips Navigation
 
{{Tips Navigation
|uplink=[[TUFLOW_SWMM_Tutorial_M01#Check_Files_and_Results_Output| Back to TUFLOW SWMM Tutorial 1]]
+
|uplink=[[TUFLOW_SWMM_Tutorial_M02#Check_Files_and_Results_Output| Back to TUFLOW SWMM Tutorial 2]]
 
}}
 
}}
 
<br>
 
<br>

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