Tutorial Troubleshooting QGIS - Revision history

Emilie Nielsen: /* Troubleshooting Steps */

2026-03-30T02:04:38Z

Troubleshooting Steps

← Older revision		Revision as of 12:04, 30 March 2026
Line 122:		Line 122:
	<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. set exe="..\..\..\exe\~~2023-03-AA~~\TUFLOW_iSP_w64.exe").		<li>If using environment variable 'set exe', confirm there are no spaces surrounding the equals sign (e.g. set exe="..\..\..\exe\2026.0.0\TUFLOW_iSP_w64.exe").
	<li>Write 'pause' 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 'pause' 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>

Abigail.lillo: /* Editing File Extension */

2025-06-23T02:22:00Z

Editing File Extension

← Older revision		Revision as of 12:22, 23 June 2025
Line 109:		Line 109:

	<b> Windows 10 </b> <br>		<b> Windows 10 </b> <br>
	[[File:File Ext Win10.png]]		<ol>[[File:File Ext Win10.png]]</ol>


	<b> Windows 11 </b><br>		<b> Windows 11 </b><br>
	[[File:File Ext Win11.png]]		<ol>[[File:File Ext Win11.png]]</ol>

	=Troubleshooting Steps=		=Troubleshooting Steps=

Abigail.lillo: /* Editing File Extension */

2025-06-23T02:03:48Z

Editing File Extension

← Older revision		Revision as of 12:03, 23 June 2025
Line 104:		Line 104:

	===Editing File Extension===		===Editing File Extension===
	When a control file ~~is created~~ from a .txt file, the file extension should be edited to reflect the control file type, ~~for~~ ~~example~~ .tgc, .tbc or .tcf. If the file ~~extension~~ is hidden in Windows File Explorer, it is ~~likely~~ ~~for~~ the file ~~type~~ to ~~rename~~ ~~unchanged~~ the ~~intended~~ extension is ~~added~~ to the ~~file~~ ~~name.~~ ~~For~~ ~~example:~~		When creating a control file from a .txt file, the file extension should be edited to reflect the control file type, such as .tgc, .tbc or .tcf. If the file extensions are hidden in Windows File Explorer, the intended changes to the file extension may be applied to the file name rather than the extension. This could result in control files being referenced incorrectly, which may cause the error message [[TUFLOW_Message_0008 \| ERROR 0008]] - <filename> cannot be found.

	In this case, control files may be referenced incorrectly and lead to encountering [[TUFLOW_Message_0008 \| ERROR 0008]] - <filename> cannot be found.

	To edit file extensions correctly, ensure file extensions are displayed by enabling the following option within Windows File Explorer:		To edit file extensions correctly, ensure file extensions are displayed by enabling the following option within Windows File Explorer:

	<u> Windows 10 </u>		<b> Windows 10 </b> <br>
	[[File:File Ext Win10.png]]		[[File:File Ext Win10.png]]


	<u> Windows 11 </u>		<b> Windows 11 </b><br>
			[[File:File Ext Win11.png]]

	=Troubleshooting Steps=		=Troubleshooting Steps=

Abigail.lillo: /* Common Errors */

2025-06-23T01:53:32Z

Common Errors

@@ Line 102: / Line 102: @@
 </ol>
 <br>
 =Troubleshooting Steps=

Pavlina Monhartova at 05:31, 18 April 2025

2025-04-18T05:31:11Z

Emilie Nielsen at 00:21, 23 September 2024

2024-09-23T00:21:04Z

← Older revision		Revision as of 10:21, 23 September 2024
Line 91:		Line 91:

	===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/~~_archive~~/~~TUFLOW~~/~~Releases~~/~~2018-03/TUFLOW%20Manual.2018-03.pdf 2018~~ TUFLOW Manual]</u> lists all the available commands and specifies 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> lists all the available commands and specifies which TUFLOW control file each command belongs to.<br>
	<ol>		<ol>
	<li>Example of a typo in the 'BC Control File ==' command: <br>		<li>Example of a typo in the 'BC Control File ==' command: <br>

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

2024-07-21T23:49:41Z

Simulation DOS Window Flashes and Disappears

← Older revision		Revision as of 09:49, 22 July 2024
Line 105:		Line 105:
	=Troubleshooting Steps=		=Troubleshooting Steps=
	=== Simulation DOS Window Flashes and Disappears ===		=== Simulation DOS Window Flashes and Disappears ===
	When batch file is double clicked and the simulation ~~DOW~~ 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 DOS 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).

