poly.outer: Create a masking polygon to block out graphics outside a...

In GISTools: Further Capabilities in Geographic Information Science

Create a masking polygon to block out graphics outside a region.

Description

Takes a polygon object and creates a new polygon whose outline is rectangular, but has a hole shaped like the input polygon cut into it. This is useful for plotting surfaces defined over a study area, but masking the values outside of the area. It is designed to work with pixel images, so that the mask covers up all parts of the image not in the input polygon.

Usage

poly.outer(exo.object,input.poly,extend=0)

Arguments

exo.object	The object extending beyond input.poly that is to be masked. This is required to ensure that the external rectangle of the mask will be large enough.
input.poly	The polygon used to make the hole in the mask.
extend	A buffer used to extend the mask if it is required to be larger than exo.object

Value

A polygon object whose outline is rectangular, but having holes cut into it in the shape of input.poly

Author(s)

Chris Brunsdon, Binbin Lu

See Also

add.masking, kde.points.

Examples

  
# Data for New Haven to use in example
data(newhaven)
# Do the KDE
breach.dens = kde.points(breach,lims=tracts)
# Plot the result
level.plot(breach.dens)
# Block out the part outside the study area
masker = poly.outer(breach.dens,tracts,extend=100); add.masking(masker)
# Plot census tract boundaries
plot(tracts,add=TRUE)

GISTools documentation built on Oct. 3, 2024, 1:08 a.m.