Tuflow

TUFLOW SWMM Tutorial M02: Difference between revisions

Browse history interactively
← Older edit
Content deleted Content added
VisualWikitext
 
(115 intermediate revisions by 4 users not shown)
Line 1:
= Introduction =
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>
 
= Project Initialization =
==QGIS==
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>
Define the Coordinate Reference System (CRS), also called ‘Projection’, for the QGIS workspace:
<ol>
Line 16:
<br>
{{Video|name=Animation_TS1_Initialization_01a.mp4|width=1235}}<br>
 
==TUFLOW Plugin==
 
 
==TUFLOW Model==
Line 28 ⟶ 25:
[[File: Tuflow_plugin_load_tcf_layers.png]]<br>
<br>
<li>In File Explorer, navigateNavigate to the '''TUFLOW_SWMM_Module_02\TUFLOW\runs''' folder and select '''TS01_5m_001.tcf'''.
<li>In the Load Layers window, select:
* Ordering Options: Alphabetical
Line 36 ⟶ 33:
</ol>
<br>
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>
<br>
=== Increment Model GeoPackage File ===
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.
 
===TUFLOW Plugin===
Next we need to configure the QGIS TUFLOW Plugin settings to link with the project folder where we will build our model:<br>
<ol>
<li>Open the 'Configure TUFLOW Project' tool by selecting Plugins > TUFLOW > Editing > Configure / Create TUFLOW Project.
<li> Left click '''2d_bc_M01_001_L''' in the QGIS Layers panel.
<li>Set the CRS (Coordinate Reference System) by selecting one of the vector layers associated with the opened model using the drop menu list. For example, ''2d_bc_M01_001_L''.
<li> Select the TUFLOW Plugin '''Increment Selected Layer''' tool.
<li>To set the location of the TUFLOW folder, click 'Browse...' and navigate to the '''TUFLOW_SWMM_Module_02''' folder. Click 'Select Folder'.
<li>
<li>To set the location of the TUFLOW single precision executable file, click 'Browse...' and navigate to the '''exe\2023-03-AF''' folder. Select '''TUFLOW_iSP_w64.exe''' and click 'Open'.
 
<li>Select 'GPKG' as the GIS Format.
Set the new Output Database name to '''TS02_001.gpkg'''.
<li>Select 'TUFLOW Classic / HPC' as the TUFLOW Engine.
<li>Delete the pre-filled "Incremented Layer" entry. We do not wish to modify the version number associated with the 2d_bc file. This current exercise will not change the version number of any of the GIS layer inputs, it is simply establishing a copy of the existing Geopackage where future edits will be saved to.
<li>Tick on 'Save Default Settings Globally'.
<li>Select '''Remove Source Layer from Workspace'''.
<li>Click 'OK'.<br>
<li>Select '''Increment Layer and Preserve Database'''.
<br>
<li>Select '''OK'''.
[[File: TS2_Configure_Project_01a.png]]<br>
</ol>
<br>
[[File:TS01_Increment_GPKG_002.PNG | 800px]]<br><br>
 
=== Increment TUFLOW GeoPackage File ===
We 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.
 
<ol>
<li>In the QGIS Layers Panel, select (left click) '''2d_bc_M01_001_L'''.
<li>Click on the 'Increment Selected Layer' symbol from the TUFLOW Plugin toolbar. This opens the dialog shown below.
<br>
[[File:tuflow_plugin_increment_layer.png]]<br>
<br>
:*Source Layer: Automatically set to the selected layer, '''2d_bc_M01_001_L'''.
:*Output Database: Click 'Browse...'. This will automatically open to the '''TUFLOW\model\gis''' folder. Set the new output database name to '''TS02_001.gpkg''' and click 'Save'.
:*Output Layer Name: This will automatically increment to '''2d_bc_M01_00''2''_L'''. Change the name back to '''2d_bc_M01_00''1''_L'''.
:*Delete the pre-filled 'Incremented Layer' entry in the table. We do not wish to modify the version number associated with the 2d_bc file. This current exercise will not change the version number of any of the GIS layer inputs, it is simply establishing a copy of the existing GeoPackage where future edits will be saved to.
:*Select 'Remove Source Layer from Workspace'.
:*Select 'Increment Layer and Preserve Database'.
<li>Click 'OK'.
<li>The GeoPackage database, '''TS02_001.gpkg''' will now be in the '''TUFLOW_SWMM_Module_02\TUFLOW\model\gis''' folder.
<br><br>
{{Video|name=Animation_TS2_Initialization_02c.mp4|width=1236}}
<br>
</ol>
 
