TUFLOW CATCH Tutorial M04 Draft

From Tuflow
Jump to navigation Jump to search

Page Under Construction

Introduction

In this module, a TUFLOW CATCH integrated model with interventions is developed.

TUFLOW CATCH Tutorial Module 4 is built from the model created in TUFLOW CATCH Module 3. The completed TUFLOW CATCH Module 03 is provided in the TUFLOW_CATCH_Module_04\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, TUFLOW CATCH Module 2 and TUFLOW CATCH Module 3 prior to starting this tutorial.

GIS Inputs

Create, import and view input data:

Treatment Tables

Treatment tables can be used in TUFLOW CATCH integrated 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 the specific section of the catch manual for details on unit conventions.
  • Flow rate: The volume of water passing through the treatment device (m^3/s)

Treatment tables allow users to vary pollutant removal efficiency. Recognising 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. last sentence could be worded better/included more seamlessly For more information about treatment tables and their properties, please refer to the specific section of the catch manual.

For this tutorial, treatment tables for E. coli and clay have been provided:

  1. In Windows File Explorer, navigate to the TUFLOW_CATCH_Module_04\Tutorial_Data folder. Copy the TC04_ecoli_treatment_001.csv and TC04_clay_treatment_001.csv and paste them in the TUFLOW_CATCH_Module_04\Modelling\TUFLOW\bc_dbase folder.
  2. Open the TC04_ecoli_treatment_001.csv. The first row defines the incoming concentration (cfu/100mL), and the first column defines the incoming flow rate (m^3/s). The other values are the removal factors, which define the proportion of pollutant removed for a given concentration and flow rate. For example, for an incoming concentration of 100000 cfu/100mL and a incoming flow rate of 5 m^3/s, the removal factor is 0.15. The concentration and flow ranges were determined from the outputs of the previous tutorial model ( TUFLOW CATCH Tutorial 3).

    File:Image of ecoli treatment table

  3. Open the TC04_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:Image of the clay treatment table

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

For this tutorial, leave all commands as is. This section of the .tcc was populated in TUFLOW CATCH Tutorial 3.

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.

  1. Save a copy of TC03_001.tcc as TC04_001.tcc in the TUFLOW_CATCH_Module_04\Modelling\TUFLOWCatch\runs folder. Open TC04_001.tcc in a text editor.
  2. In the 'Interventions' section, update the following command to reference the interventions (2d_im) layer created earlier in this tutorial.
    Read GIS Intervention == ..\..\TUFLOW\model\gis\2d_im_TC04_001_L.shp ! GIS layer defining interventions
  3. In the 'Mass Removal Properties' section, add the following device block. This block defines the default (or spatially uniform) mass removal methods ?for all pollutants? for 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 the section of the catch manual.
    Device == ALL ! Default parameters for all devices
    SED_CLAY, Method == Eqn, Eqn == Constant, Coefficients == 1.0
    WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 1.0
    WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 1.0
    End Device
    Device == trench1, trench2 ! ?
    SED_CLAY, Method == Eqn, Eqn == Constant, Coefficients == 0.4
    WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.9
    WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.9
    End Device
    Device == retentionBasin ! ?
    SED_CLAY, Method == Eqn, Eqn == Constant, Coefficients == 0.8
    WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Table, Path == ..\..\TUFLOW\bc_dbase\TC04_ecoli_treatment_001.csv
    WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Table, Path == ..\..\TUFLOW\bc_dbase\TC04_ecoli_treatment_001.csv
    End Device
    Device == bufferStrip1, bufferStrip2 ! ?
    SED_CLAY, Method == Table, Path == ..\..\TUFLOW\bc_dbase\TC04_clay_treatment_001.csv
    WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.4
    WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Eqn, Eqn == Constant, Coefficients == 0.7
    End Device

Receiving Model

For this tutorial, leave all commands as is. This section of the .tcc was populated in TUFLOW CATCH Tutorial 3.

Running the Simulation

  1. In Windows File Explorer, navigate to the TUFLOWCatch\runs folder. Save a copy of _run_TC03_CATCH.bat as _run_TC04_CATCH.bat maybe change name?? and open the file in a text editor.
  2. Update the batch file to reference the TC04_001.tcc:
    set exe="..\..\..\..\exe\TUFLOWCATCH\2025.0.1\TUFLOWCATCH.exe"
    %exe% TC04_001.tcc
  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 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:

Conclusion