Emilie Nielsen: /* Running the Simulation */

2026-03-30T02:08:50Z

Running the Simulation

← Older revision		Revision as of 12:08, 30 March 2026
Line 162:		Line 162:
	<li>In Windows File Explorer, navigate to the '''TUFLOWCATCH\runs''' folder. Save a copy of '''_run_TC02_CATCH.bat''' as '''_run_TC03_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_TC02_CATCH.bat''' as '''_run_TC03_CATCH.bat''' and open the file in a text editor.
	<li>Update the batch file to reference the '''TC03_001.tcc''':<br>		<li>Update the batch file to reference the '''TC03_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> TC03_001.tcc</font></tt>		<tt><font color=orange>%exe%</font> TC03_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>

Emilie Nielsen: /* Introduction */

2026-02-02T03:33:05Z

Introduction

← Older revision		Revision as of 13:33, 2 February 2026
Line 4:		Line 4:
	TUFLOW CATCH Tutorial 03 is built from the model created in <u>[[TUFLOW_CATCH_Tutorial_M02 \| TUFLOW CATCH Tutorial 02]]</u>. The completed TUFLOW CATCH Tutorial 02 is provided in the '''TUFLOW_CATCH_Module_03\Modelling''' folder of the download dataset as the starting point for this tutorial.		TUFLOW CATCH Tutorial 03 is built from the model created in <u>[[TUFLOW_CATCH_Tutorial_M02 \| TUFLOW CATCH Tutorial 02]]</u>. The completed TUFLOW CATCH Tutorial 02 is provided in the '''TUFLOW_CATCH_Module_03\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> and <u>[[TUFLOW_CATCH_Tutorial_M02 \| TUFLOW CATCH Tutorial 02]]</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> and <u>[[TUFLOW_CATCH_Tutorial_M02 \| TUFLOW CATCH Tutorial 02]]</u> prior to starting this tutorial.

			'''Note:''' An NVIDIA GPU card is required to run this tutorial model. If this is not available, a shortened simulation can be run on CPU by updating the following commands in the Global Settings section of the TUFLOW CATCH Control file (.tcc):

			:<tt><font color=blue>Hardware </font><font color=red>==</font> CPU</tt>
			:<tt><font color=blue>End Time </font><font color=red>==</font> 01/01/2021 12:00:00</tt>

	= GIS Inputs =		= GIS Inputs =

Pavlina Monhartova: /* Conclusion */

2025-10-23T06:07:35Z

Conclusion

← Older revision		Revision as of 16:07, 23 October 2025
Line 184:		Line 184:
	* A TUFLOW FV mesh was added to the stream and the downstream culvert was redefined in TUFLOW FV format.		* A TUFLOW FV mesh was added to the stream and the downstream culvert was redefined in TUFLOW FV format.
	* A TUFLOW CATCH JSON file was created to review the transfer of results between the TUFLOW HPC and the TUFLOW FV domains.		* A TUFLOW CATCH JSON file was created to review the transfer of results between the TUFLOW HPC and the TUFLOW FV domains.
			* 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: Created page with "= Introduction = In this module, a TUFLOW CATCH hydrology model is developed.
TUFLOW CATCH Tutorial 03 is built from the model created in TUFLOW_CATCH_Tutorial_M02..."

2025-07-02T05:50:43Z

Created page with "= Introduction = In this module, a TUFLOW CATCH hydrology model is developed. TUFLOW CATCH Tutorial 03 is built from the model created in TUFLOW_CATCH_Tutorial_M02..."

New page

= Introduction =
In this module, a TUFLOW CATCH hydrology model is developed. 

