dg.progress(X, fun = Lest, ..., exponent = 2, nsim = 19, nsimsub = nsim - 1, nrank = 1, alpha, leaveout=1, interpolate = FALSE, rmin=0, savefuns = FALSE, savepatterns = FALSE, verbose=TRUE)
"ppp"
, "lpp"
or other class), a fitted point process model (object of class "ppm"
,
"kppm"
or other class) or an envelope object (class
"envelope"
).
envelope
.
Useful arguments include alternative
to
specify one-sided or two-sided envelopes.
nsim
repetitions of the basic test, each involving nsimsub
simulated
realisations, so there will be a total
of nsim * (nsimsub + 1)
simulations.
nsim
simulated values.
A rank of 1 means that the minimum and maximum
simulated values will become the critical values for the test.
nrank/(nsim+1)
where nsim
is the
number of simulations.
interpolate=FALSE
(the default), a standard Monte Carlo test
is performed, and the critical value is the largest
simulated value of the test statistic (if nrank=1
)
or the nrank
-th largest (if nrank
is another number).
If interpolate=TRUE
, kernel density estimation
is applied to the simulated values, and the critical value is
the upper alpha
quantile of this estimated distribution.
"fv"
that can be plotted to
obtain the progress plot.
dg.test
.
This test depends on the choice of an interval of
distance values (the argument rinterval
).
A progress plot or envelope representation
of the test (Baddeley et al, 2014) is a plot of the
test statistic (and the corresponding critical value) against the length of
the interval rinterval
.
The command dg.progress
effectively performs
dg.test
on X
using all possible intervals
of the form $[0,R]$, and returns the resulting values of the test
statistic, and the corresponding critical values of the test,
as a function of $R$. The result is an object of class "fv"
that can be plotted to obtain the progress plot. The display shows
the test statistic (solid black line) and the test
acceptance region (grey shading).
If X
is an envelope object, then some of the data stored
in X
may be re-used:
X
is an envelope object containing simulated functions,
and fun=NULL
, then
the code will re-use the simulated functions stored in X
.
X
is an envelope object containing
simulated point patterns,
then fun
will be applied to the stored point patterns
to obtain the simulated functions.
If fun
is not specified, it defaults to Lest
.
fun
defaults to Lest
.
If the argument rmin
is given, it specifies the left endpoint
of the interval defining the test statistic: the tests are
performed using intervals $[rmin,R]$
where $R \ge rmin$.
The argument leaveout
specifies how to calculate the
discrepancy between the summary function for the data and the
nominal reference value, when the reference value must be estimated
by simulation. The values leaveout=0
and
leaveout=1
are both algebraically equivalent (Baddeley et al, 2014,
Appendix) to computing the difference observed - reference
where the reference
is the mean of simulated values.
The value leaveout=2
gives the leave-two-out discrepancy
proposed by Dao and Genton (2014).
Baddeley, A., Hardegen, A., Lawrence, L., Milne, R.K., Nair, G.M. and Rakshit, S. (2015) Pushing the envelope: extensions of graphical Monte Carlo tests. Submitted for publication.
Dao, N.A. and Genton, M. (2014) A Monte Carlo adjusted goodness-of-fit test for parametric models describing spatial point patterns. Journal of Graphical and Computational Statistics 23, 497--517.
dg.test
,
dclf.progress
ns <- if(interactive()) 19 else 5
plot(dg.progress(cells, nsim=ns))
Run the code above in your browser using DataLab