GetNaturalNeighbors Method

In This Topic

Gets the set of nodes that are the natural neighbors of the specified point. The natural neighbors of a point are the nodes it would connect with to form triangles if it were inserted in the triangulation. They are the closest surrounding nodes in all directions. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Function GetNaturalNeighbors( _
   ByVal point As MapPoint _
) As IReadOnlyList(Of TinNode)

public IReadOnlyList<TinNode> GetNaturalNeighbors( 
   MapPoint point
)

Parameters

point: Point location. This will be projected into the spatial reference of the TIN dataset.

Return Value

A IReadOnlyList of TinNode

Exceptions

Exception	Description
System.ArgumentNullException	Point is null
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run

Remarks

If the input point is outside of the TIN or empty, then an empty list is returned.

Example

Access TIN Elements by MapPoint

{
  // "identify" the closest node, edge, triangle
  using (var nearestNode = tinDataset.GetNearestNode(mapPoint))
  {
    // do something with the node
  }

  using (var nearestEdge = tinDataset.GetNearestEdge(mapPoint))
  {
    // do something with the edge
  }
  using (var triangleByPoint = tinDataset.GetTriangleByPoint(mapPoint))
  {
    // do something with the triangle
  }

  // get the set of natural neighbors 
  // (set of nodes that "mapPoint" would connect with to form triangles if it was added to the TIN)
  IReadOnlyList<ArcGIS.Core.Data.Analyst3D.TinNode> naturalNeighbors = tinDataset.GetNaturalNeighbors(mapPoint);

  // get the set of triangles whose circumscribed circle contains "mapPoint" 
  IReadOnlyList<ArcGIS.Core.Data.Analyst3D.TinTriangle> triangles = tinDataset.GetTriangleNeighborhood(mapPoint);
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.2 or higher.

Reference

TinDataset Class
TinDataset Members

Send feedback