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. 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 Version 3.34 or newer, and QGIS TUFLOW Plugin 3.9.0.4911 or newer are required to access the SWMM Processing Tools described in the following sections. For installation, see <u>[https://wiki.tuflow.com/index.php?title=TUFLOW_QGIS_Plugin#Installation_of_Plugin Installation of TUFLOW Plugin]</u>.<br>

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

SaveWe will now save a copy of '''TS01_001.gpkg''' with a new name, '''TS02_001.gpkg'''. This project initialization step is recommended so prior model versions from a project are not broken as a result of changes being made to GIS inputs.

:*Output Layer Name: This waswill automatically incrementedincrement to, '''2d_bc_M01_002_L2d_bc_M01_00''2''_L'''. Change the valuename back to '''2d_bc_M01_001_L2d_bc_M01_00''1''_L'''.

<br><br>

{{Video|name=Animation_TS2_Initialization_02a.mp4Animation_TS2_Initialization_02c.mp4|width=12351236}}

= SWMMGIS Inputs =

<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, LinksInlets--StreetsInlets.'''

::'''Note:''' In Module 1 we also included '''Nodes--Storage''', '''Project--Title''', '''Project--Options''', and '''Project--Report''' in the GeoPackage file. '''Project--Options''' is not required this time as this Tutorialtutorial model will use two SWMM INP files. The file created during Module 1 (for the road culverts) and the INP is to be created from this GeoPackage (for the underground pipe network inputs). When TUFLOW processes SWMM inputs, it combines the multiple INP files into one before simulation. As such, the details from the Module 1 '''Project--Options''' input will be used in this tutorial. If '''Project--Options''' are included in multiple Geopackage/INP files, the entry that is referenced lowest in the TUFLOW SWMM Control file (TSCF) will be used. '''Nodes--Storage''' will not be used in this tutorial, as these are only needed to represent detention, or for nodes connected using HX boundaries.

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

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

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>In the QGIS Layers Panel, right click on the '''Pipes''' layer and select 'Zoom to Layer(s)'.

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

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

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

<li>Turn off editing andto save the informationedits.

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

For a summary of the attributes associated with the '''Links--Streets''' Layerlayer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Streets TUFLOW 2023-03-AD Release Notes (Table A.24)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>.

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

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

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

'''Tip:''' IfIn a future modeling project, if you wish to only update selected objects during a future modeling project, insteadrather ofthan the entire '''LinkLinks--Conduits''' dataset, select the target objects first using the Feature'Select Features by Area' tool. The '<u>[[QGIS_SWMM_Conduits_Assign_Node_Fields |Conduits - Assign node fields]]</u>' tool will provide an option to 'Modify Selected Features', instead of 'Modify All Features.'

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

<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

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

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

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

<li>In the QGIS Layers panelPanel, select (left click) '''Nodes--Junctions''' and toggle on editing.

<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 (Area of ponding): 50

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

For a summary of the attributes associated with the '''InletsNodes--InletsJunctions''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Junctions TUFLOW 2023-03-AD Release Notes (Table A.30)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>.

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

<li>InThis thewill Processingopen Toolbox, go to TUFLOW > SWMM and selectthe '<u>[[QGIS_SWMM_GeoPackage_Write_to_SWMM_inp |GeoPackage - Write to SWMM inp]]</u>.' Thisprocessing openstool, prepopulated with the dialogfilename shownof belowthe layer's GeoPackage. <br>

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

<li>Right click anywhere in the QGIS toolbarToolbar panelPanel and tick on 'Browser Panel' from the 'Panels' options.

<li>Within the QGIS Browser panelPanel, there 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''' folder.

<li>Drag the following layers (hold Ctrl to select multiple) from the '''Urban_Development.gpkg''' and drop them into the '''TS02_001.gpkg''' contained within the '''TUFLOW_SWMM_Module_02\TUFLOW\model\gis''' folder:

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

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

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

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

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

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

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

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

* Simulation results in the 1D SWMM pipe network were viewed in time series and longsectionlong section plot format.