dneigh {elsa}R Documentation

Construct neighbours list

Description

This function identifies the neighbours features (points or polygons) given the specified distance (in kilometer for geographic coordinates, i.e., if longlat=TRUE; and in the map unit for projected datasets, i.e., if longlat = FALSE) and builds a list of neighbours.

The neighd function returns a list including distance of each feature to neighbourhood locations.

Usage

dneigh(x,d1,d2,longlat,method,...)

neighd(x,d1,d2,longlat,...)

Arguments

x

a SpatialPoints, or SpatialPolygons or a matrix (or data.frame) of point coordinates or a SpatialPoints object

d1

lower local distance bound (if longlat = TRUE, in kilometer; otherwise in the spatial unit of the dataset, e.g., meter)

d2

upper local distance bound (if longlat = TRUE, in kilometer; otherwise in the spatial unit of the dataset, e.g., meter)

longlat

TRUE if point coordinates are longitude-latitude

method

if x is SpatialPolygons, specifies the method to identify the neighbour polygons; see details

...

additional arguments; see details

Details

The function is mostly based on dnearneigh (for points), and poly2nb (for polygons), implemented in the spdep package by Roger Bivand.

When x is SpatialPolygons, there is two methods (can be specified through method) to identify the neighbour polygons. The default method ('bound') seeks the polygons that has one or more points in their boundaries within the specified distance (d), while the method 'centroid' considers any polygon with a centriod within the given distance.

One additional argument is queen (default is TRUE), can beused only when x is SpatialPolygons, and method='bound', if TRUE, a single shared boundary point meets the contiguity condition, if FALSE, more than one shared point is required.

neighd for SpatialPolygons returns distances of each polygon to centroids of neighbor polygons.

Value

An object of class neighbours

Author(s)

Babak Naimi naimi.b@gmail.com

http://r-gis.net

References

Naimi, B., Hamm, N. A., Groen, T. A., Skidmore, A. K., Toxopeus, A. G., & Alibakhshi, S. (2019). ELSA: Entropy-based local indicator of spatial association. Spatial statistics, 29, 66-88.

Examples

#

[Package elsa version 1.1-28 Index]