SMS:TUFLOW Coverages

From XMS Wiki
Jump to navigationJump to search


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).

2D Materials Coverage

On this coverage polygons can be created to define material areas. This is the same as the Area Properties Coverage.

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 Select Boundary Condition Coverage dialog
TUFLOW 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.

File:TUFLOW Cross-Section.jpg
TUFLOW Cross Section dialog

1D Network Coverage

File:TUFLOW Channel Attributes.jpg
TUFLOW Channel Attributes dialog

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.
The TUFLOW Create Cross Section Arcs dialog
The TUFLOW Create Water Level Arcs dialog

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.

See TUFLOW ZShape for more information.

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.

File:TUFLOW Z Values Options.jpg
TUFLOW 2D Z Lines/Polygons (Simple) Coverage Properties Z Values Options dialog

Z Values

The z values determine how the elevations in the coverage are used to modify the existing model elevations. The options are:

  1. All Zpts (default) – The z values from all of the arcs/polygons are used.
  2. Min – The z values from the arcs/polygons will only overwrite the existing elevations if the elevations are lower.
  3. Max – The z values from the arcs/polygons will only overwrite the existing elevations if the elevations are higher.
  4. 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

File:TUFLOW Choose Arc Type.jpg
TUFLOW Choose Arc Type dialog

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.jpg
TUFLOW 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

File:TUFLOW Water Level Arc Att.jpg
TUFLOW Water Lever Arc Attributes dialog

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