nearby function

nearby geometries

nearby geometries

Identify geometries that are near to each other. Either get the index of all geometries within a certain distance, or the k nearest neighbors, or (with nearest) get the nearest points between two geometries. methods

## S4 method for signature 'SpatVector' nearby(x, y=NULL, distance=0, k=1, centroids=TRUE, symmetrical=TRUE, method="geo") ## S4 method for signature 'SpatVector' nearest(x, y, pairs=FALSE, centroids=TRUE, lines=FALSE, method="geo")

Arguments

  • x: SpatVector
  • y: SpatVector or NULL
  • distance: numeric. maximum distance
  • k: positive integer. number of neighbors. Ignored if distance > 0
  • centroids: logical. Should the centroids of polygons be used?
  • symmetrical: logical. If TRUE, a near pair is only included once. That is, if geometry 1 is near to geometry 3, the implied nearness between 3 and 1 is not reported. Ignored if k neighbors are returned
  • method: character. One of "geo", "haversine", "cosine". With "geo" the most precise but slower method of Karney (2003) is used. The other two methods are faster but less precise
  • pairs: logical. If TRUE pairwise nearest points are returned (only relevant when using at least one SpatVector of lines or polygons
  • lines: logical. If TRUE lines between the nearest points instead of (the nearest) points

See Also

distance, relate, adjacent

Returns

matrix

Examples

f <- system.file("ex/lux.shp", package="terra") v <- vect(f) nearby(v, distance=12000)
  • Maintainer: Robert J. Hijmans
  • License: GPL (>= 3)
  • Last published: 2025-02-26