SMS:SRH-2D Errors

This is a list of common known error messages produced by SRH-2D. This is not a comprehensive list of all possible errors. These errors will appear during the model run.

NOTE: To search this web page, use CTRL+F

An error may occur during either the Pre-SRH-2D process or during the SRH-2D process. During the run, errors will be listed in the SRH-2D model wrapper. Clicking the PreSRH-2D button in the model wrapper will display results from the pre-processor. Clicking the SRH-2D button will show results from the model run.

If the model wrapper has been closed, two files are generated recording the model run. Opening the "*_.OUT.dat" or the "*_DIA.dat" files in a text editor will show errors in the model run.

List of Error Messages

The first three columns in the table are sortable. Simply click the small arrows on the right side of the column header to sort in ascending or descending order.

The columns in the table include:

• Location indicates whether the error occurs in the SRH-2D Pre-processor or in SRH-2D itself.
• Error Code gives the Error Code (if any).
• Error Text from Model gives the full text of the error message. Errors that do not produce any error text will have "no text" in this field.
• Affected Model Component gives the component(s) in the model which is most likely causing the error and will need review/adjustment for the simulation to run correctly.
• Description gives more details about the error.
• Potential Solution gives steps that may be necessary to correct the issue.

SRH-2D Simulation Errors

This table lists errors that can occur during the SRH-2D simulation run.

SRH-2D Simulation Errors

