# dclf.progress

##### Progress Plot of Test of Spatial Pattern

Generates a progress plot (envelope representation) of the Diggle-Cressie-Loosmore-Ford test or the Maximum Absolute Deviation test for a spatial point pattern.

##### Usage

```
dclf.progress(X, ..., nrank = 1)
mad.progress(X, ..., nrank = 1)
mctest.progress(X, fun = Lest, ..., exponent = 1, nrank = 1)
```

##### Arguments

- X
- Either a point pattern (object of class
`"ppp"`

,`"lpp"`

or other class), a fitted point process model (object of class`"ppm"`

,`"kppm"`

or other class) or an envelope object (class`"envelope"`

- ...
- Arguments passed to
`envelope`

. Useful arguments include`fun`

to determine the summary function,`nsim`

to specify the number of Monte Carlo simulations, and`verbose=`

- nrank
- Integer. The rank of the critical value of the Monte Carlo test,
amongst the
`nsim`

simulated values. A rank of 1 means that the minimum and maximum simulated values will become the critical values for the test. - fun
- Function that computes the desired summary statistic for a point pattern.
- exponent
- Positive number. The exponent of the $L^p$ distance. See Details.

##### Details

The Diggle-Cressie-Loosmore-Ford test and the
Maximum Absolute Deviation test for a spatial point pattern
are described in `dclf.test`

.
These tests depend 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 `dclf.progress`

performs
`dclf.test`

on `X`

using all possible intervals
of the form $c(0,r)$, and returns the resulting values of the test
statistic, and the corresponding critical values of the test,
as a function of $r$.

Similarly `mad.progress`

performs
`mad.test`

using all possible intervals
and returns the test statistic and critical value.

More generally, `mctest.progress`

performs a test based on the
$L^p$ discrepancy between the curves. The deviation between two
curves is measured by the $p$th root of the integral of
the $p$th power of the absolute value of the difference
between the two curves. The exponent $p$ is
given by the argument `exponent`

. The case `exponent=2`

is the Cressie-Loosmore-Ford test, while `exponent=Inf`

is the
MAD test.

The result of each command 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 Monte Carlo
acceptance region (grey shading).

The significance level for the Monte Carlo test is
`nrank/(nsim+1)`

. Note that `nsim`

defaults to 99,
so if the values of `nrank`

and `nsim`

are not given,
the default is a test with significance level 0.01.

If `X`

is an envelope object, then some of the data stored
in `X`

may be re-used:

- If
`X`

is an envelope object containing simulated functions, and`fun=NULL`

, then the code will re-use the simulated functions stored in`X`

. - If
`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`

. - Otherwise, new simulations will be performed,
and
`fun`

defaults to`Lest`

.

##### Value

- An object of class
`"fv"`

that can be plotted to obtain the progress plot.

##### References

Baddeley, A., Diggle, P., Hardegen, A., Lawrence, T.,
Milne, R. and Nair, G. (2014)
On tests of spatial pattern based on simulation envelopes.
*Ecological Monographs* **84** (3) 477--489.

##### See Also

`dclf.test`

and
`mad.test`

for the tests.
See `plot.fv`

for information on plotting
objects of class `"fv"`

.

##### Examples

`plot(dclf.progress(cells, nsim=19))`

*Documentation reproduced from package spatstat, version 1.42-2, License: GPL (>= 2)*