Common reasons why a model won’t start
In this section are some common reasons why a model won't start.
General Error Debug Recommendations
You may find that your simulation has crashed, or some other syntax error in the inputs has caused it to stop. If this happens, open the log file (*.log) to see what may have gone wrong. Be logical and thoughtful in your model preparation; often it’s a simple mistake that causes the most frustration.
The most effecient way to debug an input error is to work backward through the log file, searching for the following terms:
A message will be written to the log file describing the input error.
Syntax Errors (Unrecognised flag encountered)
The most common issue experienced by new users when setting up are model are related to syntax errors. A message similar to that shown below will be written to the log file if input sytax is specified which is not recognised by TUFLOW FV.
Unrecognised flag encountered on line 15 Start Time = 0
In this instance, the syntax error is located on line 15 of the control file (fvc). The user has specified the command 'Start Timestep = 0'. Although the command is correct, the syntax is not. TUFLOW requires that two equals sign be used. The correct syntax is 'Start Time == 0'
Syntax highlighting is an effective way to differentiate between comments, commands and syntax errors. The following links step through how to install TUFLOW FV syntax highlighting:
Nodestrings and Boundary Conditions Don't Match (Unexpected nodestring id)
A message similar to that shown below will be written to the log file if a boundary condition ID is specified in the TUFLOW control file (*fvc), though does not exist in the geometry 2dm file.
BC 2, Type=WL Subtype=1 ERROR:fvdomain_construct:init_bc:fvbc_construct:fvbc_construct:Unexpected nodestring id in bc 2 Exiting TUFLOWFV
There are two ways to check the 2dm file and make sure that the nodestring you are assigning a boundary condition to is the correct one.
- Within SMS, use the “Select Nodestring” tool in the Mesh module and click on the nodestring that you intend to be the boundary condition. On the display bar at the bottom of the SMS window the nodestring ID will be displayed; this is the nodestring ID to use in the TUFLOW FV .fvc file.
- Open the 2dm file in a text editor and search for “NS” at the start of the line. The NS lines provide a list of nodes that define the specific nodestring. The final node on a nodestring has a “-“ prefix, then the following number is the nodestring ID. It is this last number, the nodestring ID, that TUFLOW FV uses to identify the boundary condition.
In both of the above examples, the nodestring ID was '2'. This is the ID which needs to be specified in the TUFLOW FV control file (*.fvc), relating the water level boundary condition timeseries data to the nodestring location.
NOTE: Nodestring order does not influence open boundaries; inflow (into the model domain) is assigned positive and outflow (out of the model domain) is negative irrespective of the node order in the nodestring.
File Reference Errors (Unable to open file)
Specifying an incorrect reference to a file will produce an error. The following message will be written to the log file.
Trying to open file: D:\TUFLOW_FV\Error_Example\bc\Flow_001.csv ...NOT OK ERROR:fvdomain_construct:init_bc:fvbc_construct:init_bc_csv:csvread_r:fvopen: Unable to open file: D:\TUFLOW_FV\Error_Example\bc\Flow_001.csv Exiting TUFLOWFV
Correcting the filepath reference will fix the model intilisation error.
Filepath referencing can be checked from the TUFLOW FV Control file (*.fvc), prior to running the simulation. Directions how to configure UtraEdit and Notepad++ to do this can be found here:
Geometry File Input Error (linear elements only expected)
TUFLOW FV requires linear element geometry mesh (*.2dm) inputs. A linear element mesh is represented by any combination of triangular or quadrilateral elements with node elevations specified at each vertex. In contrast, a quadratic mesh type includes node elevations specified at each vertex and also at the centre of each element face.
Processing mesh geometry file/s: Reading 2dm mesh file... Trying to open file: D:\TUFLOW_FV\Error_Example\RiverBend_Mesh001_Midside.2dm ... OK. File unit: 101 ERROR:fvdomain_construct:init_dmn:fvmesh_construct:fvmesh_rd2dm:Linear elements only expected Exiting TUFLOWFV
A quadratic mesh can be converted to a linear mesh using SMS. To do this:
- Select the Mesh Data Coverage
- Select Elements > Quadratic <-> Linear