rlabel

0th

Percentile

Random Re-Labelling of Point Pattern

Randomly allocates marks to a point pattern, or permutes the existing marks, or resamples from the existing marks.

Keywords
spatial, datagen
Usage
rlabel(X, labels=marks(X), permute=TRUE)
Arguments
X
Point pattern (object of class "ppp", "lpp", "pp3" or "ppx").
labels
Vector of values from which the new marks will be drawn at random. Defaults to the vector of existing marks.
permute
Logical value indicating whether to generate new marks by randomly permuting labels or by drawing a random sample with replacement.
Details

This very simple function allocates random marks to an existing point pattern X. It is useful for hypothesis testing purposes.

In the simplest case, the command rlabel(X) yields a point pattern obtained from X by randomly permuting the marks of the points.

If permute=TRUE, then labels should be a vector of length equal to the number of points in X. The result of rlabel will be a point pattern with locations given by X and marks given by a random permutation of labels (i.e. a random sample without replacement).

If permute=FALSE, then labels may be a vector of any length. The result of rlabel will be a point pattern with locations given by X and marks given by a random sample from labels (with replacement).

Value

  • A marked point pattern (of the same class as X).

See Also

marks<- to assign arbitrary marks.

Aliases
  • rlabel
Examples
data(amacrine)

   # Randomly permute the marks "on" and "off"
   # Result always has 142 "off" and 152 "on"
   Y <- rlabel(amacrine)

   # randomly allocate marks "on" and "off"
   # with probabilities p(off) = 0.48, p(on) = 0.52
   Y <- rlabel(amacrine, permute=FALSE)

   # randomly allocate marks "A" and "B" with equal probability
   data(cells)
   Y <- rlabel(cells, labels=factor(c("A", "B")), permute=FALSE)
Documentation reproduced from package spatstat, version 1.31-2, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.