TUFLOW CATCH Tutorial M02 Draft
Page Under Construction
Introduction
In this module, a TUFLOW CATCH hydrology model is developed.
TUFLOW CATCH Tutorial Module 2 is built from the model created in TUFLOW CATCH Module 1. The completed TUFLOW CATCH Module 01 is provided in the TUFLOW_CATCH_Module_02\Modelling folder of the download dataset as the starting point for this tutorial. If you are not already familiar with TUFLOW CATCH, we recommend completing TUFLOW CATCH Module 1 prior to starting this tutorial.
GIS Inputs
Create, import and view input data:
Simulation Control Files
The following steps will require use of a text editor. The tutorial demonstration uses Notepad++. For its configuration information refer to Notepad++ Tips.
TUFLOW Boundary Control File (TBC)
- Save a copy of TC01_001.tbc as TC02_001.tbc in the TUFLOW_CATCH_Module_02\Modelling\TUFLOW\model folder.
- Open the TC02_001.tbc in a text editor and update the reference to the 1D/2D culvert connections:
Read GIS BC == gis\2d_bc_TC02_001_P.shp ! Links the two upstream 1D culverts to the 2D domain
Read GIS BC == gis\2d_bc_TC02_001_L.shp ! Links the two upstream 1D culverts to the 2D domain
- Save the TBC.
TUFLOW ESTRY Control File (ECF)
- Save a copy of TC01_001.ecf as TC02_001.ecf in the TUFLOW_CATCH_Module_02\Modelling\TUFLOW\model folder.
- Open the TC02_001.ecf in a text editor and update the following line to reference the new 1d_nwk layer (containing the two upstream culverts):
Read GIS Network == gis\1d_nwk_TC02_001_L.shp ! Defines the two upstream culverts - Save the ECF.
TUFLOW CATCH Control File (TCC)
Global Settings
For this tutorial, leave all commands as is. This section of the .tcc was populated in TUFLOW CATCH Tutorial 1.
Catchment Hydraulic Model
This block contains commands that construct the TUFLOW HPC simulation.
- Save a copy of TC01_001.tcc as TC02_001.tcc in the TUFLOW_CATCH_Module_01\Modelling\TUFLOWCatch\runs folder.
- Open TC02_001.tcc in a text editor, and update the following commands to reference the new TBC and ECF:
BC Control File == ..\..\TUFLOW\model\TC02_001.tbc ! Reference the TUFLOW Boundary Conditions Control File
ESTRY Control File == ..\..\TUFLOW\model\TC02_001.ecf ! Reference the ESTRY (1D) Control File
- Remove or comment out the following command using a '!' symbol. The receiving polygon can only be used in the pollutant export configuration of TUFLOW CATCH.
! Receiving Polygon == ..\..\TUFLOW\model\gis\2d_rp_TC01_001_R.shp ! GIS layer defining the receiving polygon
Pollutant Export Model
This block contains commands that control the pollutant export (and other constituent) simulation. As this tutorial model is a hydrology simulation, we must set the pollutant export model to none, and comment out all commands. The pollutant export model block should look similar to the below:
- Catchment Pollutant Export Model == None
- ! Constant Salinity == 0.0
- ! Constant WQ_DISS_OXYGEN_MG_L == 8.0
- ! Time-Series Temperature == Temperature
- ! Material == ALL ! Default parameters for all materials
- ! SED_CLAY, Method == Shear1, Rate == 0.0, Limit == 100.0, Depth Threshold == 0.02, Deposition Stress == 0.1, Erosion Stress == 0.5, Deposition Velocity == 0.1, Erosion Rate == 0.05
- ! WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Washoff1, Rate == 0.0, Limit == 0.0, Time Constant == 3600.00, Rain Threshold == 1.0, Depth Threshold == 0.20, Deposition Velocity == 0.0
- ! WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Washoff1, Rate == 0.0, Limit == 0.0, Time Constant == 3600.00, Rain Threshold == 1.0, Depth Threshold == 0.20, Deposition Velocity == 0.0
- ! SED_CLAY, Method == Shear1, Rate == 0.0, Limit == 100.0, Depth Threshold == 0.02, Deposition Stress == 0.1, Erosion Stress == 0.5, Deposition Velocity == 0.1, Erosion Rate == 0.05
- ! End Material
- ! Other material specifications ...
- ! Other material specifications ...
- ! Constant Salinity == 0.0
- End Catchment Pollutant Export Model
Receiving Model
This block contains commands that construct the TUFLOW FV simulation. These commands are almost entirely those that would be used in setting up a standalone TUFLOW FV control file (.fvc), with a small number of additional commands that relate to TUFLOW CATCH.
- Set the receiving model:
Receiving Model == TUFLOWFV
Running the Simulation
Troubleshooting
See tips on common mistakes and troubleshooting steps if the model doesn't run:
Check Files and Results Output
Complete the steps outlined in the following links to review check files and simulation results from the TUFLOW CATCH pollutant export model simulation:
TUFLOW CATCH Tutorial 02 Check Files
TUFLOW CATCH Tutorial 02 Results