TUFLOW SWMM Tutorial M02: Difference between revisions

This tutorial, Module 2 of the TUFLOW SWMM tutorial dataset will demonstrate how to model underground stormwater pipe networks using SWMM, linked to the TUFLOW HPC 2D solution scheme. <br>Boundary condition inflows to the model are defined using TUFLOW's 2D direct rainfall (rain on grid) approach. TUFLOW SWMM Tutorial Module 2 builds from the model created in <u>[[TUFLOW_SWMM_Tutorial_M01|TUFLOW SWMM Tutorial Module 1]]</u>. The completed TUFLOW SWMM Module 1 model is provided in the '''''TUFLOW_SWMM_Module_02\TUFLOW''''' folder of the download dataset as the starting point for this tutorial. If you are not already familiar with TUFLOW SWMM linking, we recommend first completing TUFLOW SWMM Module 1 beforeprior to starting this tutorial. <br>

= QGIS Project Initialization =

<li>In File Explorer, navigateNavigate to the '''TUFLOW_SWMM_Module_02\TUFLOW\runs''' folder and select '''TS01_5m_001.tcf'''.

Style the TUFLOW layers. Suggested styling steps were provided in <u>[[TUFLOW_SWMM_Tutorial_M01#QGIS_Project_InitializationProject_Initialization|TUFLOW SWMM Tutorial M01]]</u>. They have not been duplicated here.<br>

= SWMMGIS Inputs =

InWe QGIS,will create a new SWMM GeoPackage Databasedatabase for the newour pipe network features we'll be adding to thefeature modelentries:

<li>Go to '''Processing > Toolbox''' from the top dropdown menu options to open the Processing Toolbox Panel.

<li>Go to '''TUFLOW >> SWMM''' in the processing tool list and select '<u>[[QGIS_SWMM_GeoPackage_Create |GeoPackage - Create]]</u>'. This opens the dialog shown below.

:*To set the ‘Initial SWMM Sections’: Click the …, and tick on (if not already ticked):

:*:*'''ProjectNodes--TitleJunctions''', '''ProjectNodes--ReportOutfalls.'''

:*:*'''NodesLinks--Junctions'''Conduits, '''NodesLinks--OutfallsStreets.'''

:*:*'''Links--Conduits, Links--Streets''', '''LinksInlets--Inlets.'''.

<li>Once tothe tool has finished, click ‘Close’.

<li>In Windows File Explorer, navigate to the '''TUFLOW\model\swmm''' folder and drag and drop '''sw02_001.gpkg''' into QGIS.

<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all vectors within '''sw02_001.gpkg'''. By default, all items in the available list should have been selected.

A GeoPackage called '''Urban_Development.gpkg''' is provided in the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder. It contains three SWMM input layers (and five other geometry input layers to be used later in the module):

To populate the GeoPackage database created in the previous section:

<li>In Windows File Explorer, navigate to the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder. Drag and drop the '''Urban_Development.gpkg''' into QGIS.

<li>When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select '''Pipes''', '''Junctions''' and '''Outfalls''' (hold Ctrl to select multiple). then clickClick 'Add Layers'.

<li>In the QGIS Layers Panel, right click on the '''Pipes''' layer and select 'Zoom to Layer(s)'.

<li>Select 'Edit' from the top QGIS tab and 'Copy Features' from the drop down manumenu.

<li>SelectIn the QGIS Layers Panel, select (left click) the '''Links--Conduits''' layer in the Layers Panel by left clicking on it once.

{{Video|name=Animation_TS2_SWMM_Inputs_02aAnimation_TS2_SWMM_Inputs_02d.mp4|width=12351236}}<br>

<li>Similarly, copy the objects from '''Junctions''' into '''Nodes--Junctions'''. Junctions are considered inlets, and should be defined at the upstream end of isolated culverts and all upstream ends of pipes within a network.

<li>Also copy the objects from '''Outfalls''' into '''Nodes--Outfalls'''. Outfalls are treated as outlets, and are required at the downstream end of isolated culverts and the most downstream end of a pipe network.

<li>Toggle off editing to save the edits.

<li>CloseRemove '''Urban_Development.gpkg'''.

{{Video|name=Animation_TS2_SWMM_Inputs_03aAnimation_TS2_SWMM_Inputs_03c.mp4|width=12351236}}<br>

{{Video|name=Animation_TS2_SWMM_Inputs_04aAnimation_TS2_SWMM_Inputs_04c.mp4|width=12351236}}<br>

The following updates are being made to Objectsobjects and Layerslayers within '''sw02_001.gpkg'''.

An Inlet Usage Layer defines the physical location of inlets to the pipe network. It also defines some of the site specific geometry, such as Inletinlet type, Elevationstreet cross-section reference, Slopesurface inlet elevation, Placementplacement type (on-gradesag orand on-saggrade). To reduce data entry requirements for this tutorial, a complete Inlet Usage Layer has been provided, '''swmm_iu_TS02_001'''. It includes a variety of on-sag and on-grade inlets. On-sag inlets are used in locations where the inlet is located in an area of minimal longtudial slope. In this situation ponded surface water enters the pipe network. On-grade inlets are used where bypass flow is expected due to the inlet location being on a slope. For on-grade inlets, TUFLOW SWMM captures a percentage of the “approach flow” based on several factors including the total 2D approach flow, velocity and depth.<br>

When you progress from this tutorial to project modellingmodeling, you will need to create an Inlet Usage Layer yourself. The template file for this is available from '''model\gis\empty\swmm_iu_empty.gpkg'''. The file is created during the initial 'Write Empty' step of the model build process (refer to <u>[[Tutorial_M01#Project_Initialisation | TUFLOW Tutorial Model 1]]</u>). A summary of the attributes within the Inlet Usage Layer is documented in <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-TUFLOW-1.html#tab:tab-SWMMinletusage TUFLOW 2023-03-AD Release Notes (Table 4.1)]</u>

The "'Inlet"' Attribute within '''swmm_iu_TS02_001''' is an ID reference to inlet geometry and associated information listed within '''sw02_001.gpkg''' >> '''Inlets--InletInlets'''. A single inlet type, 'Combo1', was referenced in '''swmm_iu_TS02_001''' (the provided Inlet Usage Layer). In recognition of this, we need to create the entry for "'Combo1"' in the '''Inlets--InletInlets''' Layerlayer.

<li>In the QGIS Layers Panel, select (left click) '''Inlets--InletInlets''' and toggle on editing.

<li>Right click '''Inlets--InletInlets''' and select 'Open Attribute Table'.

:*Grate_Length: 10.56

:*Grate_Width: 0.53

:*Curb_Length: 10.59

:*Curb_Height: 0.215

{{Video|name=Animation_TS2_SWMM_Inputs_05aAnimation_TS2_SWMM_Inputs_05c.mp4|width=12351236}}

:*Tcrown: 107

:*Sback: 42

{{Video|name=Animation_TS2_SWMM_Inputs_06aAnimation_TS2_SWMM_Inputs_06c.mp4|width=12351236}}

The ''From Node'' and ''To Node'' attribute information in '''Links---Conduits''' is necessary to "build" the 1D SWMM network. It defines the Linklink/Nodenode connections. The information we will be adding to '''Links--Conduits''' is extracted from '''Nodes--Junctions''' and '''Nodes--Outfalls''' automatically using the '<u>[[QGIS_SWMM_Conduits_Assign_Node_Fields |Conduits - Assign Nodenode Fieldsfields]]</u>' tool from the Processing Toolbox.

<li>Go to TUFLOW >> SWMM in the processing tool list and select '<u>[[QGIS_SWMM_Conduits_Assign_Node_Fields |Conduits - Assign Nodenode Fieldsfields]]</u>'. This opens the dialog shown below.

<li>Tick on the SWMM Node Layers: '''sw02_001 >> Nodes--Junctions''' and '''sw02_001 >> Nodes--Outfalls'''.

<li>View the attributes associated within '''Links--Conduits''' to verify the data processing has been completed correctly. The ''From Node'' and ''To Node'' attribute information is now configured correctly. <br>

{{Video|name=Animation_TS2_SWMM_Inputs_07aAnimation_TS2_SWMM_Inputs_07c.mp4|width=12351236}}

====Update Losses====

Update the loss attributes in the '''Links--Conduits''' Layerlayer. These values will be entered automatically using the '<u>[[QGIS_SWMM_Conduits_Assign_Losses |Conduits - Assign losses]]</u>' tool from the Processing Toolbox.

<li>In the Processing Toolbox, selectensure the 'Edit Features In-Place' tool [[File:edit_features_in_place_icon.png]]. This allows the editing of an existing layer, instead of the creation of ais newstill layerselected.

<li>Go to TUFLOW >> SWMM in the processing tool list and select '<u>[[QGIS_SWMM_Conduits_Assign_Losses |Conduits - Assign losses]]</u>'. This opens the dialog shown below.

:*Input inlet usage featureslayers: '''swmm_iu_TS02_001'''.

:*EntranceCulvert lossopening furthest- upstreamEntrance channelsloss: 0.5

<li>View the attributes associated within '''Links--Conduits''' to verify the data processing has been completed correctly. The 'losses_Kentry', 'losses_Kexit' and 'losses_Kavg' attribute information is now configured correctly.

{{Video|name=Animation_TS2_SWMM_Inputs_08aAnimation_TS2_SWMM_Inputs_08d.mp4|width=12351236}}

The 1D SWMM / 2D TUFLOW linkage locations to connect the pipe network inlets to the surface have been already automatically been defined in the SWMM Inlet Usage Layer, '''swmm_iu_TS02_001''', using the "'Conn1D_2D"' attribute.

To complete the pipe network, 1D/2D linkage is needed at the outlet of the pipe network. The '<u>[[QGIS_SWMM_BC_Create_Channel_Endpoint_1D/2D_Connections |BC - Create channel endpoint 1D/2D connections]]</u>' tool will be used to automate this process.

<li>In the QGIS Layers Panel, select (left click) '''Links--Conduits''' and toggle on editing.

<li>In the Processing Toolbox, go to '''TUFLOW >> SWMM''' and select '<u>[[QGIS_SWMM_BC_Create_Channel_Endpoint_1D/2D_Connections |BC - Create channel endpoint 1D/2D connections]]</u>'. This opens the dialog shown below.

::<li>Navigate to the '''TUFLOW\model\swmmgis''' folder and select '''sw02_001TS02_001.gpkg'''. Click 'Save'.

::<li>A dialog will open. In the Layerlayer Namename box, write '''2d_bc_SWMM_Pipe_Network_Connections_001_L'''.

<li>The '''2d_bc_SWMM_Pipe_Network_Connections_001_L''' appears in the QGIS Layers Panel.

{{Video|name=Animation_TS2_SWMM_Inputs_10aAnimation_TS2_SWMM_Inputs_09e.mp4|width=12351236}}

<li>Go to TUFLOW >> SWMM in the processing tool list and select '<u>[[QGIS_SWMM_Junctions_Set_Attributes |Junctions - Set attributes ]]</u>' processing tool. This opens the dialog shown below.

:::*Nodes receiving subcatchment flows option (if connected to 2D): without'Based Inletson (Ysur):options selected 0below'.

:*Nodes connected to 2D without Inlets (Apond): 50

:*Nodes withoutconnected to 2D Connectionwith (Area of ponding)Inlets: 0

<li>View the attributes associated within '''Nodes--Junctions''' to verify the data processing has been completed correctly. <br>

{{Video|name=Animation_TS2_SWMM_Inputs_11aAnimation_TS2_SWMM_Inputs_10d.mp4|width=12351236}}

*'''sw01_001.inp''' was already created in TUFLOW SWMM Tutorial Module 1. It contained details defining the three culverts under the roads in the model. It also contained the associated 1D SWMM / 2D TUFLOW connection Layerlayer objects and the '''Project--Options''' necessary to execute the SWMM simulation. '''sw01_001.inp''' has been included in the base model we are using for Module 2. No changes will be made to it.

{{Video|name=Animation_TS2_SWMM_Inputs_12aAnimation_TS2_SWMM_Inputs_11e.mp4|width=12351236}}

We will be using TUFLOW's 2D direct rainfall (also known as rain on grid) functionality for the catchment inflow boundary condition approach to demonstrate flows into the pipe network inlets. There areis a wide range of direct rainfall options built into TUFLOW, including:

<li>Copy '''materials_TS02_002materials_TS02_001.csv''' from the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder to the '''TUFLOW_SWMM_Module_02\TUFLOW\model''' folder.

We will update TUFLOW's 2D elevation and landuse to represent changes associated with the urban development. The updates will be consolidated within '''TS02_001.gpkg'''.

<li>Within the QGIS Browser Panel, navigatethere is a dropdown directory, 'Project Home'. This directory is a shortcut to the location where the QGIS workspace is saved. In this case, it is a shortcut to the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' folder.

<li>DragIn the following layers from the'Project '''Urban_Development.gpkg''Home' anddirectory, dropnavigate them into the '''TS02_001.gpkg''' contained withinto the '''TUFLOW_SWMM_Module_02\TUFLOW\model\gisTutorial_Data''' folder:.

{{Video|name=Animation_TS2_TUFLOW_Geometry_01aAnimation_TS2_TUFLOW_Geometry_01f.mp4|width=12351236}}

<li> Open '''TS01_5m_001.tcf''' fromin a Text Editor (Notepad++ is used here). Save the file as '''TS02_5m_001.tcf''' in the '''TUFLOW_SWMM_Module_02\TUFLOW\runs''''' folder in a Text Editor (Notepad++ is recommended).

:* Open '''M02_001TS01_001.tgctbc,''' and save the file as '''TS02_001.tgctbc''' in the '''TUFLOW\model''' folder.

:* Open '''TS01_001.tbctscf,''' and save the file as '''TS02_001.tbctscf''' in the '''TUFLOW\model''' folder.

<li>Open '''TS02_001.tcf'''. and make the following reference updates:<br>

{{Video|name=Animation_TS2_Sim_Control_01d.mp4|width=1235}}

<li>Open '''TS02_001.tgc'''. If using Notepad++, right click the file reference in '''TS02_5m_001.tcf''' and select 'Open File'.

{{Video|name=Animation_TS2_Sim_Control_02b.mp4|width=1235}}

<li>Open '''TS02_001.tscf'''. If using Notepad++, right click the file reference in '''TS02_5m_001.tcf''' and select 'Open File'.

<li>Add the following command lines after '<font color="blue"><tt>Read SWMM </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\sw01_001.inp</tt></font>': <br>

{{Video|name=Animation_TS2_Sim_Control_04b.mp4|width=1235}}

<li>Save a copy of '''_run_TS01_HPC.bat''' as '''_run_TS02_HPC.bat''' in the '''''TUFLOW_SWMM_Module_02\TUFLOW\runs''''' folder.

<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-ADAF\TUFLOW_iSP_w64.exe"</tt></font><br>

<li>Double clickSave the batch file and double click it in Windows File Explorer to run the simulation.

Complete the steps outlinesoutlined in the following linklinks to review check files and simulation results from the TUFLOW SWMM model simulation:

<u>[[TUFLOW_SWMM_Tutorial_M02_Check_QGIS | TUFLOW SWMM Tutorial 02 Check Files]]</u> <br>

<u>[[TUFLOW_SWMM_Tutorial_M02_Results_QGIS | TUFLOW SWMM Tutorial 02 Results]]</u> <br>

:* 1D EPA SWMM pipe network features and 2D direct rainfall (rain on grid) hydrology have been added to the tutorial model.

|uplink=[[TUFLOW_SWMM_Tutorial_Introduction#Tutorial_Modules| Back to TUFLOW SWMM Tutorial Introduction Main Page]]