Difference between revisions of "TUFLOW SWMM Tutorial M01"

From Tuflow
Jump to navigation Jump to search
Line 42: Line 42:
 
<ol>
 
<ol>
 
<li>Save a copy of the '''M02_5m_001.tcf''' as '''M03_5m_001.tcf''' in the '''Module_03\TUFLOW\runs''' folder.  
 
<li>Save a copy of the '''M02_5m_001.tcf''' as '''M03_5m_001.tcf''' in the '''Module_03\TUFLOW\runs''' folder.  
<li>Open the '''M03_5m_001.tcf''' in a text editor and add the following line in the 'Model Inputs' section:  <br>
+
<li>Open the '''M03_5m_001.tcf''' in a text editor:<br>
 +
Add the following line in the 'Model Inputs' section:  <br>
 
<font color="blue"><tt>SWMM Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> ..\model\TS01_001.tscf </tt></font> <font color="green"><tt>  ! Reference the SWMM (1D) Control File</tt></font> <br>
 
<font color="blue"><tt>SWMM Control File </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt> ..\model\TS01_001.tscf </tt></font> <font color="green"><tt>  ! Reference the SWMM (1D) Control File</tt></font> <br>
Add the folloiwng command to the 'OUTPUT SETTINGS' section: <br>
+
Add the following line in the 'OUTPUT SETTINGS' section: <br>
 
<font color="blue"><tt>NetCDF Output Start Date </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2020-01-01 00:00 </tt></font> <font color="green"><tt>! Sets the output units for the NetCDF time variable</tt></font> <br>
 
<font color="blue"><tt>NetCDF Output Start Date </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>2020-01-01 00:00 </tt></font> <font color="green"><tt>! Sets the output units for the NetCDF time variable</tt></font> <br>
 
<li>Make the following reference updates:  <br>
 
<li>Make the following reference updates:  <br>

Revision as of 10:06, 24 November 2023

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

GIS Inputs

Create, import and view input data:


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