Tutorial Module08 Archive - Revision history

Anne.Kolega: /* Review Model Health */ e.g.

2026-04-01T22:22:00Z

Review Model Health: e.g.

← Older revision		Revision as of 08:22, 2 April 2026
Line 119:		Line 119:
	<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>		<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>
	<br>		<br>
	As with all checks, warnings and errors, further information can be found on the [[TUFLOW_Messages \| TUFLOW Message Database]]. More information on this message specifically can be found [https://wiki.tuflow.com/index.php?title=TUFLOW_Message_2317 here]. The Cell Wet/Dry Depth command specifies the depth at the cell in which TUFLOW transitions from wet to dry and vice versa. The depth should be selected according to the magnitude of flooding depths. As direct rainfall models typically have a high proportion of shallow sheet flow, a wet/dry depth of less than 1mm (eg. 0.0002m) may be required.<br><br>		As with all checks, warnings and errors, further information can be found on the [[TUFLOW_Messages \| TUFLOW Message Database]]. More information on this message specifically can be found [https://wiki.tuflow.com/index.php?title=TUFLOW_Message_2317 here]. The Cell Wet/Dry Depth command specifies the depth at the cell in which TUFLOW transitions from wet to dry and vice versa. The depth should be selected according to the magnitude of flooding depths. As direct rainfall models typically have a high proportion of shallow sheet flow, a wet/dry depth of less than 1mm (e.g. 0.0002m) may be required.<br><br>

	<ol>		<ol>

Emilie Nielsen: /* Troubleshooting */

2025-02-20T06:31:49Z

Troubleshooting

← Older revision		Revision as of 16:31, 20 February 2025
Line 218:		Line 218:
	=Troubleshooting=		=Troubleshooting=
	If the TUFLOW simulation fails to start TUFLOW will output the error in a number of locations. Firstly, check the Console Window or the TUFLOW Log File (.tlf) (located in the '''TUFLOW\runs\log\''' folder). This file can be opened in a text editor and the error is generally located at the end of the file. You can however search for "Error" if you cannot see the error. In most cases there is also a spatial location for the error message (if the error reported in the log file is prefixed by XY:). To check the location of the geographic errors, open the '''_messages.mif''' or '''_messages_P.shp''' file in your GIS package.		If the TUFLOW simulation fails to start TUFLOW will output the error in a number of locations. Firstly, check the Console Window or the TUFLOW Log File (.tlf) (located in the '''TUFLOW\runs\log\''' folder). This file can be opened in a text editor and the error is generally located at the end of the file. You can however search for "Error" if you cannot see the error. In most cases there is also a spatial location for the error message (if the error reported in the log file is prefixed by XY:). To check the location of the geographic errors, open the '''_messages.mif''' or '''_messages_P.shp''' file in your GIS package.
	This section contains links to some possible problems that may occur when progressing through the fourth tutorial module. If you experience an issue that is not detailed, please email ~~<font~~ ~~color="blue"><u>~~support@tuflow.com~~</u></font> or add and describe the problem on the discussion page~~. <br>		This section contains links to some possible problems that may occur when progressing through the fourth tutorial module. If you experience an issue that is not detailed, please email [mailto:support@tuflow.com support@tuflow.com]. <br>

	If you receive the following error when trying to run the TUFLOW HPC model using GPU hardware:		If you receive the following error when trying to run the TUFLOW HPC model using GPU hardware:

Pavlina Monhartova at 01:51, 22 January 2025

2025-01-22T01:51:44Z

← Older revision		Revision as of 11:51, 22 January 2025
Line 119:		Line 119:
	<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>		<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>
	<br>		<br>
	As with all checks, warnings and errors, further information can be found on the [[~~TUFLOW_Message_How_To~~ \| TUFLOW Message Database]]. More information on this message specifically can be found [https://wiki.tuflow.com/index.php?title=TUFLOW_Message_2317 here]. The Cell Wet/Dry Depth command specifies the depth at the cell in which TUFLOW transitions from wet to dry and vice versa. The depth should be selected according to the magnitude of flooding depths. As direct rainfall models typically have a high proportion of shallow sheet flow, a wet/dry depth of less than 1mm (eg. 0.0002m) may be required.<br><br>		As with all checks, warnings and errors, further information can be found on the [[TUFLOW_Messages \| TUFLOW Message Database]]. More information on this message specifically can be found [https://wiki.tuflow.com/index.php?title=TUFLOW_Message_2317 here]. The Cell Wet/Dry Depth command specifies the depth at the cell in which TUFLOW transitions from wet to dry and vice versa. The depth should be selected according to the magnitude of flooding depths. As direct rainfall models typically have a high proportion of shallow sheet flow, a wet/dry depth of less than 1mm (eg. 0.0002m) may be required.<br><br>

	<ol>		<ol>

Abigail.lillo: /* HPC Solver (Optional) */

2024-10-10T01:38:28Z

HPC Solver (Optional)

← Older revision		Revision as of 11:38, 10 October 2024
Line 179:		Line 179:
	In this optional section we will run the model using TUFLOW HPC (Heavily Parallelised Compute). TUFLOW HPC can run between 10 and 100 times faster than TUFLOW Classic using NVidia Graphics Processing Units (GPU)(depending on the model configuration and hardware performance). The speed of HPC makes it exceptionally well suited to high resolution direct rainfall urban applications. Large models with over 1,000,000 2D cells that take days to run using TUFLOW Classic can take hours to complete using TUFLOW HPC with high performance GPU hardware! The presentation "Rapid and Accurate Stormwater Drainage Assessments Using GPU Technology" highlights some performance test results comparing TUFLOW Classic against TUFLOW HPC for high resolution direct rainfall urban 1D/2D applications. A pdf copy of the presentation is available from the [https://www.tuflow.com/Download/Presentations/2017/Huxley2017_IECA-SQ%20Conference_Brisbane_pdf.pdf TUFLOW Library]<br><br>		In this optional section we will run the model using TUFLOW HPC (Heavily Parallelised Compute). TUFLOW HPC can run between 10 and 100 times faster than TUFLOW Classic using NVidia Graphics Processing Units (GPU)(depending on the model configuration and hardware performance). The speed of HPC makes it exceptionally well suited to high resolution direct rainfall urban applications. Large models with over 1,000,000 2D cells that take days to run using TUFLOW Classic can take hours to complete using TUFLOW HPC with high performance GPU hardware! The presentation "Rapid and Accurate Stormwater Drainage Assessments Using GPU Technology" highlights some performance test results comparing TUFLOW Classic against TUFLOW HPC for high resolution direct rainfall urban 1D/2D applications. A pdf copy of the presentation is available from the [https://www.tuflow.com/Download/Presentations/2017/Huxley2017_IECA-SQ%20Conference_Brisbane_pdf.pdf TUFLOW Library]<br><br>

	''Note: If you have not previously used TUFLOW HPC, we recommend completing Tutorial Module 1, 2 and 3 before attempting this tutorial. The preceding tutorials include important lessons specific to using HPC, particularly its adaptive timestep / unconditional stability and GPU Hardware.<br><br>		''Note: If you have not previously used TUFLOW HPC, we recommend completing Tutorial Module 1, 2 and 3 before attempting this tutorial. The preceding tutorials include important lessons specific to using HPC, particularly its adaptive timestep / unconditional stability and GPU Hardware. Please see [[HPC_Features_Archive \| HPC Features Archive]] for more information on TUFLOW HPC features supported in the 2017 release.<br><br>

	In order to use the HPC solver, we will need to perform the following steps:		In order to use the HPC solver, we will need to perform the following steps:

Emilie Nielsen at 03:18, 5 April 2024

2024-04-05T03:18:12Z

← Older revision		Revision as of 13:18, 5 April 2024
Line 155:		Line 155:

	=View the Results=		=View the Results=
	Open the 2D results in your preferred results viewer or import to your GIS package. For more information on how to do this, refer to [~~https://wiki.tuflow.com/index.php?title=~~Tutorial_Module01_Archive#Viewing_Results~~%7C~~ ~~Tutorial~~ Module 1]<br>		Open the 2D results in your preferred results viewer or import to your GIS package. For more information on how to do this, refer to <u>[[Tutorial_Module01_Archive#Viewing_Results \| Module 1]]</u>.<br>

	This module has applied the rainfall boundary to every active 2D cell. To aid visualisation of the results, an appropriate cut-off depth is typically used to only display the results above the specified depth. The depth chosen differentiates between shallow, sheet flow and depths classed as 'flooded'. The cut-off can be specified directly in the tcf or through post-processing of the results. 0.1m is commonly used as the cutoff depth value. The TCF command for TUFLOW to do this is:<br>		This module has applied the rainfall boundary to every active 2D cell. To aid visualisation of the results, an appropriate cut-off depth is typically used to only display the results above the specified depth. The depth chosen differentiates between shallow, sheet flow and depths classed as 'flooded'. The cut-off can be specified directly in the tcf or through post-processing of the results. 0.1m is commonly used as the cutoff depth value. The TCF command for TUFLOW to do this is:<br>

Emilie Nielsen: /* Run Simulation */

2024-04-05T03:16:33Z

Run Simulation

← Older revision		Revision as of 13:16, 5 April 2024
Line 77:		Line 77:
	=Run Simulation=		=Run Simulation=

	Using your preferred method for starting TUFLOW, run the newly created '''M08_5m_~s1~_001.tcf'''. Please refer to [[Tutorial_Module01_Archive#~~Running_TUFLOW~~ \| Module 1]] for a detailed description of the various methods for running a TUFLOW simulation.<br>		Using your preferred method for starting TUFLOW, run the newly created '''M08_5m_~s1~_001.tcf'''. Please refer to <u>[[Tutorial_Module01_Archive#Run_Simulation \| Module 1]]</u> for a detailed description of the various methods for running a TUFLOW simulation.<br>
	In this tutorial we are using a batch file to run simulations. The command line in our batch file will be similar to that used in Module 7:<br>		In this tutorial we are using a batch file to run simulations. The command line in our batch file will be similar to that used in Module 7:<br>
	{\| class="wikitable "		{\| class="wikitable "

Melissa.Moghanloo: Update link to https

2023-10-16T23:51:16Z

Update link to https

← Older revision		Revision as of 09:51, 17 October 2023
Line 119:		Line 119:
	<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>		<tt>“WARNING 2317 - For direct rainfall models set "Cell Wet/Dry Depth == 0.0002" if CME exceeds 1%.”</tt><br>
	<br>		<br>
	As with all checks, warnings and errors, further information can be found on the [[TUFLOW_Message_How_To \| TUFLOW Message Database]]. More information on this message specifically can be found [~~http~~://wiki.tuflow.com/index.php?title=TUFLOW_Message_2317 here]. The Cell Wet/Dry Depth command specifies the depth at the cell in which TUFLOW transitions from wet to dry and vice versa. The depth should be selected according to the magnitude of flooding depths. As direct rainfall models typically have a high proportion of shallow sheet flow, a wet/dry depth of less than 1mm (eg. 0.0002m) may be required.<br><br>		As with all checks, warnings and errors, further information can be found on the [[TUFLOW_Message_How_To \| TUFLOW Message Database]]. More information on this message specifically can be found [https://wiki.tuflow.com/index.php?title=TUFLOW_Message_2317 here]. The Cell Wet/Dry Depth command specifies the depth at the cell in which TUFLOW transitions from wet to dry and vice versa. The depth should be selected according to the magnitude of flooding depths. As direct rainfall models typically have a high proportion of shallow sheet flow, a wet/dry depth of less than 1mm (eg. 0.0002m) may be required.<br><br>

	<ol>		<ol>

Melissa.Moghanloo: /* View the Results */ Update link to https

2023-10-03T22:56:32Z

View the Results: Update link to https

Melissa.Moghanloo: /* View the Results */ Update link to https

2023-10-03T22:55:57Z

View the Results: Update link to https

← Older revision		Revision as of 08:55, 4 October 2023
Line 161:		Line 161:
	[[File:M08_D_max.PNG\|400px]]		[[File:M08_D_max.PNG\|400px]]
	<br>		<br>
	To post process the gridded results with a cut-off depth, the [~~http~~://wiki.tuflow.com/index.php?title=ASC_to_ASC#Cutoff_Depth asc_to_asc utility] may be used.<br>		To post process the gridded results with a cut-off depth, the [https://wiki.tuflow.com/index.php?title=ASC_to_ASC#Cutoff_Depth asc_to_asc utility] may be used.<br>
	<br>		<br>
	Visualising the velocity vectors in direct rainfall models provides a means to investigate flow paths and their behaviour. Note in the below image that a cut-off depth has been applied to the depth grid, but not the velocity vectors, thus the velocity and direction of shallow sheet flow can still be seen.<br>		Visualising the velocity vectors in direct rainfall models provides a means to investigate flow paths and their behaviour. Note in the below image that a cut-off depth has been applied to the depth grid, but not the velocity vectors, thus the velocity and direction of shallow sheet flow can still be seen.<br>

ElizaCollison at 00:48, 9 January 2023

2023-01-09T00:48:15Z

← Older revision		Revision as of 10:48, 9 January 2023
Line 16:		Line 16:
	==Direct Rainfall==		==Direct Rainfall==
	This part of the tutorial will demonstrate how to apply direct rainfall to a model. We will also create a new boundary conditions database to reference the hyetograph. Follow the instructions below for your preferred GIS package.		This part of the tutorial will demonstrate how to apply direct rainfall to a model. We will also create a new boundary conditions database to reference the hyetograph. Follow the instructions below for your preferred GIS package.
	* [[~~Tute_M08_ARC_Rainfall~~ \| ArcGIS]]		* [[Tute_M08_ARC_Rainfall_Archive \| ArcGIS]]
	* [[~~Tute_M08_MI_Rainfall~~ \| MapInfo]]		* [[Tute_M08_MI_Rainfall_Archive \| MapInfo]]
	* [[~~Tute_M08_QGIS_Rainfall~~ \| QGIS]]		* [[Tute_M08_QGIS_Rainfall_Archive \| QGIS]]

	==Depth Varying Roughness and Rainfall Losses==		==Depth Varying Roughness and Rainfall Losses==

← Older revision		Revision as of 08:56, 4 October 2023
Line 81:		Line 81:
	{\| class="wikitable "		{\| class="wikitable "
	\|-		\|-
	\|		\|
	<tt>set TUFLOWEXE_iSP~~</font>~~=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iSP_w64.exe		<tt>set TUFLOWEXE_iSP=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iSP_w64.exe
	set RUN_iSP=start "TUFLOW" /wait "%TUFLOWEXE_iSP%" -b<br>		set RUN_iSP=start "TUFLOW" /wait "%TUFLOWEXE_iSP%" -bb<br>

	%RUN% -s1 EXG M08_5m_~s1~_001.tcf</tt>		%RUN% -s1 EXG M08_5m_~s1~_001.tcf</tt>
	\|}		\|}
Line 139:		Line 140:
	\|-		\|-
	\|		\|
	<tt>set TUFLOWEXE_iSP~~</font>~~=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iSP_w64.exe		<tt>set TUFLOWEXE_iSP=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iSP_w64.exe
	<font color="red">set TUFLOWEXE_iDP=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iDP_w64.exe</font><br>		<font color="red">set TUFLOWEXE_iDP=C:\TUFLOW\Releases\2017-09-AC\w64\TUFLOW_iDP_w64.exe</font><br>

	set RUN_iSP=start "TUFLOW" /wait "%TUFLOWEXE_iSP%" -b		set RUN_iSP=start "TUFLOW" /wait "%TUFLOWEXE_iSP%" -b
	<font color="red">set RUN_iDP=start "TUFLOW" /wait "%TUFLOWEXE_iDP%" -b</font><br>		<font color="red">set RUN_iDP=start "TUFLOW" /wait "%TUFLOWEXE_iDP%" -b</font><br>

	<font color="red">%RUN_iDP%</font> -s1 EXG <font color="red"> M08_5m_~s1~_002.tcf </font>		<font color="red">%RUN_iDP%</font> -s1 EXG <font color="red"> M08_5m_~s1~_002.tcf </font>
	<font color="red">%RUN_iDP% -s1 DEV M08_5m_~s1~_002.tcf</font></tt>		<font color="red">%RUN_iDP% -s1 DEV M08_5m_~s1~_002.tcf</font></tt>
	\|}		\|}
	<li> Save the .tcf and batch files and re-run the model.		<li> Save the .tcf and batch files and re-run the model.
Line 152:		Line 155:

	=View the Results=		=View the Results=
	Open the 2D results in your preferred results viewer or import to your GIS package. For more information on how to do this, refer to [~~http~~://wiki.tuflow.com/index.php?title=Tutorial_Module01_Archive#Viewing_Results\| Tutorial Module 1]<br>		Open the 2D results in your preferred results viewer or import to your GIS package. For more information on how to do this, refer to [https://wiki.tuflow.com/index.php?title=Tutorial_Module01_Archive#Viewing_Results%7C Tutorial Module 1]<br>

	This module has applied the rainfall boundary to every active 2D cell. To aid visualisation of the results, an appropriate cut-off depth is typically used to only display the results above the specified depth. The depth chosen differentiates between shallow, sheet flow and depths classed as 'flooded'. The cut-off can be specified directly in the tcf or through post-processing of the results. 0.1m is commonly used as the cutoff depth value. The TCF command for TUFLOW to do this is:<br>		This module has applied the rainfall boundary to every active 2D cell. To aid visualisation of the results, an appropriate cut-off depth is typically used to only display the results above the specified depth. The depth chosen differentiates between shallow, sheet flow and depths classed as 'flooded'. The cut-off can be specified directly in the tcf or through post-processing of the results. 0.1m is commonly used as the cutoff depth value. The TCF command for TUFLOW to do this is:<br>