superimpose             package:spatstat             R Documentation

_S_u_p_e_r_i_m_p_o_s_e _S_e_v_e_r_a_l _P_o_i_n_t _P_a_t_t_e_r_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     Superimpose any number of point patterns.

_U_s_a_g_e:

       superimpose(...)

_A_r_g_u_m_e_n_t_s:

     ...: 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'. 

_D_e_t_a_i_l_s:

     This function is used to superimpose two or more point patterns
     (see also 'concatxy'). 

     It assumes that 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'. All the point patterns are
     assumed to have the same window of observation.

     The first argument must be a point pattern object, and it
     determines the observation window for the result.

     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.

_V_a_l_u_e:

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

_A_u_t_h_o_r(_s):

     Adrian Baddeley adrian@maths.uwa.edu.au <URL:
     http://www.maths.uwa.edu.au/~adrian/> and Rolf Turner
     rolf@math.unb.ca <URL: http://www.math.unb.ca/~rolf>

_S_e_e _A_l_s_o:

     'concatxy', 'quadscheme'

_E_x_a_m_p_l_e_s:

       dat <- runifrect(30)
       xy <- list(x=runif(10),y=runif(10))
       new <- superimpose(dat, xy)
       ## Not run: 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))

