TUFLOW SWMM Tutorial M03: Difference between revisions

This tutorial, Module 3 of the TUFLOW -SWMM tutorial dataset, demonstrates how to add SWMM urban hydrology to a 1D / 2D SWMM stormwater pipe network / 2D TUFLOW HPC catchment model. TUFLOW -SWMM Tutorial Module 3 builds from the model created in <u>[[TUFLOW_SWMM_Tutorial_M02|TUFLOW SWMM Tutorial Module 2]]</u>. The completed TUFLOW -SWMM Module 2 model is provided in the '''''TUFLOW_SWMM_Module_03\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 completing TUFLOW -SWMM Modules 1 and 2 prior to starting this tutorial. <br>

QGIS Version 3.34 or newer, and QGIS TUFLOW Plugin 3.9.0.11011 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 the QGIS Layers panelPanel, select (left click) '''2d_bc_M01_001_L'''.

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

SWMM pipe network junction attributes need to be updated when converting a TUFLOW 2D direct rainfall / SWMM 1D model <u>([[TUFLOW_SWMM_Tutorial_M02|TUFLOW SWMM Tutorial Module 2]]</u>). into a format that uses SWMM hydrology instead of direct rainfall. Similar to above (incrementing the TUFLOW GeoPackage file), we will increment the SWMM pipe network database name so we do not alter the inputs necessary for '''TS02_5m_001.tcf''' to function without issue.

<li> In the QGIS Layers panelPanel, open the '''TS02_001.tscf''' group. In the '''sw02_001.inp''' group, right click '''Links--Conduits'''.

:*Output File: Click the '...'. andThis setwill automatically open to the '''TUFLOW\model\swmm''' folder. Set the newoutput database name to '''sw03_001.gpkg'''. and click 'Save'.

<li> The tool will automatically load '''sw03_001.gpkg''' into the QGIS workspace and remove '''sw02_001.gpkginp''' from the QGIS workspace.

<li> In the QGIS Layers panelPanel, move '''sw03_001.gpkg''' to the top of the list. This will ensure the data within this database file is displayed above all other layers in the project.

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

:*CRS for GeoPackage layers: Click the drop down menu and select 'Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S'.

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

The above steps have added the new sections to the SWMM GeoPackage database, '''sw03_001.gpkg'''. However, the new sections are not currently displayed in the QGIS Layers panelPanel. We need to close the database and reopen it to view the changes.

<li>In the QGIS Layers panelPanel, right click '''sw03_001''' and select 'Remove Group...'.

<li>In the QGIS Layers panelPanel, move '''sw03_001.gpkg''' to the top of the list. This will ensure the data within this database file is displayed above all other layers in the project when editswe are mademaking edits.

<li>In the QGIS Layers panelPanel, within the '''sw03_001''' group, move '''Hydrology--Subcatchments''' to the bottom. This will ensure that the other data within this database can be seen.

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

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

<li>In the QGIS Layers panelPanel, select (left click) the '''sw03_001 >> Hydrology--Subcatchments''' layer.

<li>Remove '''SWMM_SubcatchmentsUrban_Hydrology''' from the QGIS Layers Panel.

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

The text information within '''Hydrology--Raingages''' defines the pluviographs in the catchment. We will link to two different rain gages in this example. <br>

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

For a summary of the attributes associated with '''Hydrology--Raingages''', refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Raingages TUFLOW 2023-03-AD Release Notes (Table A.11)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume1_Hydrology_P100NYRA.pdf SWMM5 Reference Manual - Volume 1 (Hydrology)]</u>.<br>

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

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

<li>Choose 'Area' as the target field and type the calculation expression, '$area($geometry) / 10000'.

:* '$area($geometry) ': Extracts the area of each region (subcatchment) in '''Hydrology--Subcatchments'''.

:*Two rainfall gages are linked to the subcatchments. Downstream subcatchments are linked to rain gage 'RF_G1'. Upstream subcatchments are linked to rain gage 'RF_G2'.

:*Subcatchments 'SPit11A' and 'SPit11BSPit11A' are being routed to subcatchment 'SPit11C' before entering the SWMM pipe network. All other hydrology subcatchments route directly to a SWMM '''Node--Junctions'''.<br>

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

When TUFLOW processes SWMM inputs, it combines the multiple INP files into one single INP prior to simulation. For this model, the simulation control parameters defined in Module 1 ('''sw01_001''') '''> Project--Options''') will apply. The options relevant to this tutorial that have already been defined in the Module 1 input include:

:*'''FLOW_UNITSflow_units''': set to metric (CMS).

:*'''INFILTRATIONinfiltration''' method: set to GREEN-AMPTGreen Ampt.

<li>In the QGIS Layers panelPanel, open the '''TS02_001.tscf''' group and select (left click) '''Nodessw01_001 >> Project--JunctionsOptions''' and toggle on editing.

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

We will now create a new INP file for the pipe network and SWMM urban hydrology inputs. Toand do this, we need to convertupdate '''sw03_001sw01_001.gpkginp''' intoto areflect SWMMthe INPchanges file.made to the hydrology options above.

<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 tool, prepopulated openswith the dialogfilename shownof belowthe layer's GeoPackage. <br>

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

<li>The '''2d_sa_TS03_001_L2d_sa_TS03_001_R''' appears in the QGIS Layers panelPanel.<br>

<li>In the QGIS Layers panelPanel, select (left click) the '''TUFLOW_Subcatchments''' layer.

<li>In the QGIS Layers panelPanel, select (left click) the '''2d_sa_TS03_001_R''' layer.

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

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

<li>OpenEdit '''TS03_001TS03_5m_001.tcf''' andby makemaking the following reference updates:<br>

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

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

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

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

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

If<li>Did your theTUFLOW-SWMM model simulationfail doesn'tto run successfully? If so, here is a link to somea troubleshooting commonguide: <u>[[Tutorial_Troubleshooting_QGISTUFLOW_SWMM_Troubleshooting | TroubleTUFLOW ShootingSWMM Troubleshooting]]</u> advice.<br>

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