Location	Error Code	Error Text from Model	Affected Model Component	Description	Potential Solution
SRH-2D	1	Stopped in spline.f90 H	BC Coverage, Materials Coverage	Time series data used to define inflows/outflows, time varying water surface elevations, or time varying roughness has issues with how it is defined, such as duplicate times.	The time series data should only have one data value per defined time. Review the XY Series Editor where the time series data is defined for the boundary conditions and remove any duplicate time entries.
SRH-2D	1	Stopped in uti_qwin_xyplot.f90 TIME_SIMU	Model Control	Inconsistent time control settings.	The end time is prior to the start time in the model control. Adjust so the end time is later than the start time.
SRH-2D		No cells cover an obstruction in structure_obstruction.f90	Obstruction Coverage	Obstruction feature area of influence does not cover the centroid of at least one element.	The "Obstruction Width/Diameter:" value in the Obstructions Properties dialog is set to "0" and/or an obstruction arc is positioned just beyond half the width/diameter defined in the properties from the centroid of a mesh element.
SRH-2D	5	Stopped in structure_culvert.f90 ICELL error#5	Material Coverage	Boundary condition arc mesh snapping does not match inactive material zone snapping.	Review the material polygon snapping and review material assignment.
SRH-2D	5	Stopped in structure_culvert.f90 ICELL	Boundary Condition Coverage	HY-8 arc pairs are not lining up with each other.	Review the arcs for the culverts. Verify that the arcs are correctly paired and drawn in the same direction.
SRH-2D		None	Obstruction Coverage	More than 99 obstructions exist in the project.	SRH-2D has a built in limit to how many obstructions can be included in a model. Currently this limit is 99. Reduce the number of obstructions to 99 or fewer.
SRH-2D	2	ALL INLET cells are dry from bc_mdot2.f90! Code may have blow up due to input errors or too-large time step.	Material Coverage	Material polygons near inflow are unassigned. This occurs when the material coverage has not been linked to the simulation. Also occurs when all material polygons covering the inflow BC have an "unassigned" material type. This can also occur if no boundary conditions providing an inflow source have been included in the simulation.	Review the simulation to make certain materials have been assigned and that materials and BC coverages have been added to the simulation.
SRH-2D		FATAL ERROR The code diverged; further reduction of time step would help the convergence!	Model Control	Too large of a time step.	Reduce the size of the computational time step in the model control.
SRH-2D	3	bad mesh ! Stopped in indx_conn.f	2D Mesh	Problem in mesh, often due to overlapping elements.	Check if problem cell (element) id is listed. Otherwise, examine mesh quality in SMS.
SRH-2D	0	Exit code 0	Varies	The SRH-2D simulation has stopped or finished whether successfully executed or not.	Review the simulation results, if any. Further troubleshooting may be required if there are no solutions data or the data is incomplete.
SRH-2D	8	Inconsistent cell ID in mesh_connectivity: maybe due to wrong nodestring	2D Mesh, BC Coverage	There is an issue with how the BC arcs are being assigned to the mesh elements.	Review mesh for overlapping elements. Also, check snapping of BC arcs.
SRH-2D		Program Stopped as Mesh is different in RST file One of the following is different: Ncell Nvert Nface Nclfc Nclvt in RESTART file do not match those in the input file Ncell Nvert Nface Nclfc Nclvt in restart file are: 13604 7374 20977 41693 41693 in casename.GRD file are: 15459 8277 23735 47225 Mesh topology has to be the same for irest>=1 or init_method=3	Model Control	Using a restart file that was created with another mesh. Restart files can only be used with simulations using the exact same mesh.	Review the restart file and use a restart that matches the mesh. Regenerate the restart file if needed or select a different initial condition option.
SRH-2D	6940	None	Material Coverage	The assigned material types for the areas upstream or downstream of the culvert location are not valid.	Ensure that areas upstream of the upstream culvert location and areas downstream of the downstream culvert location have a valid material type assigned.
SRH-2D	1	Stopped in structure_pressure_flow.f90 PARA DISTANCE	2D Mesh, BC Coverage	Shape of pressure zone is not acceptable for a parabolic type bridge ceiling.	Ensure that the pressure zone, between the pressure flow arcs, is rectangular in shape.
SRH-2D	9669	Program stopped due to the following: Wrong IFACE matching occurred in structure_internal.f90 #4 Error Code is: 9669	2D Mesh, BC Coverage	The area between the pressure zone arcs with overtopping turned on is not rectangular in shape and/or that the elements in-between the arcs are not rectangular.	Ensure that the area between the pressure zone arcs with overtopping turned on is rectangular in shape and that the elements in between the arcs are quads (rectangles). If necessary, create a new mesh with a rectangle between pressure flow arcs and which has quads in this area using the patch mesh generation method.
SRH-2D	46631	Program stopped due to the following: Wrong IFACE matching occurred in structure_internal.f90 #4 Error Code is: 46631	2D Mesh	Ensure that the area between the pressure zone arcs with overtopping turned on is rectangular in shape and that the elements in between the arcs are quads (rectangles).	Create a new mesh with a rectangle between pressure flow arcs and which has quads in this area using the patch mesh generation method.
SRH-2D	0	Program stopped due to the following: Wrong IFACE matching occurred in structure_internal.f90 #4 Error Code is: 0	BC Coverage	There is an issue with one or more boundary condition arc definitions.	Review snap preview of boundary condition arcs.
SRH-2D	16026	Program stopped due to the following: A downstream Structure nodestring has not set right; structure_culvert.f90 ICELL error#2 Error Code is: 16026	2D Mesh	The 2D mesh around and through the structure is not optimal.	Examine the areas around the structure. Suggestions to optimize the mesh around the structure include creating patched (quadrilateral) elements through the structure from one face to the other.
SRH-2D	79	Program stopped due to the following: Tailwater WSE exceeded the maximum TW in the Reverse HY8 Table structure_hy8.f90 Error Code is: 79	2D Mesh, Model Control	Computed water surface elevations near the culvert became extremely high. This could be from too large of a time step, poor mesh quality near the culvert faces, or parts of the mesh were the culvert is applied have higher elevations than what are defined as the inverts defined in the HY-8 culvert definition	Review mesh quality near the culvert face. Check to ensure that mesh node elevations where culvert faces are applied do not exceed invert elevations as defined in the HY-8 culvert definition. Lowering the time step to improve stability around the culvert could also help.
SRH-2D	N/A	forrtl: severe (24): end-of-file during read, unit n, file {your filepath.dat} Image PC Routine Line Source srh2d_3.2_quickwi...Unknown...	Varies	This is usually a generic error indicating something is wrong with the SRH-2D simulation casename.DAT file created by SRH pre. It typically signifies that SRH-Pre did not terminate normally and generate a valid simulation file. The cause of the error could be any number of issues.	Check for any error messages reported by SRH-pre by going to the SMS model wrapper and clicking on the "PreSRH-2D" line and reviewing the on screen output messages.
SRH-2D	N/A	Failed to find a mesh cell which contains the following (x y) points: (X,Y)=	2D Mesh	This is caused when there is a void added to the mesh by deleting a mesh element from the mesh after the mesh has been generated. Creating void by deleting mesh elements may not actually remove the element data from the mesh in SRH-2D.	If a void is needed in the mesh, it should be created as a polygon in the Mesh Generator coverage and given a mesh type of "None". When a mesh is generated using polygons with the "None" type, a void will be created in the mesh that can be recognized by SRH-2D.
SRH-2D	0	Program stopped due to the following: IFACE match does not found in structure_culvert.f90 #n	2D Mesh	Element configuration around the structure face is causing a mismatch in the transition into or out of the structure.	It may help to ensure all elements within the two structures are quadrilateral elements. It may also help to ensure that the first row of elements downstream of the downstream structure face and upstream of the upstream structure face are also quadrilateral elements that are "well formed" ("Well formed" elements as in having interior corners as close to 90 degrees as possible).
SRH-2D	1	Program stopped due to the following: Stopped in read_input2.f90 HY8 Forward_TABLE Line Error	Files	There is a problem reading the culvert table file. One of the causes of this is that the HY-8 file containing the culvert definition does not include a file extension.	Add a ".hy8" file extension to the culvert definition file name.
SRH-2D	N/A	forrtl: severe (170): Program Exception - stack overflow	2D Mesh	The simulation is too large for SRH-2D to process. Typically this occurs when running a simulation using sediment transport and a 2D mesh that contains more than 50,000 elements.	Reduce the number of elements in the 2D mesh and try running the simulation again.
SRH-2D	3	Not ready in solve.f90 SEDIMENT MODULE	Model Control, BC Coverage	This errors occurs when sediment transport is being modeled in a project containing 1D hydraulic structures (culverts, weirs, pressure bridges, etc.). SRH-2D cannot model sediment transport in models containing 1D hydraulic structures.	Either do not use the sediment transport in the model run, or remove the 1D hydraulic structures from the model.
SRH-2D	1	Program stopped due to the following: Wrong Boundary ID;may due to some boundary mesh points are not in NODESTRING lists in SMS	2D Mesh	This error seems to be related to issues with mesh quality.	Review mesh quality. Check for elements with very small or very large interior angles (angles less than 10 degrees or greater than 180 degrees. If any are present, make adjustments in the conceptual model (mesh generator coverage) and re-generate the mesh.
SRH-2D	67	Input statement requires too much data, unit 1	Model Control	This error appears related to using a restart file that doesn't match the project geometry.	Review the restart file. Common issues appear to be using a restart file that came from a different project or uses a different projection. Check that all major aspects of the project geometry (mesh, nodes, units, coordinate system) match what is used in the project in order to use a restart file. The other solution is to not use a restart file with the simulation and select another option for the initial condition.
SRH-2D	7	Inconsistent cell ID in mesh_connectivity.f90: maybe wrong nodestring	BC Coverage	This error is caused when two arcs in the boundary condition coverage snap to the same nodes but have different boundary condition types.	Review the boundary condition arcs and use the snap preview.
SRH-2D	16	Linked Pair nodestring direction is wrong; please reverse them.	BC Coverage	This error is caused when a paired arc structure, such as a culvert, has arcs that have been drawn in opposite directions or the arcs are not facing downstream.	Review a paired arc structures to ensure that the arcs are post going the same direction and that the arcs are facing downstream. Fix any structure arcs that are going the wrong direction.
SRH-2D	4	Program stopped due to the following: The upstream INTERNAL boundary linked to a downstream should a water withdrawal!	BC coverage or 2D mesh	This indicates a model instability near a boundary condition arc. Review 2D mesh elements near BC arcs and/or adjust BC coverage values.

Pre-SRH-2D Simulation Errors

This table contains errors that can occur during the PreSRH-2D, or pre-processor, run for the simulation.

Pre-SRH-2D Simulation Errors

Location	Error Code	Error Text from Model	Affected Model Component	Description	Potential Solution
PreSRH-2D	1	unable to open srhhydro file!	Files	Unable to open the exported srhhydro file.	The path length for the SMS project is too long. Therefore, the SRH-2D preprocessor could not read the exported files from SMS. Reduce the path length to less than 300 characters.
PreSRH-2D	1	Element ID is not consecutive	2D Mesh	The mesh element ID's have been mismatched since some mesh nodes were modified and not renumbered.	Renumber the mesh nodes using the Renumber command under the Nodes menu in the Mesh module.
Pre SRH-2D		Errors from final_touch.f90 **** on MONITOR LINE#n a face cannot be found given two mesh points Two points are: xx xx Check the mesh node list; do this using _SIF.dat file directly!	Monitor Coverage	Monitor line spans a void or hole in the mesh.	Reconfigure the monitor line. Monitor lines cannot span holes in the mesh.
PreSRH-2D	157	forrtl: severe (157): Program Exception - access violation	Preferences	SMS failed to locate the SRH-Pre executable.	Review the file location in the Preferences dialog to ensure it is set to the correct location for SRH-Pre.
PreSRH-2D		MESH-UNIT: Enter one of the following options for the unit of the mesh.	Projections	There is an issue with the units set for the project. SRH requires that vertical and horizontal units be in either meters or U.S survey feet.	Review the project and mesh project and units.
PreSRH-2D		Could not find a mesh cell which contains the monitoring point! Check the input of (X Y) coordinates for a monitoring points	Monitor Coverage	A monitor point is outside of the mesh domain.	Adjust the monitor point to be somewhere within a mesh element.
PreSRH-2D	4	Program stopped due to the following: Stopped in sec_blow NLAY Error Code is: 4	Model Control	This errors occurs when sediment transport is on and there are more than the maximum number of allowed sediment layers (9) for one or more sediment materials.	Reduce the number of sediment layers to 9 or less for each sediment material.

Other Errors

This table contains additional errors that can occur with an SRH-2D simulation in SMS.

Location	Error Code	Error Text from Model	Affected Model Component	Description	Potential Solution
SMS		No mesh that matches the scalar set.	2D Mesh	No mesh that matches the scalar set. The solution file does not correspond to the mesh in the project, or node numbering of the mesh has been changed, invalidating the solution.	Take care when making edits to the mesh and renumbering the nodes. Any previous results will be invalidated when nodes are renumbered.
	None	None	2D Mesh	WSE error directly under the bridge in the form of waves oscillating through the channel.	Use larger, quadrilateral elements in the deepest areas of flow. Lowering the time step may also help.
	None	None	BC Coverage	SRH-2D is not recognizing a 1D structure or 2D pressure flow structure. When reviewing the 2D results or output files it does not appear that SRH-2D is using a structure such as a culvert, pressure flow bridge structure, weir, or gate.	Make sure the pair of arcs in the SRH-2D boundary condition coverage representing the faces of the structure were created in the same topologic direction (i.e. both were created left to right looking downstream or both were created right to left downstream). The direction does not matter, only that both arcs are consistent. Turn on the display of arc "Direction" in the display options for the map arcs. This will add an arrow to the map arcs in the display denoting their topologic direction.
SMS		The following coverage(s) have an unsupported type and will be converted to area property: (Name of Coverage(s) Listed)	Files	When opening the SRH-2D map file without the accompanying project file, the SRH-2D map coverages were not recognized.	If the coverage type is under Model (which the *.map file provided indicated it was) then the type is stored in the project file so that error will appear when opening the *.map file. Locate and open the project file instead of the *.map file.
SMS	1	Error code 1	Materials Coverage, Export	*.srhmat file does not exist.	File didn't export successfully. Make sure materials are assigned in the materials coverage.

Examples

A few examples of projects containing errors are included here.

Example 1

This example shows an SRH-2D project where the inflow boundary condition arc has an incorrect entry in the time series for the boundary condition properties.

Download the sample files here. Review the inflow boundary condition attributes, including the XY Series editor. Run the simulation to see the error.

Example of an SRH-2D project with incorrect boundary conditions

Example 2

This example shows an SRH-2D project where a material has been incorrectly left unassigned.

Download the sample files here. Review the materials coverage to see the unassigned material. Run the simulation to see the error.

Example of an SRH-2D project with incorrect materials

Example 3

This example shows an SRH-2D project where a monitor point have been created outside of the mesh domain.

Download the sample files here. Review the monitor coverage to locate the point that is outside the mesh domain. Run the simulation to see the error.

Example of an SRH-2D project with a monitor point outside the domain

Example of an SRH-2D project with an incorrect monitor point

Example 4

This example shows an SRH-2D project where area between the pressure arcs has been left with a paved (triangular) elements.

Download the sample files here. Review the 2D mesh in the location of the pressure bridge. Run the pressure simulation to see the error.

Example of an error caused by having a paved mesh in a pressure structure

Paved mesh between pressure arcs

Example 5

This example shows an SRH-2D project where, in the Model Control, a restart file has been selected. After adding the restart file, changes were manually made to the 2D mesh resulting a mismatch.

Download the sample files here. Review the model control and restart file. Run the simulation to see the error.

Example of an error caused by restart file that does not match the 2D mesh

Related Topics

• SRH-2D
• SMS Release Notes