# rjitter

##### Random Perturbation of a Point Pattern

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

##### 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`

.

##### Examples

```
X <- rsyst(owin(), 10, 10)
Y <- rjitter(X, 0.02)
plot(Y)
```

*Documentation reproduced from package spatstat, version 1.17-1, License: GPL (>= 2)*