Difference between revisions of "TUFLOW SWMM Tutorial M02"
Chris Huxley (talk | contribs) |
Chris Huxley (talk | contribs) |
||
Line 221: | Line 221: | ||
=== TUFLOW Boundary Control File (TBC) === | === TUFLOW Boundary Control File (TBC) === | ||
<ol> | <ol> | ||
− | <li>Open ''' | + | <li>Open '''TS02_001.tbc'''. If using Notepad++, right click the file reference in '''TS02_5m_001.tcf''' and select '''Open File'''. |
<li>Add the following additional command lines to '''TS02_001.tbc''': <br> | <li>Add the following additional command lines to '''TS02_001.tbc''': <br> | ||
<font color="blue"><tt>Spatial Database</tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\TS02_001.gpkg</tt></font><br> | <font color="blue"><tt>Spatial Database</tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>swmm\TS02_001.gpkg</tt></font><br> |
Revision as of 13:53, 6 December 2023
Introduction
In this module, stormwater inundation and underground pipe flows associated with an urban development are modelled. EPA SWMM is used as the solution scheme for the 1D pipe and culvert flow calculations, dynamically linked with the TUFLOW HPC 2D solution scheme.
TUFLOW SWMM Tutorial Module 2 builds from the model created in TUFLOW SWMM Tutorial Module 1. 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 Module 1 before this tutorial.
QGIS Project Initialization
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:
- Open QGIS.
- Go to Project > Properties…
- In the CRS tab, type ‘WGS 84 / UTM Zone 60S’.
- Select the matching projection in the 'Predefined Coordinate Reference Systems' section.
- Click ‘Apply’ and ‘OK’.
- Ensure that the projection is set correctly by viewing the bottom right hand corner of the workspace. It should read ‘EPSG:32760’.
Load in the project GIS layers:
- Click on the ‘Load TUFLOW Layers from TCF’ symbol from the TUFLOW Plugin toolbar.
- In File Explorer, navigate to the TUFLOW_SWMM_Module_01\TUFLOW\runs folder and select M02_5m_001.tcf.
- Click ‘Open’ and ‘OK’.
Style the TUFLOW layers as preferred. Common steps to do this are:
- Click on the ‘Apply TUFLOW Styles to Open Layers’ symbol from the TUFLOW Plugin toolbar.
- Change the symbology of the DEM:
- Right click on the DEM file in the Layers panel and select 'Properties'.
- From the Symbology tab, under 'Band Rendering' select the following options:
- Render type: Singleband pseudocolor
- Color ramp: Spectral
- Color ramp: Invert Color Ramp
- Mode: Equal Interval
- From the Transparency tab, set the Global Opacity to 75%.
- Click 'Apply' and 'OK'.
- Create a hillshade of the DEM:
- Right click on the DEM file in the Layers panel and select 'Duplicate Layer'.
- Right click on the DEM_copy and select 'Rename Layer'. Rename the layer to DEM_Hillshade.
- Right click on the DEM_Hillshade file and select 'Properties'.
- From the Symbology tab, under 'Band Rendering' select the following options:
- Render type: Hillshade
- Z Factor: 3
- From the Transparency tab, set the Global Opacity to 35%.
- Click 'Apply' and 'OK'.
SWMM Inputs and 1D/2D Linking
Create SWMM GeoPackage Spatial Database
Create a new folder in the TUFLOW_SWMM_Module_01\TUFLOW\model folder called swmm. This is the location where all SWMM inputs will be saved.
In QGIS, create the SWMM GeoPackage Database:
- Go to Processing > Toolbox from the top drop menu options to open the Processing Toolbox panel.
- 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: Title, Options, Nodes--Junctions, Nodes--Outfalls, Links--Conduits, Streets, Inlets and Report.
- 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 TS01_002.gpkg.
- Click ‘Run’.
- Once to tool has finished, click ‘Close’.
- In File Explorer, navigate to the TUFLOW\model\swmm folder and drag and drop TS01_002.gpkg into QGIS.
<< Add video >>
GIS Data Entry
A GeoPackage called Urban_Development.gpkg is provided in the TUFLOW_SWMM_Module_02\Tutorial_Data folder. It contains six layers:
- Pipes: defines the underground pipe network location, type and geometry.
- Junctions: defines the pipe network inlets.
- Outfalls: defines the pipe network outlet.
- 2d_ztin_TSWM_Dev_001_R: Topography update TIN region extent
- 2d_ztin_TSWM_Dev_001_L: Topography update TIN lines
- 2d_ztin_TSWM_Dev_001_P: Topography update TIN point elevations
To populate the GeoPackage created in the previous section:
- In Windows Explorer, navigate to the TUFLOW_SWMM_Module_02\Tutorial_Data folder. Drag and drop the Urban_Development.gpkg into QGIS. By default, all items in the GeoPackage will be selected. Click 'Add Layers'.
- In the QGIS Layers Panel, right click on the Pipes layer and select 'Zoom to Layer'.
- Use the 'Select Features' tool to highlight all items included in Pipes.
- Select 'Edit' from the top QGIS tab and 'Copy Features' from the drop down manu.
- Select the Links--Conduits layer in the Layers Panel by left clicking on it once.
- Make the Links--Conduits layer editable by clicking the 'Toggle Editing' symbol
.
- Select 'Edit' from the top QGIS tab and click 'Paste Features' from the drop down menu.
- Toggle the editing off to save the edits.
<< Add video >>
- Copy the objects from Junctions into Nodes--Junctions. Junctions are considered inlets, and should be defined at the upstream end of culverts.
- Copy the objects from Outfalls into Nodes--Outfalls. Outfalls are treated as outlets, and are required at the downstream end of culverts.
- Copy 2d_ztin_TSWM_Dev_001_R, 2d_ztin_TSWM_Dev_001_L and 2d_ztin_TSWM_Dev_001_P to XXXXXXX
- Close Urban_Development.gpkg
<video>>
- Inspect the attribute information within the respective layers to familiarize yourself with the data.
<< Add video >>
GIS Data Updates
The provided GIS data requires numerous updates, prior to our model simulation. We have built these updates into this tutorial to demonstrate some of the available TUFLOW SWMM model built processing tools.
The following updates are being made to Objects and Layers within TS01_002.gpkg
Update Conduit Details
Step 1 involves updating the From Node and To Node attribute information in Links--Conduits. This information 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 Conduits - Assign Node Fields tool from the Processing Toolbox.
- In the QGIS Layers Panel, select (left click) Links--Conduits and toggle on editing.
- 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.
- Go to TUFLOW > SWMM in the processing tool list and select 'Conduits - Assign Node Fields'. This opens the dialog shown below.
- Tick on the SWMM Node Layers: Nodes--Junctions and Nodes--Outfalls.
- Select 'Modify All Features'.
- Once the tool has finished, click 'Close'.
- 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.
Tip: If you wish to only update select objects during a future modelling 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.
<< Add video >>
Update Losses
Step 2, update the loss attributes in the Links--Conduits Layer. These values will be entered manually in this example using default values. Variation to the default values can be used in project models to reflect site specific information if desired.
- In the QGIS Layers Panel, select (left click) Links--Conduits and toggle on editing.
- Update using Processing Tool.
- Turn off editing to save the edits.
<< Add video >>
Create 1D/2D Connections
The following instructions introduce a new tool that automates the creation of 1D/2D connections. For 1D SWMM, HX lines are required from the upstream end of the culvert, and SX connections are used at the downstream end of the culvert.
- In the QGIS Layers Panel, select (left click) Links--Conduits.
- In the Processing Toolbox, go to TUFLOW > SWMM and select 'BC - Create channel endpoint 1D/2D connections'. This opens the dialog shown below.
- Input Conduits Layer: Links--Conduits
- Offset Distance: 2
- Length of BC lines: 10
- Output Layer:
- Click the ... and select 'Save to GeoPackage'.
- Navigate to the TUFLOW\model\swmm folder and select TS01_001.gpkg. Click Save.
- A dialog will open. In the Layer Name box, write 2d_bc_SWMM_Connections_001_L.
- Click 'OK'.
- Click 'Run'.
- Once the tool is finished, click 'Close'.
- The 2d_bc_SWMM_Connections_001_L appears in the Layers Panel.
<< Add video >>
Update Junction Details
- In the QGIS Layers Panel, select (left click) Nodes--Junctions and toggle on editing.
- 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.
- Go to TUFLOW > SWMM in the processing tool list and select Junctions - Set attributes processing tool. This opens the dialog shown below.
- Input BC Connection Layer: 2d_bc_SWMM_Connections_001_L
- Nodes connected to 2D without Inlets (Ysur): 0
- Nodes connected to 2D without Inlets (Apond): 50
- Select 'Modify All Features'.
- Once the tool has finished, click 'Close'.
- View the attributes associated within Nodes--Junctions to verify the data processing has been completed correctly.
<< Add video >>
Update Streets Details
SWMM Options
- In the QGIS Layer Panel, select (left click) Options and toggle on editing.
- Right click Options select 'Open Attribute Table'.
- Update the following fields:
- Start Date: 01/01/2020 (USA Date Format: MM/DD/YYY)
- Report step: 00:05:00
- Turn off editing to save the edits.
<< Add video >>
Export SWMM INP File
SWMM does not read TS02_001.gpkg directly as an input GIS file. SWMM requires a INP file.
- In the QGIS Layer Panel, right click Links--Conduits and select TUFLOW > 'SWMM - Export inp file'. This opens the dialog shown below.
- Select TS01_001.gpkg as the GeoPackage Input File.
- Set the SWMM output filename to TS02_001.inp in the TUFLOW/model/swmm folder.
- Select "Run", then "Close" after the processing is complete.
<< Add video >>
Simulation Control Files
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.
- Open TS01_5m_001.tcf from the TUFLOW_SWMM_Module_02\TUFLOW\runs folder in a Text Editor (Notepad++ is recommended).
- Save a copy of TS01_5m_001.tcf as TS02_5m_001.tcf.
- Open the following files using the Open File function in Notepad++:
- Open TS01_001.tbc, and save the file as TS02_001.tbc.
- Open M02_001.tgc, and save the file as TS02_001.tgc.
- Open TS01_001.tscf, and save the file as TS02_001.tscf.
- After creating the new control files, update the following references in TS02_5m_001.tcf:
Geometry Control File == ..\model\TS02_001.tgc ! Reference the TUFLOW Geometry Control File
BC Control File == ..\model\TS02_001.tbc ! Reference the TUFLOW Boundary Conditions Control File
SWMM Control File == ..\model\TS02_001.tscf ! Reference the SWMM (1D) Control File
- Save TS02_5m_001.tcf.
TUFLOW Boundary Control File (TBC)
- Open TS02_001.tbc. If using Notepad++, right click the file reference in TS02_5m_001.tcf and select Open File.
- Add the following additional command lines to TS02_001.tbc:
Spatial Database == swmm\TS02_001.gpkg
Read GIS BC == 2d_bc_SWMM_Culvert_Connections_001_L ! Links the 1D culverts to the 2D domain
Read GIS BC == 2d_bc_SWMM_Pipe_Network_Connections_001_P ! Links the 1D Pipe Network Inlets to the 2D domain
Read GIS BC == 2d_bc_SWMM_Pipe_Network_Connections_001_L ! Links the 1D Pipe Network Outlets to the 2D domain - Save the TBC.
<< Add video >>
TUFLOW Geometry Control File (TGC)
- Open TS02_001.tgc.
- Add the following additional command lines to TS02_001.tgc:
Read GIS BC == 2d_bc_SWMM_Pipe_Network_Connections_001_L ! Links the 1D Pipe Network Outlets to the 2D domain - Save the TGC.
<< Add video >>
TUFLOW SWMM Control File (TSCF)
- Open TS02_001.tscf.
- Add the following command lines:
Read SWMM == swmm\TS01_SWMM_Culvert_001.inp ! 1D SWMM input file
Read SWMM == swmm\TS01_SWMM_Pipe_Network_001.inp ! 1D SWMM input file - Save the TSCF.
<< Add video >>
Running the Simulation
- Save a copy of _run_M02_HPC.bat as _run_TS02_HPC.bat in the TUFLOW_SWMM_Module_02\TUFLOW\runs folder.
- Update the batch file to reference the TS02_5m_001.tcf :
set exe="..\..\..\exe\2023-03-AD\TUFLOW_iSP_w64.exe"
set run=start "TUFLOW" /wait %exe% -b
%run% TS01_5m_001.tcf - Double click the batch file in Windows file explorer to run the simulation.
<< Add video >>
If your model simulation did not run. Here is a link to some comon Tutorial Trouble Shooting advice.
Check Files and Results Output
Complete the steps outlines in the following link to review check files and simulation results from the TUFLOW SWMM model simulation:
TUFLOW SWMM Tutorial 02 Check Files
TUFLOW SWMM Tutorial 02 Results
Conclusion
- EPA SWMM Culverts were added to convey water through the structures under the three roads in the tutorial model.
- Check files were used to review the application of the boundary links.
- Results through the 1D network structures were assessed.
Up |
---|
![]() |