Introduction

About this manual

This document is the user manual for TUFLOW CATCH.

How to use this manual

Navigation

This manual is designed for digital use within any web browser and has the following features:

• Section headers, to level three, are directly navigable via the left hand pane’s table of contents. This table of contents pane can be toggled on and off from view via the “s” key if more or less page width is required
• The angled arrows that float at the left and right hand side midpoints of every page can be used to navigate sequentially back and forth to the commencement of preceding or subsequent top level sections
• Model commands, parameters and cross references for tables and figures are navigable through hyperlinks, where appropriate. This includes parameters within equations, which will also appear as blue hyperlinks when active
• The space bar can be used to scroll down within each page without skipping text. Shift + space bar will similarly scroll up
• Browser back and forward buttons (or their equivalent keyboard shortcuts alt + \(\langle\)left arrow\(\rangle\) and alt + \(\langle\)right arrow\(\rangle\), respectively) can be used to navigate through browsing history. Some browsers may not return to the precise scroll location in a page last visited, but to the last clicked section header. Hyperlinks have been built into the body of the manual, and these can be used in lieu of browser buttons if required

It is recommended that this manual be viewed in a browser window that is maximised or operating in full screen mode, with the latter (although browser dependent) typically toggled via the F11 key.

When following hyperlinks, the target (i.e. location on a webpage that is being navigated to) is displayed at the top of the landing page (the page navigated to). The exception to this occurs when a target is located near the bottom of the landing page’s content. In this case, it is not possible for a web browser to display the target at the top of a page because this would generate underlying white space, and as such, the target will appear in the main body (i.e. not at the top) of the landing page.

Searching

This entire manual’s content can be searched by using the search box at the top of the table of contents pane (i.e. screen top left to the right of the TUFLOW logo). This search box can be toggled on and off by clicking the search icon (magnifying glass) at the top left of any page.

The table of contents is dynamically filtered in response to entering text in the search box, and clicking on any remaining table of contents entry will navigate directly to the searched text. Searched text will be highlighted within a page for easy identification, and multiple instances within one page can be navigated through by using the up and down arrow keys. Clearing the search box will restore the table of contents.

Tables

Where appropriate, tables are searchable via use of the search box, which is located at the top right of any search enabled table. Not all tables are searchable. When text is entered into the search box, table rows are dynamically filtered to only show those that contain the search text. This allows on-the-fly condensing of large tables so that only relevant content is presented.

Tables can be sorted alphabetically (or reverse alphabetically) with respect to any column by clicking (and re-clicking) column headers. Where appropriate, the number of rows displayed is selectable via the Show entries drop down. Undisplayed rows can be accessed by clicking Previous or Next or by using the numbered navigation boxes, all of which are located at the bottom of each table.

Below is an washoff1 example of a searchable table. Type “erosion” (with or without the inverted commas) into the search box to see the table behaviour, or change the number of rows displayed and use the navigation buttons at the bottom of the table to look through all the data. The right hand “Links” column sometimes has hyperlinked words that allow navigation between related commands, or different versions of the same command, for ease of access if appropriate.