Emilie Nielsen: /* TUFLOW Log File (.tlf) /

2024-04-05T01:26:06Z

TUFLOW Log File (*.tlf)

← Older revision		Revision as of 11:26, 5 April 2024
Line 142:		Line 142:
	{{Video\|name=Animation_Troubleshooting_CommonErrors_08b.mp4\|width=1217}}<br>		{{Video\|name=Animation_Troubleshooting_CommonErrors_08b.mp4\|width=1217}}<br>
	<br>		<br>
	<li>If no error messages appear in the .tlf and the last line shows 'Sending initialisation data to HPC...' see <u>[[Tutorial_Troubleshooting_QGIS#HPC_TUFLOW_Log_File_.28.~~2Ahpc~~.tlf.29 \| HPC TUFLOW Log File]]</u> below.<br>		<li>If no error messages appear in the .tlf and the last line shows 'Sending initialisation data to HPC...' see <u>[[Tutorial_Troubleshooting_QGIS#HPC_TUFLOW_Log_File_.28.2A.hpc.tlf.29 \| HPC TUFLOW Log File]]</u> below.<br>
	<br>		<br>
	</ol>		</ol>

Chris Huxley: /* Typos in Control Files */

2024-01-17T06:17:27Z

Typos in Control Files

← Older revision		Revision as of 16:17, 17 January 2024
Line 37:		Line 37:
	<br>		<br>

	===~~Typos~~ in Control Files===		===Spelling Mistakes in Control Files===

	~~Typos~~ in control files are common, ~~with the majority~~ resulting in a 'does not exist' pop up message:<br>		Spelling mistakes in control files are a common mistake, resulting in a 'does not exist' pop up message:<br>
	<br>		<br>
	<ol>		<ol>
Line 55:		Line 55:
	</ol>		</ol>

	===~~Typos~~ in Input Layers===		===Spelling Mistakes in Input Layers===
	~~Typos~~ in input layers are common, resulting in a 'does not exist' pop up message:<br>		Spelling mistakes in input layers are also a common mistake, resulting in a 'does not exist' pop up message:<br>
	<br>		<br>
	<ol>		<ol>

Emilie Nielsen: /* Common Errors */

2023-08-21T00:21:10Z

Common Errors

← Older revision		Revision as of 10:21, 21 August 2023
Line 13:		Line 13:
	<li>Use the 'Save All' tool to save all unsaved control files:<br>		<li>Use the 'Save All' tool to save all unsaved control files:<br>
	<br>		<br>
	[[File:~~Animation_Troubleshooting_CommonErrors_12a~~.~~gif~~]]<br>		[[File:Troubleshooting_CommonErrors_12.png]]<br>
	<br>		<br>
	</ol>		</ol>

← Older revision		Revision as of 15:31, 18 April 2025
Line 74:		Line 74:

	===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 104:		Line 104:

	=Troubleshooting Steps=		=Troubleshooting Steps=
	=== 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. set exe="..\..\..\exe\2023-03-AA\TUFLOW_iSP_w64.exe").		<li>If using environment variable 'set exe', confirm there are no spaces surrounding the equals sign (e.g. set exe="..\..\..\exe\2023-03-AA\TUFLOW_iSP_w64.exe").
	<li>Write 'pause' 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 'pause' 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_Troubleshooting_CommonErrors_05b.mp4\|width=1124}}<br>		{{Video\|name=Animation_Troubleshooting_CommonErrors_05b.mp4\|width=1124}}<br>
Line 122:		Line 122:
	<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 <u>[[Tutorial_Troubleshooting_QGIS#Simulation ~~DOS~~ Window Flashes and Disappears \| here]]</u>.		<li>If there is no log file, see <u>[[Tutorial_Troubleshooting_QGIS#Simulation Console Window Flashes and Disappears \| here]]</u>.
	</ol>		</ol>

Tutorial Troubleshooting QGIS - Revision history

Emilie Nielsen: /* Troubleshooting Steps */

Abigail.lillo: /* Editing File Extension */

Abigail.lillo: /* Editing File Extension */

Abigail.lillo: /* Common Errors */

Pavlina Monhartova at 05:31, 18 April 2025

Emilie Nielsen at 00:21, 23 September 2024

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

Emilie Nielsen: /* TUFLOW Log File (*.tlf) */

Chris Huxley: /* Typos in Control Files */

Emilie Nielsen: /* Common Errors */

Emilie Nielsen: /* TUFLOW Log File (.tlf) /