spatstat.geom (version 2.1-0)

pixelcentres: Extract Pixel Centres as Point Pattern

Description

Given a pixel image or binary mask window, extract the centres of all pixels and return them as a point pattern.

Usage

pixelcentres(X, W = NULL, ...)

Arguments

X

Pixel image (object of class "im") or window (object of class "owin").

W

Optional window to contain the resulting point pattern.

Optional arguments defining the pixel resolution.

Value

A point pattern (object of class "ppp").

Details

If the argument X is a pixel image, the result is a point pattern, consisting of the centre of every pixel whose pixel value is not NA.

If X is a window which is a binary mask, the result is a point pattern consisting of the centre of every pixel inside the window (i.e. every pixel for which the mask value is TRUE).

Otherwise, X is first converted to a window, then converted to a mask using as.mask, then handled as above.

See Also

raster.xy

Examples

# NOT RUN {
  pixelcentres(letterR, dimyx=5)
# }