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

From Tuflow
Jump to navigation Jump to search
 
(48 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
== Review SWMM Check Files ==
 
== Review SWMM Check Files ==
When TUFLOW runs SWMM it can acomodate 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.
+
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, '<u>[[QGIS_SWMM_GeoPackage_Create_from_SWMM_inp |GeoPackage - Create from SWMM inp ]]</u>' can be used to create a spatial GeoPackage version of the data for post simulation review checking.
  
 
<ol>
 
<ol>
<li>In the Processing Toolbox, select the 'GeoPackage - Create from SWMM inp' tool.
+
<li>In the Processing Toolbox, go to TUFLOW >> SWMM and select '<u>[[QGIS_SWMM_GeoPackage_Create_from_SWMM_inp |GeoPackage - Create from SWMM inp ]]</u>'. This opens the dialog shown below.
<li> Select: GeoPackage Input File: Navigate to the '''TUFLOW\results''' folder and select '''TS01_5m_001_swmm.inp'''.
+
:*SWMM Input File (inp): Navigate to the '''TUFLOW\results''' folder and select '''TS01_5m_001_swmm.inp'''.
<li> Set the CRS for GepPackage: WGS 84 / UTM Zone 60S.
+
:*CRS for GeoPackage: Click the drop down menu and select ‘Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
<li> Leave SWMM Tags to ignore blank.
+
:*SWMM Tags to ignore: leave blank.
<li> Set the GeoPackage output filename: TS01_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 '''TS01_5m_001_swmm_check.gpkg'''.
 +
 
 
<li>Click 'Run'.
 
<li>Click 'Run'.
<li>Once the tool is finished, click 'Close'.
+
<li>Once the tool has finished, click 'Close'.
<li>The '''TS01_5m_001_swmm_check.gpkg''' will now be located in the '''TUFLOW\results''' folder.
+
<li>'''TS01_5m_001_swmm_check.gpkg''' will now be available in the '''TUFLOW\check''' folder.  
 +
<li>In Windows File Explorer, navigate to the '''TUFLOW\check''' folder and drag and drop '''TS01_5m_001_swmm_check.gpkg''' into QGIS.
 +
<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all layers within '''TS01_5m_001_swmm_check.gpkg'''. By default, all items in the available list should have been selected.
 +
<br><br>
 +
{{Video|name=Animation_TS1_Check_01d.mp4|width=1236}}<br>
 +
<li>Review the '''Links--Conduits''', '''Nodes--Outfalls''', '''Nodes--Storage''' and '''Project--Options''' information to verify the data matches the input values that were entered. <br>
 +
For a description of the attributes, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD TUFLOW 2023-03-AD release notes]</u>.
 +
<br><br>
 +
{{Video|name=Animation_TS1_Check_02d.mp4|width=1236}}<br>
 
</ol>
 
</ol>
 
<br>
 
<br>
  
 +
== Review TUFLOW Check Files ==
 
<ol>
 
<ol>
<li> Open TS01_5m_001_swmm_check.gpkg in QGIS. When prompted, open all Layers inculded in the GepPackage.
+
<li>In File Explorer, navigate to the '''TUFLOW\check''' folder and drag and drop '''TS01_5m_001_Check.gpkg''' into QGIS.  
<li> Review the '''Links--Conduit''', '''Node--Junction''', '''Nodes--Outfall''' and '''Project--Options''' match the input values that were entered.
+
<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select '''TS01_5m_001_1d_to_2d_check_R''' and '''TS01_5m_001_grd_check_R''' (hold Ctrl to select multiple). Click 'Add Layers'.
 +
<li>Use the 'Apply TUFLOW Styles to Open Layers'.
 +
<li>The [[Check_Files_2d_grd | _grd_check_R]] is the 2D grid defined by the '''2d_code_M01_001_R''' layer and contains a region object for each cell. This is a useful check file to understand how the model is orientated and the 2D cell size in relation to the 2D hydraulic controls and 1D hydraulic structures. In this tutorial, the grid is orientated to align with the downstream road.
 +
<br><br>
 +
{{Video|name=Animation_TS1_Check_03e.mp4|width=1236}}<br>
 +
<li>The [[Check_Files_1d_to_2d_bc | _1d_to_2d_check_R]] file shows the cells selected by the SX boundary links (these connect the 1D SWMM objects to 2D TUFLOW). It is recommended that the number of selected cells has at least the width (i.e. cell side length x number of cells) of the associated 1D culvert. In this case, each cell is 5m wide and each 2D linkage is 10m wide.  
 +
<li>Zoom to each structure to inspect the HX and SX connections to ensure the '''2d_bc_SWMM_Culvert_Connections_001_L''' layer is appropriate.
 +
<br><br>
 +
{{Video|name=Animation_TS1_Check_04c.mp4|width=1236}}<br>
 
</ol>
 
</ol>
 
<br>
 
<br>
<font color="red">'''<< Add video >>'''</font>
 
 
== Review the TUFLOW Check Files ==
 
:*[[Check_Files_2d_grd | _grd_check_R]]
 
