Distance Map as a Function

Compute the distance function of an object, and return it as a function.

spatial, math
distfun(X, ...)
  ## S3 method for class 'ppp':
distfun(X, ...)
  ## S3 method for class 'psp':
distfun(X, ...)
  ## S3 method for class 'owin':
distfun(X, ..., invert=FALSE)
Any suitable dataset representing a two-dimensional object, such as a point pattern (object of class "ppp"), a window (object of class "owin") or a line segment pattern (object of class "psp").
Extra arguments are ignored.
If TRUE, compute the distance transform of the complement of X.

The distance function of a set of points $A$ is the mathematical function $f$ such that, for any two-dimensional spatial location $(x,y)$, the function value f(x,y) is the shortest distance from $(x,y)$ to $A$.

The command f <- distfun(X) returns a function in the Rlanguage, with arguments x,y, that represents the distance function of X. Evaluating the function f in the form v <- f(x,y), where x and y are any numeric vectors of equal length containing coordinates of spatial locations, yields the values of the distance function at these locations.

This should be contrasted with the related command distmap which computes the distance function of X on a grid of locations, and returns the distance values in the form of a pixel image.

A distfun object can be converted to a pixel image using as.im.


  • A function with arguments x,y. The function also belongs to the class "distfun" for which there are methods for print, plot, contour and persp.

See Also

distmap, plot.distfun

  • distfun
  • distfun.ppp
  • distfun.psp
  • distfun.owin
   f <- distfun(letterR)
   f(0.2, 0.3)
Documentation reproduced from package spatstat, version 1.25-1, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.