Computes estimates of the intertype K12-function and associated neighbourhood functions from a bivariate spatial point pattern in a simple (rectangular or circular) or complex sampling window. Computes optionally local confidence limits of the functions under the null hypotheses of population independence or random labelling (see Details).
k12fun(p, upto, by, nsim=0, H0=c("pitor","pimim","rl"), prec=0.01, nsimax=3000, conv=50,
rep=10, alpha=0.01, marks)A list of class "fads" with essentially the following components:
a vector of regularly spaced out distances (seq(by,upto,by)).
a data frame containing values of the bivariate pair density function \(g12(r)\).
a data frame containing values of the bivariate local neighbour density function \(n12(r)\).
a data frame containing values of the intertype function \(K12(r)\).
a data frame containing values of the modified intertype function \(L12(r)\).
Each component except r is a data frame with the following variables:
a vector of estimated values for the observed point pattern.
a vector of theoretical values expected under the selected null hypothesis.
(optional) if nsim>0 a vector of the upper local confidence limits of the selected null hypothesis at a significant level \(\alpha\).
(optional) if nsim>0 a vector of the lower local confidence limits of the selected null hypothesis at a significant level \(\alpha\).
(optional) if nsim>0 a vector of local p-values of departure from the selected null hypothesis.
a "spp" object defining a multivariate spatial point pattern in a given sampling window (see spp).
maximum radius of the sample circles (see Details).
interval length between successive sample circles radii (see Details).
number of Monte Carlo simulations to estimate local confidence limits of the selected null hypothesis (see Details).
By default nsim=0, so that no confidence limits are computed.
one of c("pitor","pimim","rl") to select either the null hypothesis of population independence using toroidal shift (H0="pitor") or mimetic point process (H0="pimim"), or of random labelling (H0="rl") (see Details).
By default, the null hypothesis is population independence using toroidal shift.
if nsim>0 and H0="pitor" or H0="pimim", precision of the random vector or point coordinates generated during simulations. By default prec=0.01.
if nsim>0 and H0="pimim", maximum number of simulations allowed (see mimetic. By default nsimax=3000.
if nsim>0 and H0="pimim", convergence criterion (see mimetic. By default conv=50.
if nsim>0 and H0="pimim", controls for convergence failure of the mimetic point process (see details). By default rep=10 so that the function aborts after 10 consecutive failures in mimetic point process convergence.
if nsim>0, significant level of the confidence limits. By default \(\alpha=0.01\).
by default c(1,2), otherwise a vector of two numbers or character strings identifying the types (the p$marks levels)
of points of type 1 and 2, respectively.
Function k12fun computes the intertype \(K12(r)\) function of second-order neighbourhood analysis and the associated functions \(g12(r)\),
\(n12(r)\) and \(L12(r)\).
For a homogeneous isotropic bivariate point process of intensities \(\lambda1\) and \(\lambda2\),
the second-order property could be characterized by a function \(K12(r)\) (Lotwick & Silverman 1982), so that the expected
number of neighbours of type 2 within a distance \(r\) of an arbitrary point of type 1 is:
\(N12(r) = \lambda2*K12(r)\).
\(K12(r)\) is an intensity standardization of \(N12(r)\): \(K12(r) = N12(r)/\lambda2\).
\(n12(r)\) is an area standardization of of \(N12(r)\): \(n12(r) = N12(r)/(\pi*r^2)\), where \(\pi*r^2\) is the area of the disc of radius \(r\).
\(L12(r)\) is a linearized version of \(K12(r)\), which has an expectation of 0 under population independence: \(L12(r) = \sqrt(K12(r)/\pi)-r\). \(L12(r)\) becomes positive when the two population show attraction and negative when they show repulsion.
Under the null hypothesis of random labelling, the expectation of \(L12(r)\) is \(L(r)\). It becomes greater than \(L(r)\) when the types tend to be positively correlated and lower when they tend to be negatively correlated.
\(g12(r)\) is the derivative of \(K12(r)\) or bivariate pair density function, so that the expected
number of points of type 2 at a distance \(r\) of an arbitrary point of type 1 (i.e. within an annuli between two successive circles with radii \(r\) and \(r-by\)) is:
\(O12(r) = \lambda2*g12(r)\) (Wiegand & Moloney 2004).
The program introduces an edge effect correction term according to the method proposed by Ripley (1977)
and extended to circular and complex sampling windows by Goreaud & Pelissier (1999).
Theoretical values under the null hypothesis of either population independence or random labelling as well as
local Monte Carlo confidence limits and p-values of departure from the null hypothesis (Besag & Diggle 1977) are estimated at each distance \(r\).
The population independence hypothesis assumes that the location of points of a given population is independent from the location
of points of the other. It is therefore tested conditionally to the intrinsic spatial pattern of each population. Two different procedures are available:
H0="pitor" just shifts the pattern of type 1 points around a torus following Lotwick & Silverman (1982); H0="pimim" uses a mimetic point process (Goreaud et al. 2004)
to mimic the pattern of type 1 points (see mimetic.
The random labelling hypothesis "rl" assumes that the probability to bear a given mark is the same for all points of the pattern and
doesn't depends on neighbours. It is therefore tested conditionally to the whole spatial pattern, by randomizing the marks over the points'
locations kept unchanged (see Goreaud & Pelissier 2003 for further details).
Besag J.E. & Diggle P.J. 1977. Simple Monte Carlo tests spatial patterns. Applied Statistics, 26:327-333.
Goreaud F. & Pelissier R. 1999. On explicit formulas of edge effect correction for Ripley's K-function. Journal of Vegetation Science, 10:433-438.
Goreaud, F. & Pelissier, R. 2003. Avoiding misinterpretation of biotic interactions with the intertype K12-function: population independence vs. random labelling hypotheses. Journal of Vegetation Science, 14: 681-692.
Lotwick, H.W. & Silverman, B.W. 1982. Methods for analysing spatial processes of several types of points. Journal of the Royal Statistical Society B, 44:403-413.
Ripley B.D. 1977. Modelling spatial patterns. Journal of the Royal Statistical Society B, 39:172-192.
Wiegand, T. & Moloney, K.A. 2004. Rings, circles, and null-models for point pattern analysis in ecology. Oikos, 104:209-229.
Goreaud F., Loussier, B., Ngo Bieng, M.-A. & Allain R. 2004. Simulating realistic spatial structure for forest stands: a mimetic point process. In Proceedings of Interdisciplinary Spatial Statistics Workshop, 2-3 December, 2004. Paris, France.
plot.fads,
spp,
k12val,
kfun,
kijfun,
ki.fun,
mimetic,
kmfun.