Template:CMS-Flow Hard Bottom Dataset: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(Created page with "__NOINDEX__ __NOTOC__ ===Polygons from Arcs=== <!--====Tool Description====--> The ''CMS-Flow Hard Bottom Dataset'' tool converts all arcs in a coverage to polygons based on specified parameters. This tool is designed to simplify the creation of linear polygons to represent features such as channels or embankments. The feature extraction operations create stream or ridge networks. These features can be used to position cells/elements in a mesh/UGrid to honor these featu...")
 
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
__NOTOC__
__NOTOC__
===Polygons from Arcs===
===CMS-Flow Hard Bottom Dataset===
<!--====Tool Description====-->
<!--====Tool Description====-->
The ''CMS-Flow Hard Bottom Dataset'' tool converts all arcs in a coverage to polygons based on specified parameters.
The ''CMS-Flow Hard Bottom Dataset'' tool generates a cell based dataset on a CMS-Flow grid that may be used as the hard bottom for a CMS-Flow simulation.


This tool is designed to simplify the creation of linear polygons to represent features such as channels or embankments. The feature extraction operations create stream or ridge networks. These features can be used to position cells/elements in a mesh/UGrid to honor these features. However, it is often useful to represent such linear features as Patch polygons to allow or anisotropic cells&mdash;elongated in the direction of the feature.
This tool is used with a CMS-Flow "Hard Bottom" coverage where the user can specify different types of polygons that are applied to the UGrid to create the hard bottom dataset.


Each arc in the input polygon will be converted to a polygon. The following applies during the creating process:
Three different types of polygons may be assigned to the coverage:
*The polygon for isolated lines/arcs will consist of offset lines in both directions from the arc. The ends of the polygon will be perpendicular to the end segment of the arc.  
# Non-erodible cell
*If two arcs are connected (end to end), the orientation of the two polygons will be averaged so that the polygons share and "end".  
## The hard bottom dataset value is set to the cell elevation.
*If three arcs/lines join at a node, the two that have the most similar direction will be maintained as a continuous feature. The third will be trimmed back to not encroach on the polygons of the other two. If more than three arcs/lines join at a single location, the two arcs with the most similar direction will define the preserved direction. All other arcs will be trimmed back to not encroach.
# Specified distance erodible cell
* If a single arc closes in a loop, the resulting polygon closes on itself. This polygon will not function as a patch in SMS. This workflow is not recommended.
## The hard bottom dataset value is set to the cell elevation minus the specified distance associated with the polygon. For example, the cell has an elevation of -4.5 and the specified erodible distance is set to 1.0, the hard bottom value would be -5.5.
* The tool performs a check to determine if the polygons from two unconnected overlap/intersect each other. This is reported in the progress dialog.
# Specified depth erodible cell
## The hard bottom dataset value is set to the specified depth associated with the polygon. This value is interpreted as an elevation (Z).


====Input Parameters====
====Input Parameters====
* ''Input coverage'' &ndash; This can be any map coverage in the project. The arcs in the coverage will be used to guide polygon creation.
* ''Target UGrid'' &ndash; The UGrid that is being used in the CMS-Flow simulation. This grid must have elevations defined at cells.
* ''Average element/cell width'' &ndash; This defines the average width of the segments projecting perpendicular from the arc. The units (foot/meter) correspond to the display projection of SMS.
* ''Input hard bottom coverage containing polygons'' &ndash; The hard bottom coverage.
* ''Number of elements/cells (must be even)'' &ndash; This defines the number of segments projecting in each direction from the centerline. Because it is projected in both directions, it must be even.
* ''Bias (0.01-100.0)'' &ndash; This provides control of the relative length of the segments across the feature. In this case, it is actually a double bias because both sides of the feature are biased from the outer edges to the center. Therefore, a bias less than 1.0 results in segments that are shorter at the center. A bias greater than 1.0 results in segments that are longer at the center. Specify a small bias to improve representation of the channel bottom or embankment crest and a larger bias to increase resolution (representation) or the outer edge (shoulder or toes) of the feature. See images below for examples.


====Output Parameters====
====Output Parameters====
* ''Output coverage'' &ndash; Specify the name of the coverage to be created that will contain the generated polygons. The intent of this coverage is to be incorporate into a mesh generation coverage for the domain. The resulting coverage will have the Area Property coverage and will need to be changed to the desired coverage type.
* ''Hard bottom dataset name'' &ndash; Specify the name of the output dataset.


====Current Location in Toolbox====  
====Current Location in Toolbox====  
CMS-Flow/CMS-Flow Hard Bottom Dataset
CMS-Flow/CMS-Flow Hard Bottom Dataset

Revision as of 16:07, 3 September 2024


CMS-Flow Hard Bottom Dataset

The CMS-Flow Hard Bottom Dataset tool generates a cell based dataset on a CMS-Flow grid that may be used as the hard bottom for a CMS-Flow simulation.

This tool is used with a CMS-Flow "Hard Bottom" coverage where the user can specify different types of polygons that are applied to the UGrid to create the hard bottom dataset.

Three different types of polygons may be assigned to the coverage:

  1. Non-erodible cell
    1. The hard bottom dataset value is set to the cell elevation.
  2. Specified distance erodible cell
    1. The hard bottom dataset value is set to the cell elevation minus the specified distance associated with the polygon. For example, the cell has an elevation of -4.5 and the specified erodible distance is set to 1.0, the hard bottom value would be -5.5.
  3. Specified depth erodible cell
    1. The hard bottom dataset value is set to the specified depth associated with the polygon. This value is interpreted as an elevation (Z).

Input Parameters

  • Target UGrid – The UGrid that is being used in the CMS-Flow simulation. This grid must have elevations defined at cells.
  • Input hard bottom coverage containing polygons – The hard bottom coverage.

Output Parameters

  • Hard bottom dataset name – Specify the name of the output dataset.

Current Location in Toolbox

CMS-Flow/CMS-Flow Hard Bottom Dataset