Command	Description	Links
Method ==  \(\langle\)washoff1,shear1\(\rangle\)	Used in a material block within a pollutant export model block to set the pollutant export model. Simulation construction section 4.5.3.3.	\(\text{ }\)
Depth Threshold ==  \(\langle\)\(d\)\(\rangle\)	Used in a material block within a pollutant export model block to set the minimum cell water depth at which pollutant export can occur. Applies to all pollutant export methods. Simulation construction section 4.5.3.3.	\(\text{ }\)
Limit ==  \(\langle\)\(L_{acc}\),\(L_{shr}\)\(\rangle\)	Used in a material block within a pollutant export model block to set an accumulation (washoff model) or erosion (shear model) limit. . Simulation construction section 4.5.3.3.	\(\text{ }\)
Rate ==  \(\langle\)\(R_a\)\(\rangle\)	Used in a material block within a pollutant export model block to set the rate at which a pollutant accumulates to its dry store. Applies only to accumulation pollutant export methods. It is not used for erosion pollutant export models. Simulation construction section 4.5.3.3.1.	\(\text{ }\)
Time Constant ==  \(\langle\)\(T_c\)\(\rangle\)	Used in a material block within a pollutant export model block to control the rate at which a pollutant is released from its dry store. Applies only to accumulation pollutant export methods. It is not used for erosion pollutant export models. Simulation construction section 4.5.3.3.1.	\(\text{ }\)
Rain Threshold ==  \(\langle\)\(R_r\)\(\rangle\)	Used in a material block within a pollutant export model block to set the minimum rainrate threshold at which a pollutant is released from its dry store. Pollutant export is suppressed below this rate. Applies only to accumulation pollutant export methods. It is not used for erosion pollutant export models. Simulation construction section 4.5.3.3.1.	\(\text{ }\)
Deposition Stress ==  \(\langle\)\(\tau_{cd}\)\(\rangle\)	Used in a material block within a pollutant export model block to set the maximum bed shear stress that allows for deposition to occur. This deposition represents a transfer from a pollutant’s wet to dry store. Deposition will not occur at shear stresses above this value. Applies only to shear stress pollutant export methods. It is not used for accumulation washoff pollutant export models. Simulation construction section 4.5.3.3.2.	\(\text{ }\)
Erosion Stress ==  \(\langle\)\(\tau_{ce}\)\(\rangle\)	Used in a material block within a pollutant export model block to set the minimum bed shear stress that allows for erosion to occur. This erosion represents a transfer from a pollutant’s dry to wet store. Erosion will not occur at shear stresses below this value. Applies only to shear stress pollutant export methods. It is not used for accumulation washoff pollutant export models. Simulation construction section 4.5.3.3.2.	\(\text{ }\)
Deposition Velocity ==  \(\langle\)\(w_s\)\(\rangle\)	Used in a material block within a pollutant export model block to set the settling velocity of a pollutant. This settling represents a transfer from a pollutant’s wet to dry store. Settling occurs at all times in the accumulation washoff pollutant export model. Settling only occurs once bed shear stress drops below the user specified value in the shear stress pollutant export model. Simulation construction section 4.5.3.3.	\(\text{ }\)
Erosion Rate ==  \(\langle\)\(E_r\)\(\rangle\)	Used in a material block within a pollutant export model block to set the erosion rate of a pollutant. This erosion represents a transfer from a pollutant’s dry to wet store. Erosion only occurs once bed shear stress increases above the user specified value. Erosion will not occur at shear stresses below this value. Applies only to shear stress pollutant export methods. It is not used for accumulation washoff pollutant export models. Simulation construction section 4.5.3.3.2.	\(\text{ }\)
Hardware ==  \(\langle\)GPU,CPU\(\rangle\)	Used in the General commands section of a TUFLOW CATCH control file to set the simulation hardware. This command can be overwritten in the catchment hydraulic model or receiving model blocks if needed. Simulation construction section 4.5.1.	\(\text{ }\)
GIS Format ==  \(\langle\)SHP,GPKG,MI\(\rangle\)	Used in the General commands section of a TUFLOW CATCH control file to set the GIS format of the simulation. This command can be overwritten in the catchment hydraulic model or receiving model blocks if needed. Simulation construction section 4.5.1.	\(\text{ }\)
SHP Projection ==  \(\langle\)\(\rangle\)	Used in the General commands section of a TUFLOW CATCH control file to set the path to the SHP file containing the TUFLOW CATCH model projection. Simulation construction section 4.5.1.	\(\text{ }\)
Time Format ==  \(\langle\)ISODATE,hours\(\rangle\)	Used in the General commands section of a TUFLOW CATCH control file to set the simulation date format. It is strongly recommended that ISODATE (dd/mm/yyyy hh:mm:ss) be deployed rather than hours. Simulation construction section 4.5.1.	\(\text{ }\)
Start Time ==  \(\langle\)\(\rangle\)	Used in the General commands section of a TUFLOW CATCH control file to set the simulation start date in the format declared by Date Format ==. It is strongly recommended that ISODATE (dd/mm/yyyy hh:mm:ss) be deployed rather than hours. Simulation construction section 4.5.1.	\(\text{ }\)
End Time ==  \(\langle\)\(\rangle\)	Used in the General commands section of a TUFLOW CATCH control file to set the simulation start date in the format declared by Date Format ==. It is strongly recommended that ISODATE (dd/mm/yyyy hh:mm:ss) be deployed rather than hours. Simulation construction section 4.5.1.	\(\text{ }\)

Colour coding is often used for distinguishing different tabulated data types. In the above example, TUFLOW CATCH commands are pink and the associated argument options for each command are blue and contained in angled parentheses. Clicking on these arguments will navigate to related content. Colour coding applied to other table types is explained throughout this manual when required.

Commands

Where specific commands are described, they appear in highlighted text, and often as a clickable link to the corresponding command description in Appendix A. That Appendix is a searchable table of all commands, as per the demonstration table presented in this introduction. The below is an example of a TUFLOW CATCH command. \(\newcommand{\blockindent}{\hspace{0.5cm}}\)

Catch BC Output Folder ==

Where commands specify parameters (e.g. erosion rates etc.) then for consistency and brevity, these parameters are included directly in the command example using their notation (see following section that describes notation) rather than descriptive words. These notated parameters are also often a clickable link to descriptive explanations in Appendix B. The link below is an example of a TUFLOW CATCH command with a parameter presented in notation form.

CSV Write Frequency Day ==\(dT_{csv}\)

Parameter notation

The primary groups of parameters are listed below, with the letter or symbol used to denote each. Typical generalisations of units are parenthesised.

• Time steps, \(dT\) (seconds or days)
• Rates, \(R\) (mass per unit area per unit time, or rain rate)
• Limits, \(L\) (mass per unit area)
• Concentrations, \(C\) (mass per unit volume)
• Time constants, \(T\) (seconds)
• Water depths, \(d\) (metres)
• Shear, \(\tau\) (Newtons per square metre)
• Velocities, \(w\) (metres per second)
• Erosion rates, \(E\) (grams per metres squared per second)

Feedback

Constructive suggestions to improve this manual are welcome, and can be emailed to support@tuflow.com.