Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

distmap.ppp

Distance Map of Point Pattern


Description

Computes the distance from each pixel to the nearest point in the given point pattern.

Usage

## S3 method for class 'ppp'
distmap(X, ...)

Arguments

X

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

...

Arguments passed to as.mask to control pixel resolution.

Details

The “distance map” of a point pattern X is the function f whose value f(u) is defined for any two-dimensional location u as the shortest distance from u to X.

This function computes the distance map of the point pattern X and returns the distance map as a pixel image. The greyscale value at a pixel u equals the distance from u to the nearest point of the pattern X.

Additionally, the return value has two attributes, "index" and "bdry", which are also pixel images. The grey values in "bdry" give the distance from each pixel to the bounding rectangle of the image. The grey values in "index" are integers identifying which point of X is closest.

This is a method for the generic function distmap.

Note that this function gives the distance from the centre of each pixel to the nearest data point. To compute the exact distance from a given spatial location to the nearest data point in X, use distfun or nncross.

Value

A pixel image (object of class "im") whose greyscale values are the values of the distance map. The return value has attributes "index" and "bdry" which are also pixel images.

Author(s)

and Rolf Turner r.turner@auckland.ac.nz

See Also

Generic function distmap and other methods distmap.psp, distmap.owin.

Generic function distfun.

Nearest neighbour distance nncross

Examples

data(cells)
  U <- distmap(cells)
  if(interactive()) {
  plot(U)
  plot(attr(U, "bdry"))
  plot(attr(U, "index"))
  }

spatstat.geom

Geometrical Functionality of the 'spatstat' Family

v2.1-0
GPL (>= 2)
Authors
Adrian Baddeley [aut, cre], Rolf Turner [aut], Ege Rubak [aut], Tilman Davies [ctb], Ute Hahn [ctb], Abdollah Jalilian [ctb], Sebastian Meyer [ctb], Suman Rakshit [ctb], Dominic Schuhmacher [ctb], Rasmus Waagepetersen [ctb]
Initial release
2021-04-15

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.