===Save QGIS Project Workspace===
Save the QGIS Workspace:
<ol>
<li>Go to Project > Save As.
Line 63 ⟶ 81:
<br>
 
= SWMMGIS Inputs =
==Create SWMM GeoPackage Spatial Database==
InWe QGIS,will create a new SWMM GeoPackage Databasedatabase for the newour pipe network featuresfeature entries:
<ol>
<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 ‘CRS for GeoPackage’: Click the drop down menu and select ‘Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
:*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.'''
:**'''Inlets--Inlets.'''
:*To define the ‘GPKG filename to create’: Click the …, select ‘Save to File’. Navigate to the '''TUFLOW\model\swmm''' folder and save the GeoPackage Database as '''sw02_001.gpkg'''.
::'''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>Click 'Run'.
<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.
<li>In the QGIS Layers panelPanel, move '''sw02_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.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_01c.mp4|width=1235}}
</ol>
<br>
{{Video|name=Animation_TS2_SWMM_Inputs_01e.mp4|width=1236}}
 
<br>
 
== GIS Data Entry ==
 
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):
:*'''Pipes''': defines the underground pipe network location, type and geometry.
:*'''Junctions''': defines the pipe network inlets.
Line 95 ⟶ 113:
 
<br>
To populate the GeoPackage database created in the previous section:
<ol>
<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). Click 'Add Layers'.
<li>In the QGIS Layers panelPanel, right click on the '''Pipes''' layer and select 'Zoom to Layer(s)'.
<li>Use the 'Select Features' tool to highlight all items included in '''Pipes'''.
<li>Select 'Edit' from the top QGIS tab and 'Copy Features' from the drop down menu.
<li>SelectIn the QGIS Layers Panel, select (left click) the '''Links--Conduits''' layer in the Layers panel by left clicking on it once.
<li>Make the '''Links--Conduits''' layer editable by clicking the 'Toggle Editing' symbol [[File:toggle_editing_icon.png|27x27px]].
<li>Select 'Edit' from the top QGIS tab and click 'Paste Features' from the drop down menu.
<li>Toggle the editing off to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_02bAnimation_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>Remove '''Urban_Development.gpkg'''.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_03aAnimation_TS2_SWMM_Inputs_03c.mp4|width=12351236}}<br>
<li>Inspect the attribute information within the respective layers to familiarize yourself with the data.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_04aAnimation_TS2_SWMM_Inputs_04c.mp4|width=12351236}}<br>
</ol>
 
Line 124 ⟶ 142:
The following updates are being made to objects and layers within '''sw02_001.gpkg'''.
===Update SWMM Inlet Usage Layer Details===
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>
 
<ol>
Line 131 ⟶ 149:
</ol>
 
When you progress from this tutorial to project modeling, 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 layerLayer 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--Inlets'''. 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--Inlets''' Layerlayer.
<ol>
<li>In the QGIS Layers panelPanel, select (left click) '''Inlets--Inlets''' and toggle on editing.
<li>Right click '''Inlets--Inlets''' and select 'Open Attribute Table'.
<li>Click 'Add Feature'. Enter the following attributes (leave all other fields as ''NULL''):
:*Name: Combo1
:*Type: COMBINATION
:*Grate_Length: 10.56
:*Grate_Width: 0.53
:*Grate_Type: P_BAR-50
:*Curb_Length: 10.59
:*Curb_Height: 0.215
:*Curb_Throat: VERTICAL
For a summary of the attributes associated with the '''Inlets--Inlets''' Layerlayer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Inlets TUFLOW 2023-03-AD Release Notes (Table A.16)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9ASSWMM5_Reference_Manual_Volume2_Hydraulics_Addendum-20220210mas2wr.pdf SWMM SWMM5 Reference Manual - Volume 2 (Hydraulics Addendum) ]</u>.
 
 
<li>Turn off editing and save the information.
<li>Turn off editing to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_05aAnimation_TS2_SWMM_Inputs_05c.mp4|width=12351236}}
<br>
</ol>
Line 160 ⟶ 179:
 
<ol>
<li>In the QGIS Layers panelPanel, select (left click) '''Links--Streets''' and toggle on editing.
<li>Right click '''Links--Streets''' and select 'Open Attribute Table'.
<li>Click 'Add Feature'. Enter the following attributes:
:*Name: Xsec1
:*Tcrown: 107
:*Hcurb: 0.2
:*Sx: 4
Line 172 ⟶ 191:
:*Sides: 1
:*Tback: 5
:*Sback: 42
:*nBack: 0.016
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>.
 
<li>Turn off editing to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_06aAnimation_TS2_SWMM_Inputs_06c.mp4|width=12351236}}
<br>
</ol>
Line 184 ⟶ 204:
====Node Details====
 
The 'From Node' and 'To Node' attribute information in '''Links---Conduits''' is necessary to build the 1D SWMM network. It defines the link/node 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 node fields]]</u>' tool from the Processing Toolbox.
<ol>
<li>In the QGIS Layers panelPanel, select (left click) '''Links--Conduits''' and toggle on editing.
<li>In the Processing Toolbox, select 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 a new layer.
<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>Select 'Modify All Features'.
<li>Once the tool has finished, click 'Close'.
<li>Turn off editing to save the edits.
<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. For a broader understanding of the other attributes associated with the Links---Conduits Layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Conduits TUFLOW 2023-03-AD Release Notes (Table A.19)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>. <br>
For a broader understanding of the other attributes associated with the '''Links--Conduits''' layer, refer to <u>[https://docs.tuflow.com/classic-hpc/release/2023-03-AD/SWMM-Input-Detailed-1.html#tab:tab-SWMM-Input-Conduits TUFLOW 2023-03-AD Release Notes (Table A.19)]</u> and the <u>[https://downloads.tuflow.com/SWMM/SWMM5_Reference_Manual_Volume2_Hydaulics_P100S9AS.pdf SWMM Reference Manual - Volume 2 (Hydraulics)]</u>. <br>
'''Tip:''' If you wish to only update selected objects during a future modeling project, instead of the entire '''Link--Conduits''' dataset, select the target objects first using the Feature by Area tool. The 'Conduits - Assign node fields' tool will provide an option to 'Modify Selected Features', instead of 'Modify All Features.'
'''Tip:''' In a future modeling project, if you wish to only update selected objects, rather than the entire '''Links--Conduits''' dataset, select the target objects first using the '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.'
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_07aAnimation_TS2_SWMM_Inputs_07c.mp4|width=12351236}}
<br>
</ol>
Line 202 ⟶ 223:
====Update Losses====
 
Update the loss attributes in the '''Links--Conduits''' layer. These values will be entered automatically using the '<u>[[QGIS_SWMM_Conduits_Assign_Losses |Conduits - Assign losses]]</u>' tool from the Processing Toolbox.
<ol>
<li>In the QGIS Layers panelPanel, select (left click) '''Links--Conduits''' and toggle on editing.
<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
:*Culvert or pipe network outlet - Exit loss: 1.0
:*Entrance loss for channels not furthest upstream: 0.2
:*Pipe Network (manholes and pit inlets):
:*Exit loss furthest downstream channels: 1.0
:::*Entrance loss: 0.2
:*Exit loss for channels not furthest downstream: 0.4
:::*Exit loss: 0.4
<li>Select 'Modify All Features'.
<li>After the tool processing has finished, click 'Close'.
Line 217 ⟶ 239:
<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.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_08aAnimation_TS2_SWMM_Inputs_08d.mp4|width=12351236}}
<br>
</ol>
Line 230 ⟶ 252:
</ol>
<br>
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.
<ol>
<li>In the QGIS Layers panelPanel, select (left click) '''Links--Conduits''' and toggle on editing.
<li>Use the 'Select Features' tool to select the most downstream object in '''Links--Conduits'''.
<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.
:*Input Conduits Layer: '''Links--Conduits'''
:*Tick on 'Selected features only'
:*Create connections at: 'Downstream end'
:*Offset Distance: 2
:*Length of BC lines: 10
Line 243 ⟶ 266:
<ol>
::<li>Click the ... and select 'Save to GeoPackage'.
::<li>Navigate to the '''TUFLOW\model\swmmgis''' folder and select '''sw02_001TS02_001.gpkg'''. Click 'Save'.
::<li>A dialog will open. In the Layerlayer name box, write '''2d_bc_SWMM_Pipe_Network_Connections_001_L'''.
::<li>Click 'OK'.
</ol>
<li>Click 'Run'.
<li>Once the tool is finished, click 'Close'.
<li>The '''2d_bc_SWMM_Pipe_Network_Connections_001_L''' appears in the QGIS Layers panelPanel.
<li>Click the 'Apply TUFLOW Styles to Current Layer' symbol from the TUFLOW Plugin toolbar to style the '''2d_bc_SWMM_Pipe_Network_Connections_001_L''' layer.
<li>Turn off editing to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_09bAnimation_TS2_SWMM_Inputs_09e.mp4|width=12351236}}
<br>
<li>In the QGIS Layers panel, select (left click) '''2d_bc_SWMM_Pipe_Network_Connections_001_L''' and toggle on editing.
<li>The 'BC - Create channel endpoint 1D/2D connections' tool has created 1D connections at the upstream and downstream end of the selected pipe. We can delete the connections from the upstream end of the pipe (two CN and one HX lines), as all pipe network inlets are defined in '''swmm_iu_TS02_001'''
<li>Use the 'Select Features' tool to select the connections on the upstream end of the pipe.
<li>In the QGIS Layers panel, right click '''2d_bc_SWMM_Pipe_Network_Connections_001_L''' and select 'Open Attribute Table'.
<li>The selected connections will be highlighted in blue. Click 'Delete Selected Features'.
<li>Turn off editing to save the edits.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_10a.mp4|width=1235}}
<br>
</ol>
Line 268 ⟶ 282:
 
<ol>
<li>In the QGIS Layers panelPanel, select (left click) '''Nodes--Junctions''' and toggle on editing.
<li>In the Processing Toolbox, select the 'Edit Features In-Place' tool. This allows the editing of an existing layer, instead of the creation of a new layer.
<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.
:*Input Inlet Usage Layers: '''swmm_iu_TS02_001'''
:*Input BC Connection Layers: '''2d_bc_SWMM_Pipe_Network_Connections_001_L'''
:*General Options:
:*Nodes connected to 2D with Inlets (Ysur): 0
:::*Maximum Depth Option (Ymax): 'Set to 0.0'.
:*Nodes connected to 2D with Inlets (Area of ponding): 5
:::*Nodes receiving subcatchment flows option (if connected to 2D): without'Based Inletson (Ysur):options selected 0below'.
:*Nodes connected to 2D without Inlets (Apond): 50
:::*None - leave defaults
:*Nodes without 2D Connection (Surcharge Depth): 50
:*Nodes withoutconnected to 2D Connectionwith (Area of ponding)Inlets: 0
:::*Maximum depth (Ymax) option: 'Use global option'
:::*Ysur: 0 (ignored because ponding > 0.0)
:::*Area of Ponding (Apond): 5
:*Nodes without 2D Connection:
:::*Surcharge Depth: 50
:::*Area of Ponding (Apond): 0.0
 
 
<li>Select 'Modify All Features'.
<li>Once the tool has finished, click 'Close'.
<li>Turn off editing to save the edits.
<li>View the attributes associated within '''Nodes--Junctions''' to verify the data processing has been completed correctly. For a summary of the attributes associated with the Inlets--Inlets Layer, refer to <ubr>[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>.
For a summary of the attributes associated with the '''Nodes--Junctions''' 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>.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_11aAnimation_TS2_SWMM_Inputs_10d.mp4|width=12351236}}
<br>
</ol>
Line 299 ⟶ 322:
 
<ol>
<li>Right click on the '''Links--Conduits''' layer in the '''sw02_001''' group (or any other SWMM layer in the same GeoPackage) and select 'TUFLOW' > 'SWMM - Export inp file'.
<li>In the Processing Toolbox, go to TUFLOW > SWMM and select 'GeoPackage - Write to SWMM inp'. This opens the dialog shown below.
<li>This will open the '<u>[[QGIS_SWMM_GeoPackage_Write_to_SWMM_inp |GeoPackage - Write to SWMM inp]]</u>' processing tool, prepopulated with the filename of the layer's GeoPackage. <br>
:*GeoPackage Input File: Navigate to the '''TUFLOW\model\swmm''' folder and select '''sw02_001.gpkg'''.<br>
'''Note:''' This tool can also be activated from the Processing Toolbox.
<li>By default, this tool will save the SWMM inp file in the same folder location and with the same name as the GeoPackage input file. In this case, it will save '''sw02_001.inp''' to the '''TUFLOW\model\swmm''' folder.
<li>Click 'Run'.
<li>Once the tool is finished, click 'Close'.
<li>This tool will save the SWMM inp file in the same folder location and with the same name as the GeoPackage input file. In this case, it will save '''sw02_001.inp''' to the '''TUFLOW\model\swmm''' folder.
<br><br>
{{Video|name=Animation_TS2_SWMM_Inputs_12bAnimation_TS2_SWMM_Inputs_11e.mp4|width=12351236}}
<br>
</ol>
Line 330 ⟶ 354:
 
== TUFLOW Geometry Update ==
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'''.
 
