Template:Arcs from UGrid Points: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
__NOTOC__
__NOTOC__
===Arcs from UGrid Points===
===Arcs from Points===
The ''Arcs from UGrid Points'' tool can be used to find clusters of points on a UGrid that are close to each other and convert these clusters to arcs.
The ''Arcs from Points'' tool creates a set of arcs which connect naturally neighboring points in a point set into arcs/polylines.  The point set can be provided in the form of a set of scatter points vertices, mesh nodes, or UGrid pointsa new coverage consisting of arcs is created and loaded into the XMS project.


For example, one use case might be to take a set of cross section survey points and convert these points to cross section lines as shown in the images below:
The user provides a set of points that should be connected into arcs. The user also specifies the number of nearest neighbors to check for connections. Additionally, the user has an option to specify a maximum distance to be considered a connection point.
The tool works by finding the closest N neighbors, based on the N value specified by the user and the distance to each of these neighbors. It then starts with the closest points and builds arcs by finding neighboring points that are closest to each other.


:[[Image:roundup1.png|thumb|none|500 px| UGrid points from a cross section survey.]]
Two example applications of this tool include:
* This tool can be used to create cross sections from disjoint survey points
* This tool can be used to create a levee centerline from survey points along the crest


:[[Image:roundup2.png|thumb|none|500 px| Arcs generated from the UGrid survey points using the Arcs from UGrid Points tool.]]
:[[File:roundup1.png|thumb|none|400px|Scatter points from a cross section survey]]
:[[File:roundup2.png|thumb|none|400px|Arcs generated from the scatter points using the ''Arcs from Points'' tool]]


====Input Parameters====
====Input Parameters====
*''Input grid'' – The input UGrid or mesh to process.
*''Input grid'' – geometry (scatter set, 2D mesh, UGrid) - This parameter is the geometry that provides the point locations that are to be connected into arcs.
*''Number of nearest neighbors'' – The number of nearest neighboring points to check.
*''Number of nearest neighbors'' – An integer which must be 2 or greater. The lower the number, the faster the algorithm works. As the number increases, more potential connections can be found. The default is 5 which should be sufficient for almost all cases.
*''Connect isolated points'' – Whether to connect isolated points.
*''Connect isolated points'' – boolean - this enables an option to connect disjoint nodes into the nearest arc at the end the arc definition process. This defaults to off. It was included for a customized workflow and generally should not be enabled. In the future, this may be expanded to allow the creation of networks.
*''Enforce max distance'' – Whether to enforce the maximum distance between points.
*''Enforce max distance'' – boolean - this turns on the use of a maximum distance to find neighbors. If the option, which defaults to OFF is not enabled, the maximum distance parameter is not used.
*''Max distance'' – The maximum distance between points.
*''Max distance'' – The maximum distance over which the tool will look for neighboring points to connect into an arc. If the enforce maximum distance option is enabled, even when two points are closest to each other, they are only connected if the distance between them is less than the specified maximum.  


====Output Parameters====
====Output Parameters====
*''Output coverage name'' – The name of the output coverage.
*''Output coverage name'' – The new coverage that will be created to contain the arcs


====Current Location in toolbox====  
====Current Location in toolbox====  
Coverages/Arcs from UGrid Points
Coverages/Arcs from Points
{{-}}
{{-}}
<noinclude>[[Category:Toolbox]][[Category:External Links]]</noinclude>
<noinclude>[[Category:Toolbox Coverages]]</noinclude>

Latest revision as of 19:28, 28 June 2024


Arcs from Points

The Arcs from Points tool creates a set of arcs which connect naturally neighboring points in a point set into arcs/polylines. The point set can be provided in the form of a set of scatter points vertices, mesh nodes, or UGrid points, a new coverage consisting of arcs is created and loaded into the XMS project.

The user provides a set of points that should be connected into arcs. The user also specifies the number of nearest neighbors to check for connections. Additionally, the user has an option to specify a maximum distance to be considered a connection point. The tool works by finding the closest N neighbors, based on the N value specified by the user and the distance to each of these neighbors. It then starts with the closest points and builds arcs by finding neighboring points that are closest to each other.

Two example applications of this tool include:

  • This tool can be used to create cross sections from disjoint survey points
  • This tool can be used to create a levee centerline from survey points along the crest
Scatter points from a cross section survey
Arcs generated from the scatter points using the Arcs from Points tool

Input Parameters

  • Input grid – geometry (scatter set, 2D mesh, UGrid) - This parameter is the geometry that provides the point locations that are to be connected into arcs.
  • Number of nearest neighbors – An integer which must be 2 or greater. The lower the number, the faster the algorithm works. As the number increases, more potential connections can be found. The default is 5 which should be sufficient for almost all cases.
  • Connect isolated points – boolean - this enables an option to connect disjoint nodes into the nearest arc at the end the arc definition process. This defaults to off. It was included for a customized workflow and generally should not be enabled. In the future, this may be expanded to allow the creation of networks.
  • Enforce max distance – boolean - this turns on the use of a maximum distance to find neighbors. If the option, which defaults to OFF is not enabled, the maximum distance parameter is not used.
  • Max distance – The maximum distance over which the tool will look for neighboring points to connect into an arc. If the enforce maximum distance option is enabled, even when two points are closest to each other, they are only connected if the distance between them is less than the specified maximum.

Output Parameters

  • Output coverage name – The new coverage that will be created to contain the arcs

Current Location in toolbox

Coverages/Arcs from Points