TUFLOW CATCH Tutorial M04 Draft

Page Under Construction

Introduction

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

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

Meteorological Data

Meteorological inputs are defined in boundary condition blocks within the receiving model block of the TCC. more info on meteorological data? For this tutorial, timeseries meteorological data has been supplied.

1. In Windows File Explorer, navigate to the TUFLOW_CATCH_Module_03\Tutorial_Data folder. Copy the TC03_met_ts_001.csv and paste it in the TUFLOW_CATCH_Module_03\Modelling\TUFLOWFV\bc_dbase\met folder. This file contains the timeseries meteorological data.
2. Open the file. As this file is read by TUFLOW FV, the first column (Time) must contain the date is ISODATE format (DD/MM/YYYY hh:mm:ss). The other columns contain the data for the meteorological conditions that will be simulated in this model:
   

   AIR_TEMP: Outside air temperature (degrees Celsius)	REL_HUM: Relative humidity (%)
   LW_RAD: Downward longwave radiation (W m^-2)	W10_X: Wind velocity at 10m (m s^-1) what is the difference between W10_X and W10_Y?
   SW_RAD: Downward shortwave radiation (W m^-2)	W10_Y: Wind velocity at 10m (m s^-1) what is the difference between W10_X and W10_Y?

   
   
   File:Image of csv file
   
   

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.

Generate Template Files

This tutorial requires a Water Quality Control file (.fvwq) and a Sediment Transport Control file (.fvsed). Use the TUFLOW CATCH plugin to generate template files:

1. In QGIS, go to Processing > Toolbox from the top drop down menu options to open the Processing Toolbox.
2. Go to TUFLOW Catch in the processing tool list and select 'Create TUFLOW Catch Project'. This opens the dialog shown below:
   • Project Name: TC03
   • Project Folder: Click '...', and navigate to the TUFLOW_CATCH_Module_03\Modelling folder.
   • Project CRS: Click the drop down menu and select 'Project CRS: EPSG:32760 - WGS 84 / UTM zone 60S’.
   • TUFLOW HPC Executable: Click '...', and navigate to the exe\TUFLOW\2025.0.2 folder. Select TUFLOW_iSP_w64.exe.
   • TUFLOW FV Executable: Click '...', and navigate to the exe\TUFLOWFV\2025.0.0 folder. Select TUFLOWFV.exe.
   • Default GIS Format: Click the drop down menu and select 'SHP'.
   • Tick on 'Setup Control File Templates'.
   • Control File Templates: Click '...', and tick on: Water Quality Control file (.fvwq) and Sediment Control file (.fvsed). Ensure all other files are ticked off.
3. Click 'Run'. Once the tool has finished click 'Close'.
   
   File:Image of tool dialog
   
   

Water Quality Control File (FVWQ)

1. Navigate to the TUFLOWFV\wqm folder and open TC03_001.fvwq in a text editor.
2. In the 'Simulation Controls' sections, update the following commands:
   Simulation Class == DO ! Specify the simulation class to Dissolved Oxygen
   WQ dt == 300 ! Interval for updating the water quality module
   WQ Units == mgL ! Specify the units to be mgL
   
3. In the 'Constituent Model Settings', add the following commands to do what? .
   Oxygen Model == O2 ! ??
   

   Oxygen Min Max == 0.0, 12.0 ! ??
   

   Oxygen Benthic == 4.7, 1.08 ! ??
   

   End Oxygen Model
   Pathogen Model == Free, Ecoli ! ??
   

   Alive Min Max == 0.0, 1e7 ! ??
   

   Mortality == 0.08, 2e-12, 6.1, 1.0, 1.11 ! ??
   

   Visible Inactivation == 0.082, 0.0067, 0.5 ! ??
   

   UVA Inactivation == 0.5, 0.0067, 0.5 ! ??
   

   UVB Inactivation == 1.0, 0.0067, 0.5 ! ??
   

   Settling == -0.03 ! ??
   

   End Pathogen Model
   
