| rlabel {spatstat} | R Documentation |
Randomly allocates marks to a point pattern, or permutes the existing marks, or resamples from the existing marks.
rlabel(X, labels=marks(X), permute=TRUE, nsim=1, drop=TRUE)
X |
Point pattern (object of class |
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 |
nsim |
Number of simulated realisations to be generated. |
drop |
Logical. If |
This very simple function allocates random marks to
an existing point pattern X. It is useful
for hypothesis testing purposes. (The function can also be applied
to line segment patterns.)
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).
If nsim = 1 and drop=TRUE,
a marked point pattern (of the same class as X).
If nsim > 1, a list of point patterns.
Adrian Baddeley Adrian.Baddeley@curtin.edu.au, Rolf Turner r.turner@auckland.ac.nz and Ege Rubak rubak@math.aau.dk.
marks<- to assign arbitrary marks.
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)