Section 8 Minor Enhancements and Bug Fixes
8.1 Minor Enhancements and Bug Fixes for 2023-03-AA
8.1.1 Geo-Referenced Messages
The following messages are now geo-referenced in the 2023-03 Release:
- CHECK 3520
- CHECK 2470
- ERROR 1521
- ERROR 2443 (when applicable)
8.1.2 Error Message When No Start or End Time is Specified
The 2023-03 Release will produce ERROR 2570 if the user has not specified a start or end time. Previously these would default to a start time of zero hours and an end time of one hour.
8.1.3 Warning When 1D_IWL is Used in TCF or TGC
The 2023-03 Release will produce WARNING 2073 if a 1d_IWL point is read in through the .tcf or .tgc, indicating it needs to be read in as a 1D command.
8.1.4 Fixes Issue with Return Characters in GIS Attributes
The 2023-03 Release fixes a bug that would cause a “Should not be here” when a carriage return was present in a GIS attribute value. This would cause TUFLOW to produce ERROR 2148, however also cause a “Should not be here” while writing the error to the message_P.shp layer. In the 2023-03 Release the ERROR 2148 is now written cleanly to the messages_P.shp file.
8.1.5 Package Model functionality copies matrix blockage files
The 2023-03 Release now copies matrix blockage .csv files, previously these were not copied.
8.1.6 .tcf now closed at end of model initialisation
All TUFLOW control files (.tcf, .tgc, and .tbc) are opened by TUFLOW as read only, however, these may not have been closed till the end of the simulation which could interfere with some backup or version control software. For 2023-03-AA onwards these control files (.tcf, .tgc, .tbc) are closed at the end of model initialisation.
8.2 Minor Enhancements and Bug Fixes for 2023-03-AB
8.2.1 Ability to Set Hardware via Command Line Argument
Build 2023-03-AB introduces the ability to set the hardware via a command line argument. The syntax is -hwgpu or -hwcpu and this will overwrite any “
The following command could be used to run a model with CPU hardware on 8 threads:
The following command could be used to on GPU hardware using 2 devices (GPU 0 and GPU1):
8.2.2 Bug Fix for External 1D Engines
Build 2023-03-AB fixes an issue which could cause ERROR 2570 (missing start time or end time) from spuriously being output when linked with external 1D engines (12D, Flood Modeller, or XP-SWMM).
8.2.3 File Path Length Errors
Build 2023-03-AB will trigger an appropriate TUFLOW error and meaningful message if a file path length error is encountered. Previously this could cause TUFLOW to hang indefinitely.
8.2.4 Enhancement to Processing of Tabs
Build 2023-03-AB changes the processing of tab characters within control file commands. These are now replaced with a space character, previously these were deleted. For example:
Was previously interpreted as:
In this instance h (water level) and dt (variable timestep) would be output instead of h (water level), d (depth) and t (viscosity).
