NeighborPairFinder

Finds the closest two Candidate features within some maximum distance of each Base feature and some minimum separation in heading between the Candidates and the Base.

If no, or only one, Candidate feature is found to be within the maximum distance, then the Base feature will be output unchanged via the UnmatchedBase port.

If two Candidates are found, then the Base feature is output via the MatchedBase port.  In this case, the following attributes will be added to the Base feature:

(The attributes ending in 1 relate to the closest Candidate feature found.  The attributes ending in 2 relate to the next closest Candidate feature found, which has a sufficiently different heading.)

All headings are measured in degrees counterclockwise from horizontal.  All distances are measured in the ground units of the features.

The ClosestVector and SecondClosestVector ports will have linear features output on them that connect the closest points on the base and candidate features.  These ports are useful only for visualizing where the closest points were found.

Invalid features (such as extra candidates) are output via the <Rejected> port. Base and candidate features with null geometries will be rejected.

Rejected features will have an fme_rejection_code attribute with one of the following values: EXTRA_CANDIDATE_FEATURE, INVALID_BASE_GEOMETRY_VERTICES, INVALID_CANDIDATE_GEOMETRY_VERTICES, INVALID_GEOMETRY_VERTICES.

Configuration

Parameters

Editing Transformer Parameters

Transformer parameters can be set by directly entering values, using expressions, or referencing other elements in the workspace such as attribute values or user parameters. Various editors and context menus are available to assist. To see what is available, click beside the applicable parameter.

For more information, see Transformer Parameter Menu Options.

Reference

Processing Behavior

Feature-Based

Feature Holding

Yes

Dependencies None
Aliases NeighbourPairFinder
History  

FME Community

The FME Community has a wealth of FME knowledge with over 20,000 active members worldwide. Get help with FME, share knowledge, and connect with users globally.

Search for all results about the NeighborPairFinder on the FME Community.

 

Examples may contain information licensed under the Open Government Licence – Vancouver, Open Government Licence - British Columbia, and/or Open Government Licence – Canada.