TUFLOW SWMM Troubleshooting - Revision history

Emilie Nielsen: /* Simulation Console Window Flashes and Disappears */

2026-03-30T02:41:38Z

Simulation Console Window Flashes and Disappears

← Older revision		Revision as of 12:41, 30 March 2026
Line 119:		Line 119:
	<li>Double click the executable, this performs a licence check and console window appears. If it doesn't, move the executable to a location where it is permitted to run. Some locations on C drive might be restricted for some users preventing to execute the simulation.		<li>Double click the executable, this performs a licence check and console window appears. If it doesn't, move the executable to a location where it is permitted to run. Some locations on C drive might be restricted for some users preventing to execute the simulation.
	<li>TUFLOW doesn't run from a batch file if the filepaths are specified as UNC paths. The folder with both, the executable and the model, must be opened with a mapped drive. Type "net use <drive>: \\server_name\share_name" in the command line to map the drives.		<li>TUFLOW doesn't run from a batch file if the filepaths are specified as UNC paths. The folder with both, the executable and the model, must be opened with a mapped drive. Type "net use <drive>: \\server_name\share_name" in the command line to map the drives.
	<li>If using environment variable 'set exe', confirm there are no spaces surrounding the equals sign (e.g. <font color="blue"><tt>set </font>exe<font color="red>=</font>"..\..\..\exe\~~2023-03-AA~~\TUFLOW_iSP_w64.exe"</tt>).		<li>If using environment variable 'set exe', confirm there are no spaces surrounding the equals sign (e.g. <font color="blue"><tt>set </font>exe<font color="red>=</font>"..\..\..\exe\2026.0.0\TUFLOW_iSP_w64.exe"</tt>).
	<li>Write '<font color="blue><tt>pause</tt></font>' at the end of the script, rerun the batch file and the console window should remain open providing more information. In the below example, the file path to the TUFLOW exe is incorrect:<br>		<li>Write '<font color="blue><tt>pause</tt></font>' at the end of the script, rerun the batch file and the console window should remain open providing more information. In the below example, the file path to the TUFLOW exe is incorrect:<br>
	<br>		<br>

Pavlina Monhartova at 05:36, 18 April 2025

2025-04-18T05:36:07Z

← Older revision		Revision as of 15:36, 18 April 2025
Line 82:		Line 82:

	===TCF does not exist===		===TCF does not exist===
	Typos or spaces in the TCF name result in a 'does not exist' message in the ~~DOS~~ window:		Typos or spaces in the TCF name result in a 'does not exist' message in the console window:
	<ol>		<ol>
	<li>Check the name of the TCF is referenced correctly in the batch file.		<li>Check the name of the TCF is referenced correctly in the batch file.