4. In the 'Material Specifications' section, add the following material blocks to specify oxygen flux for each material ID.
   Material == Default ! ??
   

   Oxygen Flux == -1400.0
   

   End Material
   Material == 1 ! ??
   

   Oxygen Flux == -1100.0
   

   End Material
   Material == 2 ! ??
   

   Oxygen Flux == -1200.0
   

   End Material
   Material == 3 ! ??
   

   Oxygen Flux == -1300.0
   

   End Material
   
5. Save the FVWQ.

Sediment Transport Control File (FVSED)

1. Navigate to the TUFLOWFV\stm folder and open TC03_001.fvsed in a text editor.
2. Update the following command to match the output interval for the rest of the model (300secs or 5mins):
   Update dt == 300 ! Interval for updating the sediment transport module
   
3. In the 'Settings' section, update the following commands: more info ?
   Erosion Depth Limits == 0.1, 0.5 ! Depth limits within which the erosion rate is scaled down (meters)
   Deposition Depth Limits == 0.1, 0.5 ! Depth limits within which the deposition rate is scaled down (meters)
   Bed Roughness Model == ks ! ??
   Bed Roughness Parameters == 0.02, 0.02 ! ??
   
4. In the 'Fractions' section, add in the following Fraction block to set the parameters for clay.
   Fraction == Clay ! ??
   

   d50 == 0.0002 ! Specify the median grain size of the sediment fraction (meters)
   

   Particle Density == 2650.0 ! Specify the density of the particle group (kg/m^3)
   

   Settling Model == Constant ! ??
   

   Settling Parameters == 1e-05 ! ??
   

   Critical Stress Model == Constant ! ??
   

   Critical Stress Parameters == 0.15 ! Specify value that ?? must exceed to erode
   

   Erosion Model == Mehta ! ??
   

   Erosion Parameters == 0.01, 0.5, 1.0 ! ??
   

   Deposition Model == ws0 ! ??
   

   End Fraction
   
5. In the 'Materials' section, add the following material blocks to set the sediment transport properties for each material ID is this correct ??.
   Material == 1, 2 ! ??
   

   Nlayer == 1 ! Number of sediment bed layers?
   

   Layer == 1 ! Bed layer number?
   

   Dry Density == 800 ! Dry density of bed layer (kg/m^3)
   

   Initial Mass == 1500 ! Initial mass of each sediment fraction (kg/m^2)
   

   End Layer
   

   End Material
   Material == 3 ! ??
   

   Nlayer == 1 ! Number of sediment bed layers?
   

   Layer == 1 ! Bed layer number?
   

   Dry Density == 800 ! Dry density of bed layer (kg/m^3)
   

   Initial Mass == 3200 ! Initial mass of each sediment fraction (kg/m^2)
   

   End Layer
   

   End Material
   
6. Save the FVSED.

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.

1. Save a copy of TC02_001.tcc as TC03_001.tcc in the TUFLOW_CATCH_Module_03\Modelling\TUFLOWCatch\runs folder.
2. Open TC03_001.tcc in a text editor, and comment out the following command:
   ! Pollutant == Salinity, Temperature, WQ_DISS_OXYGEN_MG_L, WQ_PATH_ECOLI_ALIVE_CFU_100ML, WQ_PATH_ECOLI_DEAD_CFU_100ML, SED_CLAY ! Specify the pollutant names
   

Pollutant Export Model

This block contains commands that control the pollutant export (and other constituent) simulation. As this tutorial model is an integrated simulation, we must turn the pollutant export model back on:

1. Set the pollutant export model:
   Catchment Pollutant Export Model == Mass Accumulation Release
   
2. Uncomment all the commands. The pollutant export model block should look the same as in TUFLOW CATCH Tutorial 1

Receiving Model