Copy the following TUFLOW geometry inputs to GeoPackage '''TS02_001.gpkg''':
First, we will establish the TUFLOW GeoPackage database for these updates.
<ol>
<li>Right click anywhere in the QGIS Toolbar Panel and tick on 'Browser Panel' from the 'Panels' options.
<li>Navigate to the '''TUFLOW\model\gis''' folder. Save a copy of '''M02_001.gpkg''' as '''TS02_001.gpkg'''.
<li>Within the QGIS Browser Panel, 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.
</ol>
 
We will now copy new TUFLOW geometry inputs to the new GeoPackage database:
<ol>
<li>Right click anywhere in the QGIS toolbar panel and tick on 'Browser Panel' from the 'Panels' options.
<li>Within the QGIS Browser panel, 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>In the 'Project Home' directory, navigate to the '''TUFLOW_SWMM_Module_02\Tutorial_Data''' 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:
:*'''2d_mat_TS02_Dev_Buildings_001_R'''
:*'''2d_mat_TS02_Dev_Lots_001_R'''
Line 348 ⟶ 367:
:*'''2d_ztin_TS02_Dev_001_P'''
:*'''2d_ztin_TS02_Dev_001_R'''
Hold Ctrl in on the keyboard to select multiple layers at the same time.
</ol>
'''Note:''' The focus of this tutorial is not to demonstrate 2D geometry updates. If you are interested in learning about the above '''2d_ztin''' and '''2d_mat''' changes, please refer to <u>[[Tutorial_M02 |TUFLOW Tutorial Module 2]]</u>.
<br><br>
<ol>
{{Video|name=Animation_TS2_TUFLOW_Geometry_01bAnimation_TS2_TUFLOW_Geometry_01f.mp4|width=12351236}}
<br>
</ol>
Line 360 ⟶ 378:
To avoid the potential risk of overwriting existing control files accidentally, we will start by saving new control files where we will be making subsequent syntax updates during the following steps.
<ol>
<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>Using the 'Open File' function in Notepad++:
:*Open '''M02_001.tgc,''' and save the file as '''TS02_001.tgc''' in the '''TUFLOW\model''' folder.
Line 370 ⟶ 388:
===TUFLOW Control File (TCF)===
<ol>
<li>Open '''TS02_001.tcf'''. and make the following reference updates:<br>
<li>Make the following reference updates:<br>
<font color="blue"><tt>Spatial Database </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\gis\TS02_001.gpkg</tt></font> <font color="green"><tt> ! Specify the location of the GeoPackage Spatial Database</tt></font><br>
<font color="blue"><tt>Geometry Control File</tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>..\model\TS02_001.tgc</tt></font> <font color="green"><tt> ! Reference the TUFLOW Geometry Control File</tt></font><br>
Line 382 ⟶ 399:
<li> Save the TCF.
<br><br>
{{Video|name=Animation_TS2_Sim_Control_01bAnimation_TS2_Sim_Control_01d.mp4|width=1235}}
<br>
</ol>
Line 407 ⟶ 424:
<li>Add the following additional command lines:<br>
<font color="blue"><tt>Global Rainfall BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>RF_FC04</tt></font><font color="green"><tt> ! Reads in global rainfall</tt></font><br>
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\sw02_001.gpkg >></tt></font> <font color="black"><tt>2d_bc_SWMM_Pipe_Network_Connections_001_L</tt></font> <font color="green"><tt> ! Links the 1D Pipe Network Outlets to the 2D domain</tt></font> <br>
<li>Save the TBC.
<br><br>
{{Video|name=Animation_TS2_Sim_Control_03bAnimation_TS2_Sim_Control_03d.mp4|width=1235}}
<br>
</ol>
Line 430 ⟶ 447:
<li>Save a copy of '''_run_TS01_HPC.bat''' as '''_run_TS02_HPC.bat''' in the '''TUFLOW_SWMM_Module_02\TUFLOW\runs''' folder.
<li>Update the batch file to reference the '''TS02_5m_001.tcf''' :<br>
<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>
<font color="blue"><tt>'''set'''</tt></font> <font color="black"><tt>run</tt></font><font color="red"><tt>=</tt></font><font color="black"><tt>start "TUFLOW" /wait</tt></font> <font color="orange"><tt> %exe%</tt></font> <font color="black"><tt> -b</tt></font> <br>
<font color="orange"><tt>%run% </tt></font> <font color="black"><tt>TS02_5m_001.tcf </tt></font>
 