TUFLOW CATCH Tutorial 03 is built from the model created in [[TUFLOW_CATCH_Tutorial_M02 | TUFLOW CATCH Tutorial 02]]. The completed TUFLOW CATCH Tutorial 02 is provided in the '''TUFLOW_CATCH_Module_03\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 Tutorial 01]] and [[TUFLOW_CATCH_Tutorial_M02 | TUFLOW CATCH Tutorial 02]] prior to starting this tutorial.

= GIS Inputs =
Create, import and view input data:
:*[[TUFLOW_CATCH_Tutorial_M03_TUFLOW_HPC_GIS_Inputs_QGIS | TC03 - TUFLOW HPC GIS Inputs]]
:*[[TUFLOW_CATCH_Tutorial_M03_TUFLOW_FV_GIS_Inputs_QGIS | TC03 - TUFLOW FV GIS Inputs]]

= 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 Boundary Control File (TBC) ===
<ol>
<li>Save a copy of '''TC01_001.tbc''' as '''TC03_001.tbc''' in the '''TUFLOW_CATCH_Module_03\Modelling\TUFLOW\model''' folder.
<li> Open the '''TC03_001.tbc''' in a text editor and update the reference to the 1D/2D culvert connections: 
<tt>Read GIS BC </tt> <tt>== </tt> <tt>gis\2d_bc_TC03_001_P.shp</tt> <tt> ! Links the two upstream 1D culverts to the 2D domain</tt> 
<tt>Read GIS BC </tt> <tt>== </tt> <tt>gis\2d_bc_TC03_001_L.shp</tt> <tt> ! Links the two upstream 1D culverts to the 2D domain</tt> 
<li>Save the TBC.
</ol>

=== TUFLOW ESTRY Control File (ECF) ===
<ol>
<li> Save a copy of '''TC01_001.ecf''' as '''TC03_001.ecf''' in the '''TUFLOW_CATCH_Module_03\Modelling\TUFLOW\model''' folder.
<li> Open the '''TC03_001.ecf''' in a text editor and update the following line to reference the new 1d_nwk layer (containing the two upstream culverts): 
<tt>Read GIS Network </tt> <tt>== </tt> <tt>gis\1d_nwk_TC03_001_L.shp</tt> <tt> ! Defines the two upstream culverts</tt>
<li>Save the ECF.
</ol>

== 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 ===
This block contains commands that construct the TUFLOW HPC simulation.
<ol>
<li> Save a copy of '''TC02_001.tcc''' as '''TC03_001.tcc''' in the '''TUFLOW_CATCH_Module_03\Modelling\TUFLOWCATCH\runs''' folder.
<li> Open '''TC03_001.tcc''' in a text editor, and update the following commands to reference the new TBC and ECF: 
<tt>BC Control File == ..\..\TUFLOW\model\TC03_001.tbc ! Reference the TUFLOW Boundary Conditions Control File</tt> 
<tt>ESTRY Control File == ..\..\TUFLOW\model\TC03_001.ecf ! Reference the ESTRY (1D) Control File</tt> 

<li> Remove or comment out the following command using a '<tt>!</tt>' symbol. The receiving polygon can only be used in the pollutant export configuration of TUFLOW CATCH. 
<tt>! Receiving Polygon == ..\..\TUFLOW\model\gis\2d_rp_TC01_001_R.shp ! GIS layer defining the receiving polygon</tt> 
</ol>

=== Pollutant Export Model ===
This block contains commands that control the pollutant export (and other constituent) simulation. As this tutorial model is a hydrology simulation, we must set the pollutant export model to 'None', and comment out all commands. The pollutant export model block should look similar to the below: 
:<tt>Catchment Pollutant Export Model == None</tt> 
::<tt>! Constant Salinity == 0.0</tt> 
::<tt>! Constant WQ_DISS_OXYGEN_MG_L == 8.0</tt> 
::<tt>! Time-Series Temperature == temp</tt> 
::<tt>! Material == ALL ! Default parameters for all materials</tt> 
:::<tt> ! SED_CLAY, Method == Shear1, Rate == 0.0, Limit == 100.0, Depth Threshold == 0.02, Deposition Stress == 0.1, Erosion Stress == 0.5, Deposition Velocity == 0.1, Erosion Rate == 0.05</tt> 
:::<tt> ! WQ_PATH_ECOLI_ALIVE_CFU_100ML, Method == Washoff1, Rate == 0.0, Limit == 0.0, Time Constant == 3600.00, Rain Threshold == 1.0, Depth Threshold == 0.20, Deposition Velocity == 0.0</tt> 
:::<tt> ! WQ_PATH_ECOLI_DEAD_CFU_100ML, Method == Washoff1, Rate == 0.0, Limit == 0.0, Time Constant == 3600.00, Rain Threshold == 1.0, Depth Threshold == 0.20, Deposition Velocity == 0.0</tt> 
::<tt>! End Material </tt> 
::<tt>! Other material specifications ...</tt> 
::<tt>! Read GIS Intervention == ..\..\TUFLOW\model\gis\2d_im_TC02_001_L.shp ! GIS layer defining interventions</tt> 
::<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> 
::<tt>! Other mass removal specifications ...</tt> 
:<tt>End Catchment Pollutant Export Model </tt> 

=== Receiving Model ===
This block contains commands that construct the TUFLOW FV simulation. These commands are almost entirely those that would be used in setting up a standalone TUFLOW FV control file (.fvc), with a small number of additional commands that relate to TUFLOW CATCH.
<ol>
<li> Set the receiving model: 
<tt>Receiving Model == TUFLOWFV </tt>

<li>Above the 'Hardware' section, add the following command. This command allows the simulation to proceed if minor timestepping mismatches occur in the boundary condition timeseries files (written by TUFLOW CATCH). 
<tt>Global Temporal Extrapolation Check == WARNING </tt> 

<li>In the 'Timestep Commands' section, update the following commands: 
<tt>CFL == 0.95 ! Specify the Courant–Friedrichs–Lewy (CFL) number</tt> 
<tt>Timestep Limits == 0.10,1.0 ! Specify the minimum and maximum timesteps (seconds)</tt> 
<tt>Display dt == 30 ! Interval of displaying timestep information to the log (seconds)</tt> 

<li>In the 'Model Parameters' section, update the following commands. All other commands in this section relate to 3D modelling, so they can be removed or ignored. 
<tt>Stability Limits == 100.0, 10.0 ! Specify maximum water level (meters) and velocity (m/s) which indicate an unstable model</tt> 
<tt>Momentum Mixing Model == Smagorinsky ! Specify the momentum mixing model</tt> 
<tt>Global Horizontal Eddy Viscosity == 0.2 ! Specify the Smagorinsky coefficient</tt> 
<tt>Global Horizontal Eddy Viscosity Limits == 0.05, 99999. ! Specify the minimum and maximum eddy viscosity (m2/s)</tt> 
<tt>Scalar Mixing Model == Smagorinsky ! Specify the scalar mixing model</tt> 
<tt>Global Horizontal Scalar Diffusivity == 0.2 ! Specify the Smagorinsky coefficient</tt> 
<tt>Global Horizontal Scalar Diffusivity Limits == 0.05, 99999. ! Globally sets the minimum and maximum horizontal scalar diffusivity limits</tt> 

<li>At the end of the 'Model Parameters' section, add the following command to set the cell wetting and drying depths: 
<tt>Cell Wet/Dry Depths == 5.0e-03, 5.0e-02 ! Specify the cell wetting and drying depths (meters)</tt> 

<li>In the '2D Geometry' section, update the following commands to reference the TUFLOW FV mesh and the model domain: 
<tt>Geometry 2D == ..\..\TUFLOWFV\model\geo\Stream_Mesh.2dm ! 2D geometry input file (mesh file)</tt> 
<tt>Read Grid Zpts == ..\..\TUFLOWFV\model\geo\DEM.asc ! Assigns the elevation of Zpts from the grid</tt> 

<li>In the 'Materials' section, update/add the following commands. They reference the TUFLOW FV materials GIS layer and specify the surface roughness or bed resistance values (e.g. Manning’s n) assigned to each material ID within the TUFLOW FV model domain. These are distinct materials from those specified in the catchment hydraulic model. 
<tt>Set Mat == 1 ! Sets the default material ID for all cells in the TUFLOW FV model domain</tt> 
<tt>Read GIS Mat == ..\..\TUFLOWFV\model\gis\2d_mat_TC03_FV_001_R.shp ! Sets the TUFLOW FV material values according to attributes in the GIS layer</tt> 
<tt>Material == 1 ! Defines properties for material ID 1</tt>
:<tt>Bottom Roughness == 0.011 ! Specify the Manning's roughness</tt> 
<tt>End Material</tt> 
<tt>Material == 2 ! Defines properties for material ID 2</tt> 
:<tt>Bottom Roughness == 0.015 ! Specify the Manning's roughness</tt> 
<tt>End Material</tt> 
<tt>Material == 3 ! Defines properties for material ID 3</tt> 
:<tt>Bottom Roughness == 0.017 ! Specify the Manning's roughness</tt> 
<tt>End Material</tt> 

<li>In the 'Initial Conditions' section, update the following command to set the initial water level: 
<tt>Initial Water Level == 35.0 ! Specify initial water level (meters)</tt> 

<li>In the 'Non-Catchment Boundaries' section, update the following commands to reference the downstream TUFLOW FV normal (friction slope) boundary and to define its boundary conditions. 
<tt>Read GIS Nodestring == ..\..\TUFLOWFV\model\gis\2d_ns_TC03_DS_boundary_001_L.shp ! GIS nodestring layer defining non-catchment boundary(ies)</tt> 
<tt>BC == QN, DS, 0.001 ! Defines BC type, BC name and friction slope</tt> 
<tt>End BC</tt> 

<li>In the 'Catchment Boundaries' section, update the following command to reference the upstream (inflow) TUFLOW FV boundary. TUFLOW CATCH uses this nodestring to automatically write boundaries that include momentum from catchment hydraulic model predictions. For more information, refer to [https://docs.tuflow.com/catch/manual/2025.1/SimulationConstruction-1.html#SCTCCFV-3 Section 4.5.4 of the TUFLOW CATCH Manual]. 
<tt>Catchment BC Nodestring == ..\..\TUFLOWFV\model\gis\2d_ns_TC03_US_boundary_001_L.shp ! GIS nodestring layer defining catchment boundary(ies) that include momentum</tt> 

<li>Above the 'Outputs' section, add the following commands to reference the downstream TUFLOW FV culvert and its parameters. 
<tt>Read GIS Nodestring == ..\..\TUFLOWFV\model\gis\2d_ns_TC03_culverts_001_L.shp ! GIS nodestring layer defining the downstream culvert</tt> 
<tt>Read GIS Nodestring == ..\..\TUFLOWFV\model\gis\2d_ns_TC03_weir_001_L.shp ! GIS nodestring layer enforcing the road crest at the downstream culvert</tt> 
<tt>Structure == Linked Nodestrings, FC01.2_R_US, FC01.2_R_DS ! Defines the structure type, culvert US nodestring ID, culvert DS nodestring ID</tt> 
:<tt>Flux Function == Culvert ! Culvert flux function </tt> 
:<tt>Culvert File == ..\..\TUFLOWFV\model\csv\TC03_culvert_dbase_001.csv, 1 ! Reference the culvert database and the number of culverts </tt>
<tt>End Structure</tt> 
<tt>Structure == Nodestring, FC01.2_W ! Defines the structure type and the nodestring ID</tt> 
:<tt>Flux Function == Weir_dz ! Weir_dz flux function </tt> 
:<tt>Properties == 0.1, 1.705 ! Defines the weir height above face elevation (meters) and the weir coefficient</tt>
<tt>End Structure</tt> 

<li>In the 'Outputs' section, update/add the following commands. Ensure that the 'Flux' block is removed or commented out. 
<tt>Output == NetCDF </tt> 
:<tt>Output Parameters == h, v, d ! Outputs water level, velocity and depth </tt> 
:<tt>Output Interval == 30 ! Interval to output the data (seconds) </tt> 
:<tt>Suffix == HD ! Specify suffix for the output NetCDF file </tt>
<tt>End Output</tt> 
<tt>Output == Mass </tt> 
:<tt>Output Interval == 30 ! Interval to output the data (seconds) </tt>
<tt>End Output</tt> 

<li>Remove or comment out the following commands: 
<tt>! Write Restart dt == 24</tt> 
<tt>! Restart Overwrite == 1 </tt> 

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

= Running the Simulation =
<ol>
<li>In Windows File Explorer, navigate to the '''TUFLOWCATCH\runs''' folder. Save a copy of '''_run_TC02_CATCH.bat''' as '''_run_TC03_CATCH.bat''' and open the file in a text editor.
<li>Update the batch file to reference the '''TC03_001.tcc''': 
<tt>set exe="..\..\..\..\exe\TUFLOWCATCH\2025.1.0\TUFLOWCATCH.exe"</tt> 
<tt>%exe% TC03_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 hydrology model simulation:
:*[[TUFLOW_CATCH_Tutorial_M03_Check_Files_QGIS | TC03 - Check Files]] 
:*[[TUFLOW_CATCH_Tutorial_M03_Results_QGIS | TC03 - Results]] 

=Reviewing Model Performance=
As discussed in [[TUFLOW_CATCH_Tutorial_M01#Reviewing_Model_Performance | TUFLOW CATCH Tutorial 01]], there are a number of useful outputs from TUFLOW CATCH for reviewing the model performance. 
In this tutorial, the receiving model was specified. As such, the TUFLOW FV Log File (.log) should be reviewed. The <tt>Log Folder == log</tt> command in the .tcc defines where the .log is written. 
Navigate to the '''Modelling\TUFLOWCATCH\runs\log''' folder and open the '''TC03_001_receiving.log''' file in a text editor.
* Scroll down to the bottom to 'Simulation Summary'. This includes information about the computation time and messages. If an error occurred (stopping the simulation), the error message will be output just above the 'Simulation Summary'.
* Review any check, warning or error messages.

'''Note:''' It is recommended to check all simulation log files at the end of each run. For this tutorial, the catchment hydraulic and receiving models were specified, so '''TC03_001.catchlog''', '''TC03_001_catchment_hydraulic.tlf''' and '''TC03_001_receiving.log''' should all be reviewed.

= Conclusion =
* A TUFLOW CATCH Hydrology model was created.
* A TUFLOW FV mesh was added to the stream and the downstream culvert was redefined in TUFLOW FV format.
* A TUFLOW CATCH JSON file was created to review the transfer of results between the TUFLOW HPC and the TUFLOW FV domains.
 
{{Tips Navigation
|uplink=[[TUFLOW_CATCH_Tutorial_Introduction| Back to Tutorial Introduction Main Page]]
}}

TUFLOW CATCH Tutorial M03 - Revision history

Emilie Nielsen: /* Running the Simulation */

Emilie Nielsen: /* Introduction */

Pavlina Monhartova: /* Conclusion */

Emilie Nielsen: Created page with "= Introduction = In this module, a TUFLOW CATCH hydrology model is developed. TUFLOW CATCH Tutorial 03 is built from the model created in TUFLOW_CATCH_Tutorial_M02..."

Emilie Nielsen: Created page with "= Introduction = In this module, a TUFLOW CATCH hydrology model is developed.
TUFLOW CATCH Tutorial 03 is built from the model created in TUFLOW_CATCH_Tutorial_M02..."