Description Usage Arguments Details Value Author(s) See Also Examples

Visit each point in a point pattern, find the neighbouring points, and summarise their marks

1 |

`X` |
A marked point pattern.
An object of class |

`fun` |
Function to be applied to the vector of marks. |

`N` |
Integer. If this argument is present,
the neighbourhood of a point of |

`R` |
Nonnegative numeric value. If this argument is present,
the neighbourhood of a point of |

`...` |
extra arguments passed to the function |

This algorithm visits each point in the point pattern `X`

,
determines which points of `X`

are “neighbours” of the current
point, extracts the marks of these neighbouring points,
applies the function `fun`

to the marks,
and collects the value or values returned by `fun`

.

The definition of “neighbours” depends on the arguments
`N`

and `R`

, exactly one of which must be given.

If `N`

is given, then the neighbours of the current
point are the `N`

points of `X`

which are closest to
the current point (including the current point itself).
If `R`

is given, then the neighbourhood of the current point
consists of all points of `X`

which lie closer than a distance `R`

from the current point.

Each point of `X`

is visited; the neighbourhood
of the current point is determined; the marks of these points
are extracted as a vector `v`

; then the function
`fun`

is called as:

`fun(v, ...)`

where `...`

are the arguments passed from the call to
`markstat`

.

The results of each call to `fun`

are collected and returned
according to the usual rules for `apply`

and its
relatives. See the section on **Value**.

This function is just a convenient wrapper for a common use of the
function `applynbd`

. For more complex tasks,
use `applynbd`

.
To simply tabulate the marks in every `R`

-neighbourhood, use
`marktable`

.

Similar to the result of `apply`

.
if each call to `fun`

returns a single numeric value,
the result is a vector of dimension `npoints(X)`

, the number of points
in `X`

.
If each call to `fun`

returns a vector of the same length
`m`

, then the result is a matrix of dimensions `c(m,n)`

;
note the transposition of the indices, as usual for the family of
`apply`

functions.
If the calls to `fun`

return vectors of different lengths,
the result is a list of length `npoints(X)`

.

.

`applynbd`

,
`marktable`

,
`ppp.object`

,
`apply`

1 2 3 4 5 6 7 8 |

spatstat documentation built on May 20, 2017, 5:36 a.m.

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

Please suggest features or report bugs in the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.