Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

Lest

L-function


Description

Calculates an estimate of the L-function (Besag's transformation of Ripley's K-function) for a spatial point pattern.

Usage

Lest(X, ..., correction)

Arguments

X

The observed point pattern, from which an estimate of L(r) will be computed. An object of class "ppp", or data in any format acceptable to as.ppp().

correction,...

Other arguments passed to Kest to control the estimation procedure.

Details

This command computes an estimate of the L-function for the spatial point pattern X. The L-function is a transformation of Ripley's K-function,

L(r) = sqrt(K(r)/pi)

where K(r) is the K-function.

See Kest for information about Ripley's K-function. The transformation to L was proposed by Besag (1977).

The command Lest first calls Kest to compute the estimate of the K-function, and then applies the square root transformation.

For a completely random (uniform Poisson) point pattern, the theoretical value of the L-function is L(r) = r. The square root also has the effect of stabilising the variance of the estimator, so that L(r) is more appropriate for use in simulation envelopes and hypothesis tests.

See Kest for the list of arguments.

Value

An object of class "fv", see fv.object, which can be plotted directly using plot.fv.

Essentially a data frame containing columns

r

the vector of values of the argument r at which the function L has been estimated

theo

the theoretical value L(r) = r for a stationary Poisson process

together with columns named "border", "bord.modif", "iso" and/or "trans", according to the selected edge corrections. These columns contain estimates of the function L(r) obtained by the edge corrections named.

Variance approximations

If the argument var.approx=TRUE is given, the return value includes columns rip and ls containing approximations to the variance of Lest(r) under CSR. These are obtained by the delta method from the variance approximations described in Kest.

Author(s)

and Rolf Turner r.turner@auckland.ac.nz

References

Besag, J. (1977) Discussion of Dr Ripley's paper. Journal of the Royal Statistical Society, Series B, 39, 193–195.

See Also

Examples

data(cells)
 L <- Lest(cells)
 plot(L, main="L function for cells")

spatstat.core

Core Functionality of the 'spatstat' Family

v2.1-2
GPL (>= 2)
Authors
Adrian Baddeley [aut, cre], Rolf Turner [aut], Ege Rubak [aut], Kasper Klitgaard Berthelsen [ctb], Achmad Choiruddin [ctb], Jean-Francois Coeurjolly [ctb], Ottmar Cronie [ctb], Tilman Davies [ctb], Julian Gilbey [ctb], Yongtao Guan [ctb], Ute Hahn [ctb], Kassel Hingee [ctb], Abdollah Jalilian [ctb], Marie-Colette van Lieshout [ctb], Greg McSwiggan [ctb], Tuomas Rajala [ctb], Suman Rakshit [ctb], Dominic Schuhmacher [ctb], Rasmus Plenge Waagepetersen [ctb], Hangsheng Wang [ctb]
Initial release
2021-04-17

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.