join_near_values function

relational-functions join_near_values

syntax

• join_near_values(geometry_first, geometry_second, dist)

definition

join_near_values(geometry_first, geometry_second, dist) results in a uint32 domain-unit that represents each combination of geometry_first and geometry_second for which the distance is less than the configured dist parameter.
The function results in two subitems being attributes of this domain:

• first_rel : the index-numbers of each row of the domain-unit of the first geometry with a distance to the second geometry of less than the configured dist attribute.
• second_rel : the index-numbers of each row of the domain-unit of the second geometry with a distance to the first geometry of less than the configured dist attribute.

applies to

• geometry_first: a point data-item
• geometry_second: a point data-item
• dist: a float64 parameter

conditions

1. The values-unit of the arguments: geometry_first and geometry_second must match.
2. The domain-unit of the arguments: geometry_first and geometry_second must be zero based.

example

unit<uint32> ZipCodesNearby_m50 := join_near_values(zipcode/geometry, zipcode/geometry, 50d);

domain ZipCodesNearby_m50 , nr of rows = 5