TUFLOW SWMM Tutorial M03

Introduction

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, TUFLOW HPC model. TUFLOW SWMM Tutorial Module 3 builds from the model created in TUFLOW SWMM Tutorial Module 2. The completed TUFLOW SWMM Module 2 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 Module 1 and 2 before this tutorial.

Project Initialization

QGIS

QGIS Version 3.34 or newer, and QGIS TUFLOW Plugin 3.9.0.49 or newer are required to access the SWMM Processing Tools described in the following sections. For installation, see Installation of TUFLOW Plugin.
Define the Coordinate Reference System (CRS), also called ‘Projection’, for the QGIS workspace:

1. Open QGIS.
2. Go to Project > Properties…
3. In the CRS tab, type ‘WGS 84 / UTM Zone 60S’.
4. Select the matching projection in the 'Predefined Coordinate Reference Systems' section.
5. Click ‘Apply’ and ‘OK’.
6. Ensure that the projection is set correctly by viewing the bottom right hand corner of the workspace. It should read ‘EPSG:32760’.

TUFLOW Plugin

Next we need to configure the QGIS TUFLOW Plugin settings to link with the project folder where we will build our model:

1. Go to Plugins > TUFLOW > Editing > Configure / Create TUFLOW Project.
2. Change the folder which contains TUFLOW to the TUFLOW_SWMM_Module_03 folder.
3. Set the GIS Format to GPKG.
4. Click 'OK' and save the workspace by selecting Project > Save As.
   
   <<image>>
   

TUFLOW Model

Load and Style TUFLOW Model Files

Load in the project GIS layers:

1. Click on the ‘Load TUFLOW Layers from TCF’ symbol from the TUFLOW Plugin toolbar.
   
   
   
2. In File Explorer, navigate to the TUFLOW_SWMM_Module_03\TUFLOW\runs folder and select TS02_5m_001.tcf.
3. In the Load Layers window, select:
   • Ordering Options: Alphabetical
   • Grouping Options: Group by control file
   • Raster Load Options: Load Normally
4. Click ‘Open’ and ‘OK’.

Style the TUFLOW layers. Suggested styling steps were provided in TUFLOW SWMM Tutorial M01. They have not been duplicated here.

Increment TUFLOW GeoPackage File

Save a copy of TS02_001.gpkg with a new name (TS03_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.

1. Left click 2d_bc_M01_001_L in the QGIS Layers panel.
2. Select the TUFLOW Plugin Increment Selected Layer tool.
3. Set the new Output Database name to TS03_001.gpkg.
4. 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.
5. Select Remove Source Layer from Workspace.
6. Select Increment Layer and Preserve Database.
7. Select OK.

<<image>>

Save QGIS Project Workspace

Save the QGIS Workspace:

1. Go to Project > Save As.
2. Navigate to the TUFLOW_SWMM_Module_03 folder and type SWMM_M03 as the filename with the extension .qgz.

SWMM Inputs

Create SWMM GeoPackage Spatial Database

We will create a new SWMM GeoPackage database for our pipe network feature entries:

1. Go to Processing > Toolbox from the top dropdown menu options to open the Processing Toolbox Panel.
2. Go to TUFLOW > SWMM in the processing tool list and select 'GeoPackage - Create'. 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:
     • Hydrology--Raingages, Hydrology--Subcatchments
   • 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 sw03_001.gpkg.

   Note: In Module 1 we also included Project--Options in the GeoPackage file. Project--Options is not required in this GeoPackage Database as this Tutorial model will use multiple SWMM INP files:

   • The INP file created during Module 1 (road culverts)
   • The INP file careted for Module 2 (underground pipe network inputs).
   • This Module's INP (SWMM urban hydrology)
   When TUFLOW processes SWMM inputs, it combines the multiple INP files into one before simulation. As such, the simulation control details used the Module 1 Project--Options' input will be used in this tutorial. Options relevant to this tutorial that was already defined in the Module 1 Options Layer were flow_units:set to metric, infiltration method: set to Green Ampt,wetstep hydrology timestep: set to 1 minute and dry stephydrology timestep: set to 1 minute.
   
3. Click 'Run'.
4. Once to tool has finished, click ‘Close’.
5. In File Explorer, navigate to the TUFLOW\model\swmm folder and drag and drop sw03_001.gpkg into QGIS.
6. When prompted by QGIS, under 'Options', tick on 'Add layers to group', then select 'Add Layers' to open all vectors within sw03_001.gpkg. By default, all items in the available list should have been selected.
7. In the QGIS Layers panel, 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>>