SMS

Using an SRH-2D Restart File

By aquaveo on May 30, 2018

Do you have an SRH-2D project that is going to take a long time to run? If you don't want your computer tied up for hours, or even days, an SRH-2D project can broken up into smaller model runs that build on each other. This is done by using a restart file or hot start file.

In SRH-2D, a restart file can be specified for the initial wet/dry condition of the simulation. The restart file must have been generated from a previous simulation run that used the same mesh. Several output options exist for creating restart files including: creating them at a regular interval, at a specified list of times, or a single restart file at the end of the simulation.

When SRH-2D does a model run, it creates a series of files for each time step. These restart files are named [casename]_RSTn.dat where n corresponds to the time index. The time series output index file is named [casename]_TSO.dat and holds a list that matches the restart files to a specific time step.

When a restart file is used as an initial conditions hot start file, the previously computed hydraulic conditions from the restart file will always be applied to the start time of a simulation.

To use a hot start condition, do the following:

Run an SRH-2D simulation to completion.
In the output files for the model run, locate the file ending with "TSO.dat" and open it in a text editor.
In the TSO file, locate the time step where you want to use to start your next next simulation run.
In you SMS project, duplicate your simulation.
Open the SHR-2D Model Control dialog for your new simulation.
In the Initial Conditions section, select the Restart File option.
Press the Select button to browse to your restart file.

SRH-2D will now use the conditions from the restart file when you perform your next model run. Now that you know how to use a restart file for an initial condition in SRH-2D, try it in the Community Edition of SMS today!

Blog tags:

SMS

Troubleshooting Errors in SRH-2D

By aquaveo on May 2, 2018

It happens. You‘ve finished building your SRH-2D model in SMS and you launch the model run. Then, to your dismay, SRH-2D stops running and gives you an error.

It’s not fair. You did everything correct and entered all the correct parameters. SRH-2D should be running and giving you its valuable results. But instead you have an error message.

Don’t panic.

While it is discouraging for SRH-2D to not complete when you launch the model run, it is only telling you that a key bit of data is missing for it to give you valid results. The error code will help you locate that data or fix an inconsistency.

But how do you use the error code to find what needs to be fixed? And shouldn’t the SMS model checker have found it before SRH-2D started?

The SMS model checker verifies all the data needed to run SRH-2D is present and looks for errors in the SMS project such as dangling arcs, numbering issues, or missing components. It does not validate the data. Once the SMS model checker has finished, SRH-2D performs its own checks during the model run.

When SRH-2D gives you an error, you’ll need to record the error number. Errors are shown in the model wrapper. Clicking on the Pre-SRH-2D button will show if there are errors during the pre-processor run. Clicking the SRH-2D button will show errors during the model run.

Once you know what the error is, you can look up the list of SRH-2D errors on the XMSwiki here. The article contains a list of known errors along with guidance on how to fix them.

If you were unable to record the error from the model wrapper, don’t worry. You can still see this information by reviewing two of the files generated by SRH-2D during every model run. These files will be named [projectname].OUT.dat and [projectname].DIA.dat files.

To use these files:

Locate the files in the model run directory with your project file.
Open the *.OUT.dat or *.DIA.dat files using a text editor such as Notepad.
Look through the text file to locate the error code.
Go to the SRH-2D error page to find the solution.
Make the needed change(s) to your project and run SRH-2D again.

Typical solutions to SRH-2D model run errors might involve adjusting some data inputs or making minor reconfigurations to boundary conditions or structures. While making these changes to a project can sometimes be frustrating and tedious, getting an accurate end result will make it all worthwhile.

This is a great troubleshooting process you can use to create many successful SRH-2D model runs. If you haven’t already made use of SRH-2D, feel free to explore it in the Community Edition of SMS.

Blog tags:

SMS

Using Snapping in SMS

By aquaveo on April 11, 2018

In many projects, you might find a need for nodes or vertices to line up exactly. You can achieve this by using the Snapping feature in SMS. Snapping nodes to arcs can be accomplished two ways in SMS: by cleaning and by using the snapping crosshairs. In some cases, two arcs might need to be very close to each other but not snapped to the same nodes or vertices on a mesh. This post will discuss how all of this works.

Clean Option

The Clean option allows any two nodes on the same coverage to be "snapped" together To snap two nodes on the same coverage:

Select the desired nodes.
Select the Clean... command from the Feature Objects menu.
In the Clean Options dialog, turn on Snap selected nodes.
Select the desired node as the snapping point.

The nodes will be merged into one node at the desired location.

Nodes and vertices can also be snapped using a tolerance value. This will snap all nodes in the coverage to be within the tolerance.

Select the Clean... command from the Feature Objects menu.
In the Clean Options dialog, turn on Snap nodes and vertices.
Set the Tolerance level.

The tolerance units are the same as those set in the projection. This method may cause vertices to be redistributed along some arcs, so it should used carefully.

Snapping Feature

If Snapping is turned on the Map tab in the Preferences dialog (see image below), red crosshairs (see image below) will appear when creating an arc and the mouse moves near an existing node or vertex. This indicates that the node or vertex will snap to the existing node or vertex in the coverage. If two vertices snap, they turn into a single node. Snapping can be turned on and off when in the Map module by pressing "S" on the keyboard.

Snapping Across Multiple Coverages

To snap across multiple coverages, Inactive coverages must be turned on in the Display Options dialog. This prevents nodes or vertices from appearing to be snapped when they are not (see the images below). The first shows what appears to be two vertices that are snapped. The second shows a zoomed view showing they are not actually snapped.

Snapping can also occur between a coverage and a geometry such as a mesh or a grid.

Nodes That Should Not Be Snapped

Keep in mind that if two boundary arcs are close to the same node(s) on the mesh or grid, a simulation may snap them to the same node(s) within the simulation, which may cause errors. This can be fixed by either refining the mesh or grid so there are more nodes to use, or by moving one or more of the arcs slightly.

Try using the snapping feature today in the Community Edition of SMS.

Blog tags:

SMS

Using Zonal Classification in SMS

By aquaveo on March 14, 2018

Needing to identify part of your model that is prone to flooding? Or do areas of your project need to be marked off as a fish habitat?

While there are many tools in SMS that can be used to designate areas of a project as something different, one of the easier ways is to use Zonal Classification tool.

Begin with opening your project containing scalar data. The scalar data can be loaded into the Scatter module, or be part of a 2D mesh or 2D grid.

Next, open the Zonal Classification tool. Do this by selecting the Zonal Classification menu command in the Data menu in either the Scatter, Mesh, or Grid module.

Once the Zonal Classification dialog is open, start setting criteria to define your zones. In the section titled “Zones”, click the New button to create your zone. You can define multiple zones at once while in the dialog.

Once you’ve created your zones, you can define the criteria for each zone. Select the zone and click the New button in the Criteria List section. The criteria can be one of two types: a function criteria or a material criteria.

As you’ve probably guessed, function criteria use a formula you specify to create the zone. Say you want to identify areas on your mesh below an elevation of 50 feet because those are areas you need to mark off as being prone to flooding. You’ll select the Function criteria option, select your elevation dataset, check the Less than option and enter a Value of 50.

Similarly, you can choose to create zones based on materials. The materials need to have already been defined in the project before this option can be used. Once the materials are defined, you can create zones that either include or exclude areas of your projects where the zones overlap your scalar data.