View source for TUFLOW CATCH Tutorial M02

= Introduction =
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. 
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 =
Create, import and view input data:
:*<u>[[TUFLOW_CATCH_Tutorial_M02_GIS_Inputs_QGIS | TC02 - GIS Inputs]]</u>

= 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 <u>[https://docs.tuflow.com/catch/manual/2025.1/SimulationConstruction-1.html#SCTCCPollExpUnits-5 Section 4.5.3.3.3 of the TUFLOW CATCH Manual]</u> 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 <u>[https://docs.tuflow.com/catch/manual/2025.1/ProcessDescriptions-1.html#ProcessDescriptionsIntervMatrix-4 Section 3.3.1.2 of the TUFLOW CATCH Manual]</u>.

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 (<u>[[TUFLOW_CATCH_Tutorial_M01 |TUFLOW CATCH Tutorial 01]]</u>). <br>
<br>
[[File: TC2_treatment_table_ecoli_01b.png]]<br>
<br>
<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. <br>
<br>
[[File: TC2_treatment_table_clay_01b.png]]<br>
<br>
</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 <u>[[NotepadPlusPlus_Tips | Notepad++ Tips]]</u>. <br>

== TUFLOW CATCH Control File (TCC) ==
=== Global Settings ===
For this tutorial, leave all commands as is. This section of the .tcc was populated in <u>[[TUFLOW_CATCH_Tutorial_M01 | TUFLOW CATCH Tutorial 01]]</u>.

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

=== 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. <br>
<tt><font color=blue>Read GIS Intervention</font><font color=red> == </font>..\..\TUFLOW\model\gis\2d_im_TC02_001_L.shp  <font color=green>  ! GIS layer defining interventions</font></tt><br>

<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 <u>[https://docs.tuflow.com/catch/manual/2025.1/SimulationConstruction-1.html#SCTCCPollExpInter-4 Section 4.5.3.5 of the TUFLOW CATCH Manual]</u>.<br>
<tt><font color=blue>Device</font><font color=red> == </font>ALL <font color=green>  ! Default parameters for all devices</font></tt><br>
:<tt>SED_CLAY, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 1.0</tt><br>
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 1.0</tt><br>
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 1.0</tt><br>
<tt><font color=blue>End Device</font></tt><br>

<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. <br>
<tt><font color=blue>Device</font><font color=red> == </font>trench1, trench2 <font color=green>  ! Defines mass removal properties for trench1 and trench2</font></tt><br>
:<tt>SED_CLAY, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 0.4</tt><br>
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 0.9</tt><br>
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 0.9</tt><br>
<tt><font color=blue>End Device</font></tt><br>

<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.<br>
<tt><font color=blue>Device</font><font color=red> == </font>retentionBasin <font color=green>  ! Defines mass removal properties for retentionBasin</font></tt><br>
:<tt>SED_CLAY, <font color=blue>Method </font><font color=red>==</font> Eqn, <font color=blue>Eqn </font><font color=red>==</font> Constant, <font color=blue>Coefficients </font><font color=red>==</font> 0.8</tt><br>
:<tt>WQ_PATH_ECOLI_ALIVE_CFU_100ML, <font color=blue>Method </font><font color=red>==</font> Table, <font color=blue>Path </font><font color=red>==</font> ..\..\TUFLOW\bc_dbase\TC02_ecoli_treatment_001.csv</tt><br>
:<tt>WQ_PATH_ECOLI_DEAD_CFU_100ML, <font color=blue>Method </font><font color=red>==</font> Table, <font color=blue>Path </font><font color=red>==</font> ..\..\TUFLOW\bc_dbase\TC02_ecoli_treatment_001.csv</tt><br>
<tt><font color=blue>End Device</font></tt><br>

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

<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''':<br>
<tt><font color=blue>set </font>exe<font color=red>=</font>"..\..\..\..\exe\TUFLOWCATCH\2025.1.0\TUFLOWCATCH.exe"</tt><br>
<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>
</ol>

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


= 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:

:*<u>[[TUFLOW_CATCH_Tutorial_M02_Check_Files_QGIS | TC02 - Check Files]]</u><br>
:*<u>[[TUFLOW_CATCH_Tutorial_M02_Results_QGIS | TC02 - Results]]</u><br>

= 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.
<br>
{{Tips Navigation
|uplink=[[TUFLOW_CATCH_Tutorial_Introduction| Back to Tutorial Introduction Main Page]]
}}