Tutorial M03

From Tuflow
Revision as of 14:22, 15 August 2023 by Emilie Nielsen (talk | contribs)
Jump to navigation Jump to search

Introduction

In this module, three culverts are added to better represent flow through embankments that fall on main flow paths.

The GIS layers are:

  • ECF layers:
    1. 1d_nwk: A layer used to define culverts in 1D.
  • TBC layers:
    1. 2d_bc: A layer defining the locations of 1D/2D links.

Module 3 builds from the model created in Module 2. The completed Module 2 model is provided in the Module_03\TUFLOW folder.

GIS Inputs

Create, import and view input data:


Simulation Control Files

TUFLOW Boundary Control File (TBC)

  1. Save a copy of the M01_001.tbc as M03_001.tbc in the Module_03\TUFLOW\model folder.
  2. Open the M03_001.tbc in a text editor and add the additional lines:
    QGIS - SHP
    Read GIS BC == gis\2d_bc_M03_culverts_001_P.shp ! Links the 1D culverts to the 2D domain
    Read GIS BC == gis\2d_bc_M03_culverts_001_R.shp | gis\2d_bc_M03_culverts_001_L.shp ! Links the 1D culverts to the 2D domain
    QGIS - GPKG
    Read GIS BC == 2d_bc_M03_culverts_001_P ! Links the 1D culverts to the 2D domain
    Read GIS BC == 2d_bc_M03_culverts_001_R | 2d_bc_M03_culverts_001_L ! Links the 1D culverts to the 2D domain
  3. Save the TBC.

The region and line 2d_bc files are read by the same command separated by a vertical line similar to 2d_zsh files that require more than one vector type. This is important as the SX region file is connected by a CN line within the 2d_bc line layer. By reading both of these layers on the same command line enables them to be linked.

ESTRY Control File (ECF)

A new control file, the ESTRY Control File (ECF), is introduced. ESTRY is TUFLOW’s 1D hydraulic solver and includes all of the 1D files and commands.

  1. Create a new text file M03_001.ecf and save it in the Module_03\TUFLOW\model folder.
  2. Add the following command lines:
    QGIS - SHP
    Timestep == 0.5 ! Specifies a 1D computational timestep as 0.5 seconds
    Read GIS Network == ..\model\gis\1d_nwk_M03_culverts_001_L.shp ! Defines culverts
    QGIS - GPKG
    Timestep == 0.5 ! Specifies a 1D computational timestep as 0.5 seconds
    Read GIS Network == 1d_nwk_M03_culverts_001_L ! Defines culverts
  3. Save the ECF.

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 and add the following line in the 'Model Inputs' section:
    ESTRY Control File == ..\model\M03_001.ecf ! Reference the ESTRY (1D) Control File
  3. Make the following reference updates:
    QGIS - SHP
    BC Control File == ..\model\M03_001.tbc ! Reference the TUFLOW Boundary Conditions Control File
  4. QGIS - GPKG
    Spatial Database == ..\model\gis\M03_001.gpkg ! Specify the location of the GeoPackage Spatial Database
    BC Control File == ..\model\M03_001.tbc ! Reference the TUFLOW Boundary Conditions Control File
  5. Save the TCF.


Running the Simulation

  1. Save a copy of _run_M02_HPC.bat as _run_M03_HPC.bat in the Module_03\TUFLOW\runs folder.
  2. Update the batch file to reference the M03_5m_001.tcf :
    set exe="..\..\..\exe\2023-03-AA\TUFLOW_iSP_w64.exe"
    set run=start "TUFLOW" /wait %exe% -b
    %run% M03_5m_001.tcf
  3. Double click the batch file in 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 Tutorial Introduction Main Page