R: nearby geometries

nearest {terra} | R Documentation

## nearby geometries

### Description

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 closest points between two geometries.

### Usage

    ## S4 method for signature 'SpatVector'
    nearby(x, distance=0, k=1, centroids=TRUE, symmetrical=TRUE)

    ## S4 method for signature 'SpatVector'
    nearest(x, y, pairs=FALSE, centroids=TRUE, lines=FALSE)

### Arguments

`x` | SpatVector
`y` | SpatVector
`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
`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

### Value

matrix

### See Also

`relate`, `adjacent`

### Examples

    f <- system.file("ex/lux.shp", package="terra")
    v <- vect(f)
    nearby(v, distance=12000)

[Package terra version 1.2-5 Index]