TUFLOW CATCH Tutorial M02 - Revision history

Emilie Nielsen: /* Running the Simulation */

2026-03-30T02:08:09Z

Running the Simulation

← Older revision		Revision as of 12:08, 30 March 2026
Line 84:		Line 84:
	<li>In Windows File Explorer, navigate to the '''TUFLOWCATCH\runs''' folder. Save a copy of '''_run_TC01_CATCH.bat''' as '''_run_TC02_CATCH.bat''' and open the file in a text editor.		<li>In Windows File Explorer, navigate to the '''TUFLOWCATCH\runs''' folder. Save a copy of '''_run_TC01_CATCH.bat''' as '''_run_TC02_CATCH.bat''' and open the file in a text editor.
	<li>Update the batch file to reference the '''TC02_001.tcc''':<br>		<li>Update the batch file to reference the '''TC02_001.tcc''':<br>
	<tt><font color=blue>set </font>exe<font color=red>=</font>"..\..\..\..\exe\TUFLOWCATCH\~~2025~~.1.0\TUFLOWCATCH.exe"</tt><br>		<tt><font color=blue>set </font>exe<font color=red>=</font>"..\..\..\..\exe\TUFLOWCATCH\2026.0.0\TUFLOWCATCH.exe"</tt><br>
	<tt><font color=orange>%exe%</font> TC02_001.tcc</font></tt>		<tt><font color=orange>%exe%</font> TC02_001.tcc</font></tt>
	<li>Double click the batch file in file explorer to run the simulation. <br>		<li>Double click the batch file in file explorer to run the simulation. <br>

Pavlina Monhartova: /* Conclusion */

2025-10-23T06:07:03Z

Conclusion