<li>Double clickSave the batch file and double click it in Windows File Explorer to run the simulation.
<li>Did your TUFLOW SWMM model fail to run successfully? If so, here is a link to a troubleshooting guide: <u>[[TUFLOW_SWMM_Troubleshooting | TUFLOW SWMM Troubleshooting]]</u>.<br>
<br>
If the model simulation doesn't run, here is a link to some common <u>[[Tutorial_Troubleshooting_QGIS | Trouble Shooting]]</u> advice.
<br><br>
{{Video|name=Animation_TS2_Run_Sim_01bAnimation_TS2_Run_Sim_01c.mp4|width=12351236}}<br>
</ol>
<br>
 
= Check Files and Results Output=
Line 449 ⟶ 464:
 
= Conclusion =
:* 1D EPA SWMM pipe network features and 2D direct rainfall (rain on grid) hydrology have been added to the tutorial model.
* Check files were used to review the 1D SWMM pipe network model features.
* Simulation results in the 1D SWMM pipe network were viewed in time series and long section plot format.
* For further training opportunities see <u>[https://tuflow.com/training/training-course-catalogue/ TUFLOW Training Catalogue]</u> and/or contact <u>[mailto:training@tuflow.com training@tuflow.com]</u>.
<br>
 
=Other TUFLOW SWMM Tutorials=
*<u>[[TUFLOW_SWMM_Tutorial_M01 | TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts
*<u>[[TUFLOW_SWMM_Tutorial_M02 | TUFLOW SWMM Module 2]]</u> - 1D SWMM Pipe Network / 2D TUFLOW Direct Rainfall Hydrology
*<u>[[TUFLOW_SWMM_Tutorial_M03 | TUFLOW SWMM Module 3]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology
*<u>[[TUFLOW_SWMM_Tutorial_M04 | TUFLOW SWMM Module 4]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology: Executing multiple different event simulations from a single model control file.
*<u>[[XPSWMM_to_TUFLOW-SWMM | XPSWMM to TUFLOW SWMM]]</u> - How to convert an XPSWMM model to TUFLOW SWMM.
 
<br>
{{Tips Navigation
Retrieved from "https://wiki.tuflow.com/TUFLOW_SWMM_Tutorial_M02"