SMS:TUFLOW Coverages
TUFLOW models use several types of Feature coverages. Coverages are used in SMS to represent geometry and associated attributes as points, arcs, and polygons. Unlike some models used in SMS, TUFLOW uses coverage data as model inputs.
TUFLOW coverages can be associated with 2D Geometry Components and TUFLOW Simulations by creating links to the coverage in the component or simulation. The use of links allows multiple simulations or geometry components to share coverage data. Sharing data between simulations reduces required disk space for the simulation and makes it easier to update several simulations with the same changes.
In addition to the coverages listed below, TUFLOW models can use Area Property Coverages to define where to use specific material properties using polygons.
Grid Extents Coverage
A TUFLOW 2D Grid Extents coverage is used to create TUFLOW grids. TUFLOW grids are generated by creating and positioning a Cartesian Grid Frame and then right-clicking on the coverage and choosing Map→2D Grid.
Boundary Conditions Coverage
Boundary conditions are defined in TUFLOW with points, arcs, or polygons in a 1D–2D BCs and Links coverage. BC coverages can also be used to specify cell code (active/inactive) areas of the 2D model domain. The kinds of boundary conditions available depend upon whether it is applied to a point, arc or polygon.
Boundary conditions defined at points are 1D boundary conditions and must be placed at the same location as a 1D boundary node. (See Snapping Feature Objects) The boundary condition information is specified in the BC Node Attributes dialog (see 1D Boundary Conditions at Nodes).
Arcs can be used to define 2D Boundary conditions applied to the 2D domain. The BC attributes are specified in the BC Arc Attributes dialog (see 2D Boundary Conditions at Arcs).
Polygons can be used to define rainfall applied to 2D domains or to specify active/inactive information for 2D domains. The BC Polygon Attributes dialog specifies the type of information stored with the polygons (see 2D Boundary Conditions at Polygons).
1D/2D Connections Coverage
1D/2D connections are used with the 2D boundary condition coverage to link 2D and 1D domains.
Two types of arcs can be created in a 1D–2D Connection coverage: 1D/2D connection arcs (CN) and Flow vs. Head Connection arcs (SC).
1D–2D Connection arcs are written to a 2d_bc layer file for TUFLOW input (see 2d_bc_layers in the TUFLOW documentation). One end of the connection arcs must end at the same location as a 1D Flow/2D Water Level Connection (HX) in a TUFLOW boundary conditions coverage. The other end of the connection arc must end at the same location as a network node in a TUFLOW network coverage.
The coverage has a couple unique commands that appear when right-clicking on the 1D–2D Connections coverage. The commands are:
- Properties
- Brings ups a Select Boundary Condition Coverage dialog where a boundary condition coverage can be assigned to the connection coverage.
- Clean Connections
- Opens a Clean Options dialog.
TUFLOW Clean Options
This dialog makes sure that connections arcs end at HX boundaries and the HX boundaries have nodes at the connection endpoints. The dialog has the following options:
- Tolerance – Determines the tolerance level SMS will use in determining if the connection arcs end at the HX boundaries.
- 2D BC coverage – Sets the boundary condition coverage that will provide the HX boundary. The coverage is selected in the tree below.
- 1D Network coverage – Sets the network coverage to be used. The coverage is selected in the tree below.
1D Cross Section Coverage
Cross section coverages are used to define open channel cross section data for 1D networks. Cross section geometry is generally extracted from a TIN and may be edited by hand if desired.
Cross sections are created by creating arcs in a cross section coverage. SMS can automatically create cross section arcs from a 1D network.
This coverage has a few unique commands available when right-clicking on the coverage in the Project Explorer. The commands are:
- Extract from Scatter
- Extracts the elevations for the arc from a scatter set (TIN) after cross section arcs are created. This will extract the cross section data from the active dataset on the active scatter set. Values are extracted at each triangle edge in the scatter set and each node or vertex on the cross section arc.
- Map Materials from Area Property Coverage
- Maps the materials from an area property coverage to the cross-sections after cross sections have been created.
- Add Arcs to Mesh
- If there is an existing mesh, adds the cross section arcs to the active mesh.
- Properties
- Opens the CsDb Management dialog. All the cross sections in the coverage are stored in a cross section database. (see Editing Cross Sections).
- Refresh Cross Section Database Materials List
- If there have been changes to the material list in the cross section database, this command with update the coverage to match.
Individual cross sections may be viewed and edited by double-clicking on an arc, or by selecting an arc and choosing Feature Objects | Attributes. This will bring up the Cross Section Attributes dialog.
1D Network Coverage
1D domains are made up of a network of channels and nodes. Channels represent the conveyance of the flowpaths and nodes represent the storage of inundated areas (TUFLOW Users Manual). Channels are created using arcs and the arc endpoints are the nodes.
There are a variety of channel types including open channels, weirs, and culverts (pipe networks). The channel also has a variety of attributes depending upon the channel type. The channel type and attributes are defined in the Channel Attributes dialog which can be reached by selecting an arc and using the Feature Objects | Atributes command.
There are two types of nodes generic nodes, and inlets. Generic nodes can be used to specify storage and can be used to set channel invert elevations. Inlet nodes are used to get flows from a 2D domain into a 1D pipe network below the 2D domain. The node type and attributes are defined in the Network Node Attributes dialog reached by selecting a node and using the Feature Objects | Attributes command.
The TUFLOW documentation sections 5.12.4: Connecting Pits and Nodes to 2D Domains and 5.4: 1d_nwk Attributes list some new TUFLOW features that SMS now supports. SMS's Network Node Attributes dialog has several new additions to the Create Connection to 2D Domain (SX) section. These new options allow controlling elevations at the connections, how many cells are connected, and the method for selection of additional cells (Grade or Sag). Each option correlates fairly directly to a TUFLOW field and some are labeled as such to make look-up easy.
The coverage also has a few unique commands accessed by right-clicking on the coverage in the Project Explorer. These are:
- Add Arcs to Mesh
- If there is an existing mesh, adds the cross section arcs to the active mesh.
- Create Cross Section Arcs
- Brings up the Create Cross Sections Arcs dialog where cross sections arcs can be automatically generated in the coverage.
- Create Water Level Arcs
- Brings up the Create Water Level Arcs dialog where water level arcs can be automatically generated in the coverage.
2D/2D Linkages Coverage
Any number of grids of varying sizes and/or orientations may be used in TUFLOW. A 2D/2D Linkages coverage is used to setup TUFLOW to use multiple 2D domains.
Polygons are created on this coverage that enclose each domain. Then each polygon can be assigned to a domain by using the Feature Objects | Attributes command to bring up a Select TUFLOW Grid dialog.
See TUFLOW Linking 2D Domains for more information.
2D Flow Constriction Shapes Coverage
A 2D Flow Constriction Shapes coverage is used to define flow constrictions in TUFLOW. These are used to model hydraulic structures or other sources of additional losses in TUFLOW. Flow constrictions are of two categories: standard (non-layered) and layered flow constrictions. Layered flow constrictions can be used to model situations where flow has multiple pathways at different elevations. Examples would include flow under a bridge and over the bridge deck as well as a pipeline (typically large box culverts to model as 2D) crossing a waterway. The standard (non-layered) flow constrictions can model box culverts, floating bridge decks, bridges, or apply additional form losses to an area (due to submodel scale features). Flow constrictions can be created for arcs or polygons.
Note that this coverage is different from the older (and outdated) 2D Flow Constriction coverage, which is still supported.
For more information on using this coverage, see TUFLOW Flow Constriction Shapes.
2D Spatial Attributes Coverage
Spatially varied attributes can be defined using the 2D spatial attributes coverage. The values for the attributes are assigned to polygons. TUFLOW assigns the values from the polygons to the cells that exist within the polygon.
The two available spatial attributes are initial water levels and weir factors.
Assigning spatially varied initial water levels may be necessary to ensure that water bodies have water in them initially.
2D Z Lines (Advanced) Coverage
The 2D Z Lines (Advanced) Coverage is similar to the geometry modification coverage which allows modifying terrain along an arc or arcs, but has additional options. With the 2D Z Lines (Advanced) coverage, modify geometry through time to simulate levee failures or other changes to elevation data within the model run. These changes are set up start when a "trigger" is activated such as at a specific time during the simulation or when water depth exceeds a certain amount. An example application is a levee collapsing when flood water overtops it.
- Make sure the coverage is in the Geometry Component(s) that is to be applied to the modification.
TUFLOW also supports the features described above using polygon ZShapes. However, SMS does not support polygon ZShapes using these advanced features (such as triggers) at this time. If necessary to create static modifications to terrain using polygons, use the 2D Z Lines/Polygons (Simple) Coverage.
The 2D Z Lines (Advanced) Coverage
The 2D Z Lines (Advanced) coverage is available under the models/TUFLOW folder. ZShape data is stored in a feature arc's attributes. The Z values of the feature arc's points determine its Z, not the Z of the arc itself (exceptions to this are explained in the Arc Properties Dialog section below).
ZShapes are split into two main categories, Static ZShapes and Variable ZShapes. Static ZShapes are simple terrain modifications that do not change over time. They can be used to create a levee, pit, sand bar, dam, etc. Variable ZShapes have a trigger that causes them to raise or lower the terrain during the simulation. Often a variable ZShape is combined with a static one to provide raised terrain for the trigger to modify. This is necessary because a variable z shape cannot raise the same area it intends to lower when its trigger activates -- it needs the terrain to already be there and cannot create it itself, only modify once its trigger activates.
Arc Properties Dialog
Arcs in a 2D Z Lines/Polygons (Advanced) coverage store ZShape data only if they are told to "override Z values". Otherwise they are not exported for TUFLOW's use. To reach the properties dialog,right-click on an arc and choose "Attributes...". Below is an explanation of the zshape options.
- Override Z Values: ZShape data is only stored and exported if this checkbox is enabled. It tells TUFLOW to override the current terrain Z values with the new values from the arc.
- Thickness: Arcs can be Thin Lines, Thick Lines, or Wide Lines. Thin lines have a width of 0, thick lines have a thickness less than or equal to 1.5 times the 2D cell size, and wide lines are any width larger than that. Thin lines follow some special rules that affect other options in the dialog, such as Option and Trigger Type.
- Option: The ZShape Options are All, Add, Min, Max, and Offset. Offset is only available for variable thin line Z Shapes, which cannot use the Add, Min or Max options. Add is unavailable for any variable Z Shape.
- Offset is not listed by the same name in the TUFLOW documentation and is an alias in SMS for not specifying "NO MERGE". This causes the points of the arc to not be written, and the Z of the arc is determined by the Offset field.
- Offset: Raises the entire arc by this amount. Negative values are appropriate.
- When offset is specified as the Option for variable thin lines, this field specifies the height to adjust terrain to (instead of adjusting it up or down by this amount) when triggered.
- For all other variable arcs, this the the amount to adjust the terrain by when the trigger activates.
- Use Trigger: Toggles the arc between being a static zshape and a variable zshape. Variable z shapes use triggers to change terrain when a specific event occurs. All variable Z Shapes have the Duration option to span the change over a certain period of time. Other options will change with the Trigger Type.
- Trigger Type: The type of event that will trigger the Z modification.
- Specified time: Triggers at a specific time during the simulation, measured in hours.
- Water level at point: Uses a Trigger Point to measure water level, and triggers when the water level reaches or exceeds the value in the Water level field.
- Water level difference: Uses two trigger points. Triggers when the difference between water levels measured at both points exceeds the value in Water level difference. A difference in either direction is treated the same in TUFLOW, and there is no need for negative numbers.
- Thin line water level: Similar to Water level at point, but for thin lines. Does not use a trigger point, instead measuring the water levels on either side of the thin line.
- Thin line water level difference: Triggers when the difference between water levels on either side of the thin line reaches or exceeds the value in Water level difference.
- Point1 and Point2: Both point selection boxes list the trigger points available in the coverage. These fields are only enabled for trigger types that use them.
- Specified time, Water level, Water level difference: These fields become available based on the trigger type selected.
- Duration: If set to 0, changes are instantaneous once triggered. Otherwise the change will be interpolated over this many hours.
- Restore Z Shape: This option can be used to have TUFLOW restore the original elevations at a specified time.
- Repeat restoration: The z-shape will be restored indefinitely.
- Restore interval: The time (hrs) between when the variable z-shape is finished and when to start restoring the points back to their original values.
- Restore period: The time (hrs) needed to restore the points back to their original values.
Trigger Points
Trigger points are used by the Water level at point and Water level difference trigger types. Simply create a feature point and enter its attributes dialog to create a trigger point.
Trigger Point Dialog
The trigger point dialog is used to turn a feature point into a ZShape trigger point. Enabling the Specify Trigger checkbox and giving the point a name will cause it to appear in the Point1 and Point2 selection boxes in the arc attributes dialog for use as a trigger point. If renaming a trigger point that is being used by triggers, or delete it by unchecking Specify Trigger, SMS will notify that there are one or more arcs/polygons being updated with the new change.
2D Z Lines/Polygons (Simple) Coverage
These coverages are used as geometry modifications and force grid elevation values using arcs or polygons. This can be useful to ensure ridge or gully lines are represented in the model, simulate a proposed levy, or to simulate a proposed fill/excavation scenario.
It is possible to only have the elevations assigned from a feature object if the feature elevation is higher or lower (user specified) than the existing elevations in the grid. This is controlled in the 2D Z Lines/Polygons (Simple) Coverage Properties dialog (right-click on the coverage and choose Properties). The options specified in the coverage properties dialog apply to any geometry modification arcs and polygons within the coverage. If wanting to use multiple settings within a simulation, there must be multiple 2D z line/polygon (simple) coverages.
Z Values
The z values determine how the elevations in the coverage are used to modify the existing model elevations. The options are:
- All Zpts (default) – The z values from all of the arcs/polygons are used.
- Min – The z values from the arcs/polygons will only overwrite the existing elevations if the elevations are lower.
- Max – The z values from the arcs/polygons will only overwrite the existing elevations if the elevations are higher.
- Add – The z value becomes the existing elevation plus the z value from the arc/polygon (which may be negative).
Thick Arcs
If this option is not selected, the z values of the arc will be applied to the nearest elevation locations in each cell that the arc passes through. Otherwise, the arc elevations will be applied to every elevation location in each cell that the arc passes through.
Make sure the coverage is in the Geometry Component(s) that is to be applied to the modification.
Points
Points are ignored in the geometry modification coverage.
Arcs
Only the elevations at the nodes (endpoints) are used to set the grid elevations. Vertex (intermediate) elevations are ignored. Cell elevations along the arc will be interpolated linearly based on distance from the endpoint elevation. If wanting to specify elevations at vertices on an arc, convert the arc vertices to nodes to create multiple arcs joined end to end.
Polygons
To set the elevation for polygons double-click on the polygon and enter the elevation in the Polygon Elevation dialog. This elevation will be applied to all cells within the polygon. This dialog can also be accessed by right-clicking on a polygon and selecting Attributes for the right-click menu.
- File:TUFLOW Z Value.jpgTUFLOW Polygon Elevation dialog
Clip Region Read TIN Z pts Coverage
Using a coverage to specify a clip region, makes it so only elevations within coverage polygons are changed by a TIN dragged under a 2D geometry component. This is particularly useful for clipping out a TIN due to unwanted or irregular triangulation around the periphery, especially for secondary TINs of proposed developments lying within the primary TIN.
To use this coverage, create a coverage with one or more polygons. Only areas within polygons and within the TIN boundaries will have elevations assigned. There must be a scatter set in the 2D Geometry Components. Then drag and drop this coverage under the scatter tree item, under the 2D Geometry Components.
Water Level Lines Coverage
Water level line coverages define the locations where 1D solutions will be written as 2D output. TUFLOW creates water level points along the water level lines. The water level lines in conjunction with the water level points guide TUFLOW on how to represent the 1D flow in the 2D domain.
Arcs are the only objects used in the water level lines coverage. The only attribute in the water level lines coverage is the minimum distance between water level points. This is used by TUFLOW to generate the water level points along the arcs. To change this attribute, double-click on an arc or right-click and select Attributes from the right-click menu. This brings up the Water Level Arc Attributes dialog.
For more information about how TUFLOW uses water level lines to generate 2D flows see TUFLOW Water Level Points Coverage.
Water Level Points Coverage
Water level points are used in conjunction with water level lines to guide TUFLOW on creating 2D output for 1D networks (see TUFLOW Water Level Lines Coverage).
Water level points store a material value. This material value along with the z location of each point is used by TUFLOW to better approximate 2D flow along a water level line. TUFLOW performs a parallel channel analysis so that flow rates reported in the 2D output vary based upon the depth and roughness of a channel. Areas that are more rough and shallow than other areas will have a smaller flow rate than other areas along the same water level line.
The material value for each point can be mapped from an area property coverage by right-clicking on the coverage tree item and selecting Materials for Area Coverage. By default the elevation of each point is based upon the neighboring cross-section information.
Creating the Water Level Points Coverage
The initial water level points coverage data is created by TUFLOW during a run. Once a run has been completed, the data can be read from the check file that starts with the simulation name and ends with _WLLp_check.mif (see TUFLOW check files). Open this file from SMS and select TUFLOW WLL Points from the combo-box that comes up. This coverage now can be included in simulations to provide additional guidance to TUFLOW in distributing 1D flows.
Related Topics
SMS – Surface-water Modeling System | ||
|---|---|---|
| Modules: | 1D Grid • Cartesian Grid • Curvilinear Grid • GIS • Map • Mesh • Particle • Quadtree • Raster • Scatter • UGrid |  |
| General Models: | 3D Structure • FVCOM • Generic • PTM | |
| Coastal Models: | ADCIRC • BOUSS-2D • CGWAVE • CMS-Flow • CMS-Wave • GenCade • STWAVE • WAM | |
| Riverine/Estuarine Models: | AdH • HEC-RAS • HYDRO AS-2D • RMA2 • RMA4 • SRH-2D • TUFLOW • TUFLOW FV | |
| Aquaveo • SMS Tutorials • SMS Workflows | ||
