Difference between revisions of "TUFLOW CATCH Tutorial M02 Draft"

From Tuflow
Jump to navigation Jump to search
Line 16: Line 16:
 
=== TUFLOW Boundary Control File (TBC) ===
 
=== TUFLOW Boundary Control File (TBC) ===
 
<ol>
 
<ol>
<li>Save a copy of '''M06_003.tbc''' as '''TC01_001.tbc''' in the '''TUFLOW_CATCH_Module_01\Modelling\TUFLOW\model''' folder.  
+
<li>Save a copy of '''TC01_001.tbc''' as '''TC02_001.tbc''' in the '''TUFLOW_CATCH_Module_02\Modelling\TUFLOW\model''' folder.  
<li> Open the '''TC01_001.tbc''' in a text editor and update the reference to the 2D boundaries:<br>
+
<li> Open the '''TC02_001.tbc''' in a text editor and update the reference to the 1D/2D culvert connections:<br>
<tt><font color=blue>Read GIS BC</font><font color=red> == </font>gis\2d_bc_TC01_001_L.shp </font> <font color=green>  ! Reads in downstream 2D boundary</font></tt><br>
+
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bc_TC02_001_P.shp</tt></font> <font color="green"><tt>  ! Links the two upstream 1D culverts to the 2D domain</tt></font> <br>
<li> Add the additional lines:<br>
+
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bc_TC02_001_L.shp</tt></font> <font color="green"><tt>  ! Links the two upstream 1D culverts to the 2D domain</tt></font> <br>
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bc_M03_culverts_001_P.shp</tt></font> <font color="green"><tt>  ! Links the 1D culverts to the 2D domain</tt></font> <br>
 
<font color="blue"><tt>Read GIS BC </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\2d_bc_M03_culverts_001_R.shp | gis\2d_bc_M03_culverts_001_L.shp</tt></font> <font color="green"><tt>  ! Links the 1D culverts to the 2D domain</tt></font> <br>
 
 
<li>Save the TBC.
 
<li>Save the TBC.
 
</ol>
 
</ol>
Line 27: Line 25:
 
=== TUFLOW ESTRY Control File (ECF) ===
 
=== TUFLOW ESTRY Control File (ECF) ===
 
<ol>
 
<ol>
<li> Create a new text file '''TC01_001.ecf''' and save it in the '''TUFLOW_CATCH_Module_01\Modelling\TUFLOW\model''' folder.
+
<li> Save a copy of '''TC01_001.ecf''' as '''TC02_001.ecf''' in the '''TUFLOW_CATCH_Module_02\Modelling\TUFLOW\model''' folder.  
<li> Open the '''TC01_001.ecf''' in a text editor and add the following command lines to set the 1D computational timestep and define the culverts:<br>
+
<li> 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):<br>
<font color="blue"><tt>Timestep </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>0.5</tt></font> <font color="green"><tt>  ! Specifies a 1D computational timestep  as 0.5 seconds</tt></font> <br>
+
<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_nwk_TC02_001_L.shp</tt></font> <font color="green"><tt>  ! Defines the two upstream culverts</tt></font>  
<font color="blue"><tt>Read GIS Network </tt></font> <font color="red"><tt>== </tt></font> <font color="black"><tt>gis\1d_nwk_M03_culverts_001_L.shp</tt></font> <font color="green"><tt>  ! Defines culverts</tt></font>
 
<li> Add the following command line to define the Advection Dispersion (AD) approach. For more information on Advection Dispersion, please refer to the <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u>.<br>
 
<tt><font color=blue>AD Approach</font><font color=red> == </font>METHOD A </font> <font color=green>  ! Sets the modelling approach for the Advection Dispersion through 1D channels</font></tt>
 
 
<li>Save the ECF.
 
<li>Save the ECF.
 
</ol>
 
</ol>

Revision as of 13:53, 1 April 2025

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)

  1. Save a copy of TC01_001.tbc as TC02_001.tbc in the TUFLOW_CATCH_Module_02\Modelling\TUFLOW\model folder.
  2. 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
  3. Save the TBC.

TUFLOW ESTRY Control File (ECF)

  1. Save a copy of TC01_001.ecf as TC02_001.ecf in the TUFLOW_CATCH_Module_02\Modelling\TUFLOW\model folder.
  2. 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
  3. Save the ECF.

TUFLOW CATCH Control File (TCC)

intro...
The TUFLOW CATCH QGIS plugin has created a .tcc template file populated with .... Including adding the exe file paths.

Global Settings

Applied to the whole simulation. more info

  1. Navigate to the TUFLOW_CATCH_Module_01\Modelling\TUFLOWCatch\runs folder and open TC01_001.tcc into a text editor.
  2. In the 'Simulation Settings' section, update the time commands:
    Start Time == 01/01/2021 10:00:00 ! Specifies the simulation start time
    End Time == 01/01/2021 13:00:00 ! Specifies the simulation end time
  3. In the 'Boundary Condition Configuration' section, update the BC and CSV output intervals:
    Catch BC Output Interval Nodestring == 300 ! Outputs BC nodestring data every 300 seconds
    Catch BC Output Interval Lateral == 300 ! Outputs BC lateral data every 300 seconds
    CSV Write Frequency Day == 0.01 ! Writes CSV output every 0.01 days

Catchment Hydraulic Model

Hydraulic model specific commands - similar to TUFLOW tcf

  1. Set the catchment hydraulic model:
    Catchment Hydraulic Model == HPC
  2. Set the zero date. TUFLOW HPC does not support ISODATE format, while TUFLOW FV requires it. This command ensures compatibility by setting the date in TUFLOW FV ISODATE format that corresponds to zero hours in TUFLOW HPC boundary condition files.
    Zero Date == 01/01/2021 10:00 ! Specifies the simulation start time in TUFLOW FV ISODATE format
  3. In the 'GIS' section, update the following commands:
    GIS Format == SHP ! Specify SHP as the output format
    TIF Projection == ..\..\TUFLOW\model\grid\DEM.tif ! Sets the GIS projection for the output grid files
    SHP Projection? caused errors I think
  4. In the 'Solver' section, set the timestep maximum and time format:
    Timestep Maximum == 2.5 ! Specifies a maximum timestep (seconds)
    Time Format == TUFLOWFV ! Specifies the time format of output results

Pollutant Export Model

Receiving Model

For this tutorial, leave all commands as is. This section of the .tcc will be discussed in the next tutorial.

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

Conclusion