rjitter

0th

Percentile

Random Perturbation of a Point Pattern

Applies independent random displacements to each point in a point pattern.

Keywords
spatial, datagen
Usage
rjitter(X, radius, retry=TRUE, giveup = 10000)
Arguments
X
A point pattern (object of class "ppp").
radius
Scale of perturbations. A positive numerical value. The displacement vectors will be uniformly distributed in a circle of this radius.
retry
What to do when a perturbed point lies outside the window of the original point pattern. If retry=FALSE, the point will be lost; if retry=TRUE, the algorithm will try again.
giveup
Maximum number of unsuccessful attempts.
Details

Each of the points in the point pattern X is subjected to an independent random displacement. The displacement vectors are uniformly distributed in a circle of radius radius.

If a displaced point lies outside the window, then if retry=FALSE the point will be lost.

However if retry=TRUE, the algorithm will try again: each time a perturbed point lies outside the window, the algorithm will reject it and generate another proposed perturbation of the original point, until one lies inside the window, or until giveup unsuccessful attempts have been made. In the latter case, any unresolved points will be included without any perturbation. The return value will always be a point pattern with the same number of points as X.

Value

  • A point pattern (object of class "ppp") in the same window as X.

Aliases
  • rjitter
Examples
X <- rsyst(owin(), 10, 10)
   Y <- rjitter(X, 0.02)
   plot(Y)
Documentation reproduced from package spatstat, version 1.17-0, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.