SMS:SRH-2D Errors

From XMS Wiki
Jump to navigationJump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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.

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