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>

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

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

<li> In the QGIS Layers Panel, 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.

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

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

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

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

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

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

<li>In the QGIS Layers Panel, 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 Panel.<br>

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