TUFLOW SWMM Tutorial M01

From Tuflow
Jump to navigation Jump to search

Introduction

In this module, three culverts are added to represent flow through embankments that block the main creek flow path. EPA SWMM is used as the solution scheme for the 1D culvert flow calculations, dynamically linked with the TUFLOW HPC 2D solution scheme.

The GIS layers are:

  • TSCF (TUFLOW SWMM Control File) layers:
    1. SWMM.inp: A text file containing a record of the SWMM culvert inputs and also SWMM simulation parameters.
    1. 1d_SWMM_Inlet: A layer used to define culvert inlet nodes.
  • TBC layers:
    1. 2d_bc: A layer defining the locations of 1D/2D links.

TUFLOW SWMM Module 1 builds from the model created in TUFLOW Module 2 (in the TUFLOW Only tutorial dataset). The completed Module 2 model is provided in the TUFLOW_SWMM_Module_01\TUFLOW folder as the starting point for this tutorial

SWMM Inputs and 1D/2D Linking

Create SWMM GeoPackage Spatial Database

  1. 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.
  2. Open QGIS and slect the Processing >> Toolbox to open the Processing Toolbox panel.
  3. From the TUFLOW >> SWMM processing tool list, select GeoPackage-Create.
  4. Within the GeoPackage-Create options, set the following:
    • CRS for GeoPackage = Project CRS: EPSG:32760 - WGS 84/UTM zone 60S
    • Initial SWMM Sections, click on the ... button, then select: Title, Options, Nodes-Junctions, Nodes-Outfalls, Links-Conduits, Streets, Inlets, Report
    • GPKG file name to create, click on the ... button, select Save to File.... Navigate to the newly created swmm folder and set the SWMM GeoPackage Spatial Database name to TS01_001.gpkg
    • Select Run. After the processing task is complete, select Close.
  5. Open the new SWMM GeoPackage Spatial Database in QGIS by dragging and dropping swmm\TS01_001.gpkg from Windows Explorer into QGIS. When prompted by QGIS select "Add Layers" to open all vectors within the GeoPackage database. By default, all items in the available list should have been selected.

<< Add video of above steps>>

GIS Data Entry

Navigate to the TUFLOW_SWMM_Module_01\Tutorial_Data folder in Windows Explorer. Drag and drop SWMM_Culverts.gpkg into QGIS to open the file. SWMM_Culverts.gpkg includes three Layers, Links-Conduits, Nodes-Junctions and Nodes-Outfall. Links-Conduits defines the culvert location, type and geometry. Nodes-Junction define the upstream culverts inverts. Nodes-Outfall define the downstream culvert inverts.

Complete the following steps:

  1. Copy the objects from Links-Conduits SWMM_Culverts.gpkg into Links-Conduits TS01_001.gpkg. Steps to Copy/Paste are as follows:
    • Left click Links-Conduits SWMM_Culverts.gpkg in the QGIS Layers Panel.
    • Use the select the Feature by Area tool. to select all items included in Links-Conduits SWMM_Culverts.gpkg
    • Select Edit >> Copy Features
    • Left click Links-Conduits TS01_001.gpkg in the QGIS Layers Panel.
    • Select Toggle Editing to enable changes to be made to the Layer.
    • Select Edit >> Paste Features

<< Add video for Copy Paste>

  1. Copy the objects from Nodes-Junction SWMM_Culverts.gpkg into Nodes-Junction TS01_001.gpkg. Junctions are considered inlets, and should be defined at the upstream end of culverts.
  2. Copy the objects from Nodes-Outfall SWMM_Culverts.gpkg into Nodes-Outfall TS01_001.gpkg. Outfalls are treated as outlets, and are required at the downstream end of culverts.
  3. Close SWMM_Culverts.gpkg
  4. Inspect the attribute information within the respective layers to familiarize yourself with the data.

<< Add video for viewing attribute data>>

GIS Data Updates

Update Conduit Details

We will update the From Node and To Node attribute information in Links-Conduits TS01_001.gpkg. The information is extracted from Nodes-Junction and Nodes-Outfall automatically using the Conduits - Assign Node Fields tool from the Processing Toolbox.

  1. Select (Left mouse click) Links-Conduits TS01_001.gpkg in the QGIS Layers panel and Toggle Editing on.
  2. From the Processing Toolbox, select "Editing in place". This allows the editing of an existing Layer, instead of the creatin of a new Layer
  3. Select the Conduits - Assign Node Fields tool.
  4. Select Nodes-Junction and Nodes-Outfall in the SWMM Node Layers field.
  5. Select Modify All Features.
  6. Close the Conduits - Assign Node Fields tool.

View the attributes associated with Links-Conduits TS01_001.gpkg. The From Node and To Node attribute information is now configured correctly.