This block contains commands that construct the TUFLOW FV simulation. For this tutorial, the receiving model block must be updated to include water quality and sediment transport.

1. In the 'General Parameters' section, update the following commands to turn on salinity, temperature, sediment and heat:
   Include Salinity == 1, 0 ! ??
   Include Temperature == 1, 0 ! ??
   Include Sediment == 1, 0 ! ??
   Include Heat == 1 ! ??
   
2. In the 'Water Quality' section, update the following commands to set the general WQ parameters and to reference the FVWQ.
   Water Quality Model == TUFLOW
   Water Quality Control File == ..\..\TUFLOWFV\wqm\TC03_001.fvwq ! Reference the Water Quality Control File
   Water Quality Model Directory == ..\..\TUFLOWFV\wqm\ ! Location of the Water Quality Directory
   Cell Water Quality Depth == 0.05 ! Minimum depth to execute water quality calculations (meters)
   
3. In the 'Sediment Transport' section, update the following command to reference the FVSED:
   Sediment Control File == ..\..\TUFLOWFV\stm\TC03_001.fvsed ! Reference the Sediment Control File
   
4. In the 'Initial Conditions' section, update the following commands to set the initial temperature and salinity:
   Initial Temperature == 17.0 ! Specify initial temperature (degrees Celsius)
   Initial Salinity == 0.0 ! Specify initial salinity (psu)
   
5. In the 'Meteorology' section, add the following boundary condition blocks to specify meteorological conditions.
   BC == LW_RAD, TC03_met_ts_001.csv ! Downward longwave radiation (W m^-2)
   

   BC Header == Time, LW_RAD ! Column headers to read from time series file
   

   BC Update dt == 300 ! Specify update timestep for BC (seconds)
   

   BC Time Units == Hours ! Specify time units
   

   BC Reference Time == 01/01/2021 10:00 ! Specify boundary condition reference time
   

   End BC
   BC == SW_RAD, TC03_met_ts_001.csv ! Downward shortwave radiation (W m^-2)
   

   BC Header == Time, SW_RAD
   

   BC Update dt == 300
   

   BC Time Units == Hours
   

   BC Reference Time == 01/01/2021 10:00
   

   End BC
   BC == W10, TC03_met_ts_001.csv ! Wind velocity at 10m (m s^-1)
   

   BC Header == Time, W10_X, W10_Y
   

   BC Update dt == 300
   

   BC Time Units == Hours
   

   BC Reference Time == 01/01/2021 10:00
   

   End BC
   BC == AIR_TEMP, TC03_met_ts_001.csv ! Temperature input (deg C)
   

   BC Header == Time, AIR_TEMP
   

   BC Update dt == 300
   

   BC Time Units == Hours
   

   BC Reference Time == 01/01/2021 10:00
   

   End BC
   BC == REL_HUM, TC03_met_ts_001.csv ! Relative humidity (%)
   

   BC Header == Time, REL_HUM
   

   BC Update dt == 300
   

   BC Time Units == Hours
   

   BC Reference Time == 01/01/2021 10:00
   

   End BC
   
6. In the 'Outputs' section, update the existing NetCDF output block to include sediment:
   Output == NetCDF
   

   Output Parameters == h, v, d, sed_1  ! Outputs water level, velocity, depth and sediment
   

   Output Interval == 30  ! Interval to output the data (seconds)
   

   Suffix == HD  ! ??

   End Output
   
7. At the end of the 'Outputs' section, add the following output block to output water quality results.
   Output == NetCDF
   

   Output Parameters == wq_all  ! Outputs water quality results
   

   Output Interval == 30  ! Interval to output the data (seconds)
   

   Suffix == WQ  ! ??

   End Output
   
8. Save the TCC.

Running the Simulation

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

• QGIS

Results Output

Complete the steps outlined in the following links to review simulation results from the TUFLOW CATCH integrated model simulation:

• TC03 - Results