ITinAdvanced.FindNaturalNeighbors Method

Returns the immediate surrounding nodes to the query point.

[Visual Basic .NET]
Public Function FindNaturalNeighbors ( _
    ByVal pPoint As IPoint _
) As ITinNodeArray

[C#]
public ITinNodeArray FindNaturalNeighbors (
    IPoint pPoint
);

[C++]
HRESULT FindNaturalNeighbors(
  IPoint* pPoint,
  ITinNodeArray** ppNodes
);

[C++]

Parameters
pPoint [in]

  pPoint is a parameter of type IPoint
ppNodes [out, retval]

  ppNodes is a parameter of type ITinNodeArray

Product Availability

Description

Returns an array of nodes that are the natural neighbors of the input query point.

The natural neighbors of a given query 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.

In most cases, the number of neighboring nodes is small. It averages around 6 to 8. Depending on the data distribution and the location of the query point it can be much larger though.

If the query point is coincident with an existing node then that node's neighbors will be returned.

Returns a null pointer ('Nothing' in VB) if the result is an empty set. This will occur when the query point falls outside the triangulation.

The TIN must be Delaunay.

See Also