superimpose: Superimpose Several Point Patterns

Description

Superimpose any number of point patterns.

Usage

superimpose(..., W)

Arguments

...

Any number of arguments, each of which represents a point pattern. Each argument must be either a point pattern object (of class "ppp") or a structure containing elements x and y.

Optional. Window for the resulting point pattern. An object of class "owin", or something acceptable to as.owin.

Value

A point pattern (object of class "ppp") representing the superposition (union) of all the point patterns.

Details

This function is used to superimpose two or more point patterns (see also concatxy). Each of the arguments in ... is either a point pattern object (of class "ppp") or a structure containing (at least) the elements x and y. The point patterns are not required to have the same window of observation.

The window for the superimposed point pattern is specified by W. Its default value is the union of the windows of all the point patterns.

If any of the arguments is a marked point pattern, then all of them must be. In that case, the result is also a marked point pattern.

If the arguments are given in the form name=value, then the names will be used as marks attached to the corresponding points. See the last line in the Examples.

Examples

Run this code

dat <- runifrect(30)
  xy <- list(x=runif(10),y=runif(10))
  new <- superimpose(dat, xy)
  plot(new)

  # how to make a 2-type point pattern with types "a" and "b"
  u <- superimpose(a = rpoispp(10), b = rpoispp(20))

  # how to make a 2-type point pattern with types 1 and 2
  u <- superimpose("1" = rpoispp(10), "2" = rpoispp(20))