:*[[Check_Files_1d_to_2d_bc | _1d_to_2d_check_R]]
 
 
 
<ol>
 
<li>Open the files, either:
 
:*Within the QGIS Browser Panel, navigate to '''TUFLOW_SWMM_Module_01\TUFLOW\check\TS01_5m_001_Check.gpkg''' and double click the following layers, or
 
::*'''TS01_5m_001_grd_check_R'''
 
::*'''TS01_5m_001_1d_to_2d_check_R'''
 
 
 
:*In Windows Explorer, navigate to the '''TUFLOW_SWMM_Module_01\TUFLOW\check''' folder, drag and drop the '''TS01_5m_001_Check.gpkg''' into the QGIS workspace and select the layers above (hold Ctrl to select multiple).
 
 
 
 
 
<li>Use the 'Apply TUFLOW Styles to Open Layers'.
 
<li>Use the 'Apply GPKG Layer Names'.
 
<li>The grd_check is the 2D grid defined by the 2d_code layer and contains a region object for each cell. It is useful to understand how the model is orientated, the cell size in relation to the hydraulic features and where certain calculations occur in the model. In this tutorial, the grid is orientated to align with the downstream road.
 
<li>The '''nwk_C_check_L''' file shows all attributes applied to the network elements. Some fields should be inspected as they have changes from the input '''1d_nwk_M03_culverts''' layer:
 
:*Len_or_ANA: contains the length used by TUFLOW (determined by the digitised line).
 
:*pSlope: the slope of the 1D element.<br>
 
 
<br>
 
<font color="red">'''<< Add video >>'''</font>
 
  
<li>The '''1d_to_2d_check_R''' file shows the cells selected by the SX boundary links. It is recommended the same number of linking cells is selected at both the upstream and downstream of the culverts and that the number of selected cells is proportional to the structure size. Zoom to each structure to inspect the SX links:
+
{{Tips Navigation
:*The point SX selects a single cell in which the point falls. <br>
 
:*The region SX selects all cells where the cell centers fall within the region.
 
:*The line SX selects cells which are intercepted by the line using the crosshair approach. For example, the dashed lines below are the hidden crosshairs within a cell. An SX line must intersect at least one of these crosshairs to be selected:<br>
 
<ol>
 
<br>
 
[[File:Cross-hair approach.png | 300px]]</ol>
 
<br>
 
<font color="red">'''<< Add video >>'''</font>
 
</ol>
 
<br>
 
</ol>{{Tips Navigation
 
 
|uplink=[[TUFLOW_SWMM_Tutorial_M01#Check_Files_and_Results_Output| Back to TUFLOW SWMM Tutorial 1]]
 
|uplink=[[TUFLOW_SWMM_Tutorial_M01#Check_Files_and_Results_Output| Back to TUFLOW SWMM Tutorial 1]]
 
}}
 
}}
 
<br>
 
<br>

Latest revision as of 16:27, 20 May 2024

Review 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.

  1. In the Processing Toolbox, go to TUFLOW >> SWMM and select 'GeoPackage - Create from SWMM inp '. This opens the dialog shown below.
    • SWMM Input File (inp): Navigate to the TUFLOW\results folder and select TS01_5m_001_swmm.inp.
    • 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 TS01_5m_001_swmm_check.gpkg.
  2. Click 'Run'.
  3. Once the tool has finished, click 'Close'.
  4. TS01_5m_001_swmm_check.gpkg will now be available in the TUFLOW\check folder.
  5. In Windows File Explorer, navigate to the TUFLOW\check folder and drag and drop TS01_5m_001_swmm_check.gpkg into QGIS.
  6. When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all layers within TS01_5m_001_swmm_check.gpkg. By default, all items in the available list should have been selected.


  7. Review the Links--Conduits, Nodes--Outfalls, Nodes--Storage and Project--Options information to verify the data matches the input values that were entered.
    For a description of the attributes, refer to TUFLOW 2023-03-AD release notes.



Review TUFLOW Check Files

  1. In File Explorer, navigate to the TUFLOW\check folder and drag and drop TS01_5m_001_Check.gpkg into QGIS.
  2. When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select TS01_5m_001_1d_to_2d_check_R and TS01_5m_001_grd_check_R (hold Ctrl to select multiple). Click 'Add Layers'.
  3. Use the 'Apply TUFLOW Styles to Open Layers'.
  4. The _grd_check_R is the 2D grid defined by the 2d_code_M01_001_R layer and contains a region object for each cell. This is a useful check file to understand how the model is orientated and the 2D cell size in relation to the 2D hydraulic controls and 1D hydraulic structures. In this tutorial, the grid is orientated to align with the downstream road.


  5. The _1d_to_2d_check_R file shows the cells selected by the SX boundary links (these connect the 1D SWMM objects to 2D TUFLOW). It is recommended that the number of selected cells has at least the width (i.e. cell side length x number of cells) of the associated 1D culvert. In this case, each cell is 5m wide and each 2D linkage is 10m wide.
  6. Zoom to each structure to inspect the HX and SX connections to ensure the 2d_bc_SWMM_Culvert_Connections_001_L layer is appropriate.



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