← Older revision		Revision as of 16:07, 23 October 2025
Line 103:		Line 103:
	* Check files were used to review the placement of intervention devices.		* Check files were used to review the placement of intervention devices.
	* TUFLOW CATCH interventions summary and TUFLOW map outputs were assessed to observe the mass removal for each intervention device.		* TUFLOW CATCH interventions summary and TUFLOW map outputs were assessed to observe the mass removal for each intervention device.
			* For further training opportunities see <u>[https://tuflow.com/training/training-course-catalogue/ TUFLOW Training Catalogue]</u> and/or contact <u>[mailto:training@tuflow.com training@tuflow.com]</u>. <br>
	<br>		<br>
	{{Tips Navigation		{{Tips Navigation

Emilie Nielsen: /* Receiving Model */

2025-07-02T05:54:42Z

Receiving Model

← Older revision		Revision as of 15:54, 2 July 2025
Line 78:		Line 78:

	=== Receiving Model ===		=== Receiving Model ===
	For this tutorial, leave all commands as is.		For this tutorial, leave all commands as is. This section of the .tcc will be populated in <u>[[TUFLOW_CATCH_Tutorial_M03 \| TUFLOW CATCH Tutorial 03]]</u>.

	= Running the Simulation =		= Running the Simulation =

Emilie Nielsen: /* Troubleshooting */

2025-06-10T05:11:12Z

Troubleshooting

← Older revision		Revision as of 15:11, 10 June 2025
Line 92:		Line 92:
	See tips on common mistakes and troubleshooting steps if the model doesn't run:		See tips on common mistakes and troubleshooting steps if the model doesn't run:
	:*<u>[[Tutorial_Troubleshooting_QGIS \| QGIS]]</u>		:*<u>[[Tutorial_Troubleshooting_QGIS \| QGIS]]</u>


	= Check Files and Results Output =		= Check Files and Results Output =

Emilie Nielsen: /* Running the Simulation */

2025-06-10T05:11:06Z

Running the Simulation

← Older revision		Revision as of 15:11, 10 June 2025
Line 88:		Line 88:
	<li>Double click the batch file in file explorer to run the simulation. <br>		<li>Double click the batch file in file explorer to run the simulation. <br>
	</ol>		</ol>
	<br>

	= Troubleshooting =		= Troubleshooting =

Chris Huxley: /* Introduction */

2025-06-02T23:47:10Z

Introduction

← Older revision		Revision as of 09:47, 3 June 2025
Line 1:		Line 1:
	= Introduction =		= Introduction =
	In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>		In this module, a TUFLOW CATCH pollutant export model with interventions is developed. Interventions are representative of water quality pollutant treatment infrastructure. <br>

	TUFLOW CATCH Tutorial 02 is built from the pollutant export model created in <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u>. The completed TUFLOW CATCH Tutorial 01 is provided in the '''TUFLOW_CATCH_Module_02\Modelling''' folder of the download dataset as the starting point for this tutorial.		TUFLOW CATCH Tutorial 02 is built from the pollutant export model created in <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u>. The completed TUFLOW CATCH Tutorial 01 is provided in the '''TUFLOW_CATCH_Module_02\Modelling''' folder of the download dataset as the starting point for this tutorial.

Emilie Nielsen: /* Introduction */

2025-06-02T02:07:52Z

Introduction

← Older revision		Revision as of 12:07, 2 June 2025
Line 2:		Line 2:
	In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>		In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>

	TUFLOW CATCH Tutorial ~~Module~~ 02 is built from the pollutant export model created in <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u>. 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.		TUFLOW CATCH Tutorial 02 is built from the pollutant export model created in <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u>. The completed TUFLOW CATCH Tutorial 01 is provided in the '''TUFLOW_CATCH_Module_02\Modelling''' folder of the download dataset as the starting point for this tutorial.
	If unfamiliar with TUFLOW CATCH, it is recommended to complete <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u> prior to starting this tutorial.		If unfamiliar with TUFLOW CATCH, it is recommended to complete <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u> prior to starting this tutorial.

Emilie Nielsen: /* Introduction */

2025-05-28T00:21:27Z

Introduction

← Older revision		Revision as of 10:21, 28 May 2025
Line 2:		Line 2:
	In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>		In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>

	TUFLOW CATCH Tutorial Module 02 is built from the pollutant export model created in <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH ~~Module~~ 01]]</u>. 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.		TUFLOW CATCH Tutorial Module 02 is built from the pollutant export model created in <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u>. 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 unfamiliar with TUFLOW CATCH, it is recommended to complete <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH ~~Module~~ 01]]</u> prior to starting this tutorial.		If unfamiliar with TUFLOW CATCH, it is recommended to complete <u>[[TUFLOW_CATCH_Tutorial_M01 \| TUFLOW CATCH Tutorial 01]]</u> prior to starting this tutorial.

	= GIS Inputs =		= GIS Inputs =

Emilie Nielsen at 00:16, 28 May 2025

2025-05-28T00:16:02Z

← Older revision		Revision as of 10:16, 28 May 2025
Line 1:		Line 1:
	<font color="red"><font size=18>Page Under Construction</font></font>
	= Introduction =		= Introduction =
	In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>		In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <br>

Emilie Nielsen: Created page with "Page Under Construction = Introduction = In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <..."

2025-05-28T00:15:52Z

Created page with "Page Under Construction = Introduction = In this module, a TUFLOW CATCH pollutant export model with interventions is developed. <..."

New page

Page Under Construction
= Introduction =
In this module, a TUFLOW CATCH pollutant export model with interventions is developed. 

TUFLOW CATCH Tutorial Module 02 is built from the pollutant export model created in [[TUFLOW_CATCH_Tutorial_M01 | TUFLOW CATCH Module 01]]. 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 unfamiliar with TUFLOW CATCH, it is recommended to complete [[TUFLOW_CATCH_Tutorial_M01 | TUFLOW CATCH Module 01]] prior to starting this tutorial.

= GIS Inputs =
Create, import and view input data:
:*[[TUFLOW_CATCH_Tutorial_M02_GIS_Inputs_QGIS | TC02 - GIS Inputs]]

= Treatment Tables =
Treatment tables can be used in TUFLOW CATCH models with interventions. Treatment tables are one of the mass removal methods offered by TUFLOW CATCH. A treatment table is a two dimensional array that defines the proportion of pollutant mass removed from the incoming water based on:
* Incoming pollutant concentration: The concentration of a given pollutant entering the treatment device.
:''Note:'' The concentration units depend on the pollutant. Refer to [https://docs.tuflow.com/catch/manual/2025.1/SimulationConstruction-1.html#SCTCCPollExpUnits-5 Section 4.5.3.3.3 of the TUFLOW CATCH Manual] for details on unit conventions.
* Flow rate: The volume of water passing through the treatment device (m³/s).
Treatment tables allow users to vary pollutant removal efficiency. This recognises that some intervention devices perform better when pollutants enter at higher concentrations and lower flow rates, rather than at lower concentrations with higher flow rates. For more information about treatment tables and their properties, please refer to [https://docs.tuflow.com/catch/manual/2025.1/ProcessDescriptions-1.html#ProcessDescriptionsIntervMatrix-4 Section 3.3.1.2 of the TUFLOW CATCH Manual].

For this tutorial, treatment tables for E. coli and clay have been provided:
<ol>
<li>In Windows File Explorer, navigate to the '''TUFLOW_CATCH_Module_02\Tutorial_Data''' folder. Copy the '''TC02_ecoli_treatment_001.csv''' and '''TC02_clay_treatment_001.csv''' and paste them in the '''TUFLOW_CATCH_Module_02\Modelling\TUFLOW\bc_dbase''' folder.
<li>Open the '''TC02_ecoli_treatment_001.csv'''. The first row (below the title) defines the incoming concentration (cfu/100mL) and the first column defines the incoming flow rate (m³/s). The other values are the mass removal factors, which define the proportion of pollutant removed for a given concentration and flow rate. For example, for an incoming concentration of 200000 cfu/100mL and an incoming flow rate of 1 m³/s, the removal factor is 0.2. The concentration and flow ranges were determined from the outputs of the previous tutorial model ([[TUFLOW_CATCH_Tutorial_M01 |TUFLOW CATCH Tutorial 01]]). 
 
[[File: TC2_treatment_table_ecoli_01b.png]] 
 
<li>Open the '''TC02_clay_treatment_001.csv'''. This file follows the same structure as the E. coli treatment table, however the incoming concentrations are in mg/L instead of cfu/100mL. 
 
[[File: TC2_treatment_table_clay_01b.png]] 
 
</ol>

= Simulation Control Files =
The following steps will require use of a text editor. The tutorial demonstration uses Notepad++. For its configuration information refer to [[NotepadPlusPlus_Tips | Notepad++ Tips]]. 

== 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_M01 | TUFLOW CATCH Tutorial 01]].

=== Catchment Hydraulic Model ===
For this tutorial, leave all commands as is. This section of the .tcc was populated in [[TUFLOW_CATCH_Tutorial_M01 | TUFLOW CATCH Tutorial 01]].

=== Pollutant Export Model ===
This block contains commands that control the pollutant export (and other constituent) simulation. For this tutorial, the pollutant export model block must be updated to include interventions.
<ol>
<li> Save a copy of '''TC01_001.tcc''' as '''TC02_001.tcc''' in the '''TUFLOW_CATCH_Module_02\Modelling\TUFLOWCATCH\runs''' folder. Open '''TC02_001.tcc''' in a text editor.
<li> In the 'Interventions' section, update the following command to reference the interventions (2d_im) layer created earlier in this tutorial. 
<tt>Read GIS Intervention == ..\..\TUFLOW\model\gis\2d_im_TC02_001_L.shp ! GIS layer defining interventions</tt> 

<li>In the 'Mass Removal Properties' section, add the following device block. This block defines the default mass removal properties for all pollutants across all devices. Including it is considered best practice, as it ensures that all devices have their mass export properties specified. For more information on the mass removal parameters, please refer to [https://docs.tuflow.com/catch/manual/2025.1/SimulationConstruction-1.html#SCTCCPollExpInter-4 Section 4.5.3.5 of the TUFLOW CATCH Manual]. 
<tt>Device == ALL ! Default parameters for all devices</tt> 
:<tt>SED_CLAY, Method == Eqn, Eqn == Constant, Coefficients == 1.0</tt> 
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 1.0</tt> 
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 1.0</tt> 
<tt>End Device</tt> 

<li>Set the mass removal properties for intervention devices 'trench1' and 'trench2'. These devices are placed around the edges of paddocks C and D to manage the E. coli runoff. 
<tt>Device == trench1, trench2 ! Defines mass removal properties for trench1 and trench2</tt> 
:<tt>SED_CLAY, Method == Eqn, Eqn == Constant, Coefficients == 0.4</tt> 
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.9</tt> 
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.9</tt> 
<tt>End Device</tt> 

<li>Set the mass removal properties for intervention device 'retentionBasin'. This device is place parallel to the road on the eastern side of the model. It has been placed between paddockB and the culvert under the road to minimise clay and E. coli runoff. 
<tt>Device == retentionBasin ! Defines mass removal properties for retentionBasin</tt> 
:<tt>SED_CLAY, Method == Eqn, Eqn == Constant, Coefficients == 0.8</tt> 
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Table, Path == ..\..\TUFLOW\bc_dbase\TC02_ecoli_treatment_001.csv</tt> 
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Table, Path == ..\..\TUFLOW\bc_dbase\TC02_ecoli_treatment_001.csv</tt> 
<tt>End Device</tt> 

<li> Set the mass removal properties for intervention devices 'bufferStrip1' and 'bufferStrip2'. These devices are placed strategically to manage clay sediment runoff. 
<tt>Device == bufferStrip1, bufferStrip2 ! Defines mass removal properties for bufferStrip1 and bufferStrip2</tt> 
:<tt>SED_CLAY, Method == Table, Path == ..\..\TUFLOW\bc_dbase\TC02_clay_treatment_001.csv</tt> 
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.4</tt> 
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.7</tt> 
<tt>End Device</tt> 

<li> Save the .tcc.
</ol>

=== Receiving Model ===
For this tutorial, leave all commands as is.

= Running the Simulation =
<ol>
<li>In Windows File Explorer, navigate to the '''TUFLOWCATCH\runs''' folder. Save a copy of '''_run_TC01_CATCH.bat''' as '''_run_TC02_CATCH.bat''' and open the file in a text editor.
<li>Update the batch file to reference the '''TC02_001.tcc''': 
<tt>set exe="..\..\..\..\exe\TUFLOWCATCH\2025.1.0\TUFLOWCATCH.exe"</tt> 
<tt>%exe% TC02_001.tcc</tt>
<li>Double click the batch file in file explorer to run the simulation. 
</ol>
 

= Troubleshooting =
See tips on common mistakes and troubleshooting steps if the model doesn't run:
:*[[Tutorial_Troubleshooting_QGIS | QGIS]]

= 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_M02_Check_Files_QGIS | TC02 - Check Files]] 
:*[[TUFLOW_CATCH_Tutorial_M02_Results_QGIS | TC02 - Results]] 

= Conclusion =
* Intervention devices were added to a TUFLOW CATCH Pollutant Export model.
* Check files were used to review the placement of intervention devices.
* TUFLOW CATCH interventions summary and TUFLOW map outputs were assessed to observe the mass removal for each intervention device.
 
{{Tips Navigation
|uplink=[[TUFLOW_CATCH_Tutorial_Introduction| Back to Tutorial Introduction Main Page]]
}}