TUFLOW SWMM Troubleshooting: Difference between revisions

Content deleted Content added
Spelling Mistakes in Control Files: correct spelling be instead of by
No edit summary
 
(One intermediate revision by one other user not shown)
Line 82:
 
===TCF does not exist===
Typos or spaces in the TCF name result in a 'does not exist' message in the DOSconsole window:
<ol>
<li>Check the name of the TCF is referenced correctly in the batch file.
Line 99:
 
===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://downloadsdocs.tuflow.com/TUFLOWclassic-hpc/Releasesmanual/Latestlatest/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>
<ol>
<li>Example of a typo in the ' <font color="blue"><tt>BC Control File</font><font color="red"> ==</tt></font> ' command: <br>
Line 113:
=Troubleshooting Steps=
== Model won't run ==
=== Simulation DOSConsole Window Flashes and Disappears ===
When batch file is double clicked and the simulation DOSconsole window flashes and disappears the problem might be in the filepath of the TUFLOW executable or incorrect syntax:
<ol>
<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 DOSconsole 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>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 DOSconsole window should remain open providing more information. In the below example, the file path to the TUFLOW exe is incorrect:<br>
<br>
{{Video|name=Animation_SWMM_Troubleshooting_Steps_01a.mp4|width=1218}}<br>
Line 130:
<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>If there is no log file, see the '''Simulation DOSConsole Window Flashes and Disappears''' advice above.<br>
<br>
</ol>