Create 1D/2D Connections

  1. Select the Links - Conduits layer from the swmm_M01_001.gpkg file by left clicking on it once in the Layers.
  2. In the search box of the Processing Toolbox panel, type SWMM.
  3. From the SWMM list, choose the BC - Create channel endpoint 1D/2D connections option and double click. A new Window now is open.
  4. In Parameters tab the following options are presented: Input Conduits Layer, Offset distance, Length of BC lines and Output Layer.
    • For the Input Conduits Layer, pick up: Links Conduits
    • For the Offset distance, provide the value of: 2
    • For the Length of BC lines, insert the value of: 10
    • For the Output Layer, click on the ... button. From the options available select: Save to GeoPackage. From the new Window, direct to M06_5m_003.gpkg in the Module_01\TUFLOW\model\gis folder and click Save. A Layer Name Window will open. Provide the following name: 2d_bc_swmm_connections_L click OK and then Run and Close. The process creates HX and SX connections to the culverts.
  5. Now, you can check and modify the boundary lines as needed to cover the channels as per the example below:


[VIDEO]


Other

Rusty - Do I need to include the Steet input if I'm not using no grade or sag inlets

also where does someone get the template file for the ext_inlets_P? Does AD beta produce it?

SWMM Options

  1. Select the Options Layer in TS01_001.gpkg file.
  2. Select Toggle Editing to enable changes to be made to the Layer.
  3. Right click the Layer in the Layers Panel and select 'Open Attribute Table'.
  4. Update the following option:
    • Start Date: 01/01/2020 (USA Date Format: MM/DD/YYY)
    • Report step: 00:05:00
  5. Save and Toggle Editing off.


<< Add video of above steps>>

1D/2D Linking

Simulation Control Files

TUFLOW Boundary Control File (TBC)

To differentiate the TUFLOW SWMM tutorials from the TUFLOW/ESTRY tutorials, TS will be used as the new file prefix in this series of tutorials.

  1. Save a copy of the M01_001.tbc as TS01_001.tbc in the TUFLOW_SWMM_Module_01\TUFLOW\model folder.
  2. Open TS01_001.tbc in a text editor and add the additional lines:
    Read GIS BC == 2d_bc_SWMM_Connections_001_L ! Links the 1D culverts to the 2D domain
  3. Save the TBC.

TUFLOW SWMM Control File (TSCF)

A new control file, the TUFLOW SWMM Control File (TSCF), is introduced. SWMM is a 1D hydraulic solver. All 1D SWMM files and commands are referenced in the TUFLOW SWMM Control File.

  1. Create a new text file TS01_001.tscf and save it in the TUFLOW_SWMM_Module_01\TUFLOW\model folder.
  2. Add the following command lines:
    Read SWMM == ..\swmm\TS01_001.inp ! 1D SWMM input file
    Spatial Database == ..\swmm\TS01_001.gpkg ! Location of the SWMM GeoPackage Spatial Database
    Read GIS SWMM Inlet Usage == 1d_SWMM_Inlet ! Something??
  3. Save the TSCF.

TUFLOW Control File (TCF)

  1. Save a copy of the M02_5m_001.tcf as M03_5m_001.tcf in the Module_03\TUFLOW\runs folder.
  2. Open the M03_5m_001.tcf in a text editor:
    Add the following line in the 'Model Inputs' section:
    SWMM Control File == ..\model\TS01_001.tscf ! Reference the SWMM (1D) Control File
    Add the following line in the 'Output Settings' section:
    NetCDF Output Start Date == 2020-01-01 00:00 ! Sets the output units for the NetCDF time variable
  3. Make the following reference updates:
    Spatial Database == ..\model\gis\TS01_001.gpkg ! Specify the location of the GeoPackage Spatial Database
    BC Control File == ..\model\TS01_001.tbc ! Reference the TUFLOW Boundary Conditions Control File
  4. Save the TCF.

Running the Simulation

  1. Save a copy of _run_M02_HPC.bat as _run_TS01_HPC.bat in the TUFLOW_SWMM_Module_01\TUFLOW\runs folder.
  2. Update the batch file to reference the TS01_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
  3. Double click the batch file in Windows file explorer to run the simulation.

Troubleshooting

See tips on common mistakes and troubleshooting steps if the model doesn't run:


Check Files

While the model is running, review the added features are specified correctly:

Results

When the model is finished, review the results:


Conclusion

  • Culverts were added to the model. Three different SX boundary applications were used to transfer flow through road embankments.
  • Check files were used to review the application of the boundary links.
  • Results through the 1D network structures were assessed to validate the 1D stability.


Up
Go-up.png Back to TUFLOW SWMM Tutorial Introduction Main Page