voro_polygon: Calculate Voronoi polygons for a set of points

In RichDeto/EPP: Evaluation of Proximity Programs

Calculate Voronoi polygons for a set of points

Description

Calculate Voronoi polygons from a SpatialPoints object

Usage

voro_polygon(x, bounding.polygon = NULL, range.expand = 0.1)

Arguments

x	A SpatialPoints or SpatialPointsDataFrame object
bounding.polygon	If present, this is a SpatialPolygons object specifying the bounding polygon(s) for the Voronoi polygons, and make the Voronoi polygons to be clipped to the outside bounding polygon. The outside bounding polygon is the union of all polygons in bounding.polygon. If this is not present, the Voronoi polygons extend to a rectangle that is range.expand beyond the bounding box of input points in all directions.
range.expand	A length-one or length-two vector of expansion factors for the bounding box of points in x in the horizontal and vertical directions. If length = 1, it is replicated to length two. Element one is the fraction of the bounding box's horizontal width that is added and subtracted to the horizontal extent of the output polygons. Element two is the fraction of the bounding box's vertical height that is added and subtracted to the vertical extent of the output polygons. Only this parameter's absolute value is used. If bounding.polygon is present, this parameter is ignored.

Details

This is a convenience routine for the deldir::deldir function. The hard work, computing the Voronoi polygons, is done by the deldir::deldir and deldir::tile.list functions. See documentation for those functions for details of computations.

This function is convenient because it takes a SpatialPoints object and returns a SpatialPolygonsDataFrame object.

Value

A SpatialPolygonsDataFrame containing the Voronoi polygons surrounding the points in x. Attributes of the output polygons are:

x	The horizontal coordinate of the tessellation's defining point
y	The vertical coordinate of the tessellation's defining point
area	Area of tessellation, in units of x's projection.

Examples

x <- sp::SpatialPoints(centers_epp[ ,1:2])
centers_voro <- voro_polygon(x)

RichDeto/EPP documentation built on May 5, 2022, 10:23 p.m.