Line 113:		Line 113:
	=Troubleshooting Steps=		=Troubleshooting Steps=
	== Model won't run ==		== Model won't run ==
	=== Simulation ~~DOS~~ Window Flashes and Disappears ===		=== Simulation Console Window Flashes and Disappears ===
	When batch file is double clicked and the simulation ~~DOS~~ window flashes and disappears the problem might be in the filepath of the TUFLOW executable or incorrect syntax:		When batch file is double clicked and the simulation console window flashes and disappears the problem might be in the filepath of the TUFLOW executable or incorrect syntax:
	<ol>		<ol>
	<li>Check the TUFLOW executable can be found with the specified filepath (absolute or relative).		<li>Check the TUFLOW executable can be found with the specified filepath (absolute or relative).
	<li>Double click the executable, this performs a licence check and ~~DOS~~ window appears. If it doesn't, move the executable to a location where it is permitted to run. Some locations on C drive might be restricted for some users preventing to execute the simulation.		<li>Double click the executable, this performs a licence check and console window appears. If it doesn't, move the executable to a location where it is permitted to run. Some locations on C drive might be restricted for some users preventing to execute the simulation.
	<li>TUFLOW doesn't run from a batch file if the filepaths are specified as UNC paths. The folder with both, the executable and the model, must be opened with a mapped drive. Type "net use <drive>: \\server_name\share_name" in the command line to map the drives.		<li>TUFLOW doesn't run from a batch file if the filepaths are specified as UNC paths. The folder with both, the executable and the model, must be opened with a mapped drive. Type "net use <drive>: \\server_name\share_name" in the command line to map the drives.
	<li>If using environment variable 'set exe', confirm there are no spaces surrounding the equals sign (e.g. <font color="blue"><tt>set </font>exe<font color="red>=</font>"..\..\..\exe\2023-03-AA\TUFLOW_iSP_w64.exe"</tt>).		<li>If using environment variable 'set exe', confirm there are no spaces surrounding the equals sign (e.g. <font color="blue"><tt>set </font>exe<font color="red>=</font>"..\..\..\exe\2023-03-AA\TUFLOW_iSP_w64.exe"</tt>).
	<li>Write '<font color="blue><tt>pause</tt></font>' at the end of the script, rerun the batch file and the ~~DOS~~ window should remain open providing more information. In the below example, the file path to the TUFLOW exe is incorrect:<br>		<li>Write '<font color="blue><tt>pause</tt></font>' at the end of the script, rerun the batch file and the console window should remain open providing more information. In the below example, the file path to the TUFLOW exe is incorrect:<br>
	<br>		<br>
	{{Video\|name=Animation_SWMM_Troubleshooting_Steps_01a.mp4\|width=1218}}<br>		{{Video\|name=Animation_SWMM_Troubleshooting_Steps_01a.mp4\|width=1218}}<br>
Line 130:		Line 130:
	<li>Navigate to the '''TUFLOW\runs''' folder and open the '''_ TUFLOW Simulations.log''' in a text editor.		<li>Navigate to the '''TUFLOW\runs''' folder and open the '''_ TUFLOW Simulations.log''' in a text editor.
	<li>Confirm if the simulation has 'Started' and 'Finished' line.		<li>Confirm if the simulation has 'Started' and 'Finished' line.
	<li>If there is no log file, see the '''Simulation ~~DOS~~ Window Flashes and Disappears''' advice above.<br>		<li>If there is no log file, see the '''Simulation Console Window Flashes and Disappears''' advice above.<br>
	<br>		<br>
	</ol>		</ol>

Emilie Nielsen at 00:27, 23 September 2024

2024-09-23T00:27:59Z

← Older revision		Revision as of 10:27, 23 September 2024
Line 99:		Line 99:

	===Ambiguous Command===		===Ambiguous Command===
	TUFLOW control files are command driven text files. The commands must be in the format and location TUFLOW is expecting. The <u>[https://~~downloads~~.tuflow.com/~~TUFLOW~~/~~Releases~~/~~Latest~~/~~TUFLOW%20Manual.pdf~~ TUFLOW Manual]</u> and the <u>[https://docs.tuflow.com/classic-hpc/release/latest/ TUFLOW Release Notes]</u> list all the available commands and specify which TUFLOW control file each command belongs to.<br>		TUFLOW control files are command driven text files. The commands must be in the format and location TUFLOW is expecting. The <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u> and the <u>[https://docs.tuflow.com/classic-hpc/release/latest/ TUFLOW Release Notes]</u> list all the available commands and specify which TUFLOW control file each command belongs to.<br>
	<ol>		<ol>
	<li>Example of a typo in the ' <font color="blue"><tt>BC Control File</font><font color="red"> ==</tt></font> ' command: <br>		<li>Example of a typo in the ' <font color="blue"><tt>BC Control File</font><font color="red"> ==</tt></font> ' command: <br>

Anne.Kolega: /* Spelling Mistakes in Control Files */ correct spelling be instead of by

2024-08-05T05:48:01Z

Spelling Mistakes in Control Files: correct spelling be instead of by

← Older revision		Revision as of 15:48, 5 August 2024
Line 58:		Line 58:
	To fix the reference:		To fix the reference:
	<ol>		<ol>
	<li>In this example, the file that cannot by found is '''TS01_01.tbc'''. Go to the folder where the file should be ('''TUFLOW\model''' folder).		<li>In this example, the file that cannot be found is '''TS01_01.tbc'''. Go to the folder where the file should be ('''TUFLOW\model''' folder).
	<li>The file referenced should be '''TS01_<font color="red">001</font>.tbc'''.		<li>The file referenced should be '''TS01_<font color="red">001</font>.tbc'''.
	<li>Update the reference in the TCF and confirm the file can now be found by right clicking on the file and selecting open. <br>		<li>Update the reference in the TCF and confirm the file can now be found by right clicking on the file and selecting open. <br>

Emilie Nielsen: /* Conclusion */

2024-08-04T23:21:55Z

Conclusion

← Older revision		Revision as of 09:21, 5 August 2024
Line 221:		Line 221:

	=Conclusion=		=Conclusion=
	If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].~~<br>~~<br>		If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].<br>

	TUFLOW SWMM Tutorial Models:		TUFLOW SWMM Tutorial Models:

Emilie Nielsen: /* Conclusion */

2024-08-04T23:21:36Z

Conclusion

← Older revision		Revision as of 09:21, 5 August 2024
Line 223:		Line 223:
	If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].<br><br>		If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].<br><br>

			TUFLOW SWMM Tutorial Models:
	*<u>[[TUFLOW_SWMM_Tutorial_M01 \| TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts		*<u>[[TUFLOW_SWMM_Tutorial_M01 \| TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts
	*<u>[[TUFLOW_SWMM_Tutorial_M02 \| TUFLOW SWMM Module 2]]</u> - 1D SWMM Pipe Network / 2D TUFLOW Direct Rainfall Hydrology		*<u>[[TUFLOW_SWMM_Tutorial_M02 \| TUFLOW SWMM Module 2]]</u> - 1D SWMM Pipe Network / 2D TUFLOW Direct Rainfall Hydrology

Emilie Nielsen at 23:58, 29 July 2024

2024-07-29T23:58:00Z

Show changes

Chris Huxley: /* Conclusion */

2024-02-16T04:40:29Z

Conclusion

← Older revision		Revision as of 14:40, 16 February 2024
Line 170:		Line 170:

	=Conclusion=		=Conclusion=
	If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].<br>		If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].<br><br>

	Click on the relevant link below to return to your tutorial:		Click on the relevant link below to return to your tutorial:

Chris Huxley: /* Conclusion */

2024-02-16T04:40:20Z

Conclusion

← Older revision		Revision as of 14:40, 16 February 2024
Line 170:		Line 170:

	=Conclusion=		=Conclusion=
	If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].		If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].<br>

	Click on the relevant link below to return to your tutorial:		Click on the relevant link below to return to your tutorial:

Chris Huxley: /* Conclusion */

2024-02-16T04:39:52Z

Conclusion

← Older revision		Revision as of 14:39, 16 February 2024
Line 172:		Line 172:
	If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].		If the above tips do not assist in fixing the error, email [mailto:support@tuflow.com support@tuflow.com].

			Click on the relevant link below to return to your tutorial:
	<br>
			*<u>[[TUFLOW_SWMM_Tutorial_M01 \| TUFLOW SWMM Module 1]]</u> - 1D SWMM Culverts

			*<u>[[TUFLOW_SWMM_Tutorial_M02 \| TUFLOW SWMM Module 2]]</u> - 1D SWMM Pipe Network / 2D TUFLOW Direct Rainfall Hydrology
	{{Tips Navigation
			*<u>[[TUFLOW_SWMM_Tutorial_M03 \| TUFLOW SWMM Module 3]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology
	\|uplink=[[TUFLOW_SWMM_Tutorial_Introduction\| Back to TUFLOW SWMM Tutorial Introduction Main Page]]
			*<u>[[TUFLOW_SWMM_Tutorial_M04 \| TUFLOW SWMM Module 4]]</u> - 1D SWMM Pipe Network / 1D SWMM Urban Hydrology: Executing multiple different event simulations from a single model control file.
	}}
			*<u>[[XPSWMM_to_TUFLOW-SWMM \| XPSWMM to TUFLOW SWMM]]</u> - How to convert an XPSWMM model to TUFLOW SWMM.