scanpp               package:spatstat               R Documentation

_R_e_a_d _P_o_i_n_t _P_a_t_t_e_r_n _F_r_o_m _D_a_t_a _F_i_l_e

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

     Reads a point pattern dataset from a text file.

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

        scanpp(filename, window, header=TRUE, dir="", multitype=FALSE) 

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

filename: String name of the file containing the coordinates of the
          points in the point pattern, and their marks if any. 

  window: Window for the point pattern. An object of class '"owin"'. 

  header: Logical flag indicating whether the first line of the file
          contains headings for the columns. Passed to 'read.table'. 

     dir: String containing the path name of the directory in which
          'filename' is to be found. Default is the current directory. 

multitype: Logical flag indicating whether marks are to be interpreted
          as a factor ('multitype = TRUE') or as numerical values
          ('multitype = FALSE'). 

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

     This simple function reads a point pattern dataset from a file
     containing the cartesian coordinates of its points, and optionally
     the mark values for these points.

     The file identified by 'filename' in directory 'dir' should be a
     text file that can be read using 'read.table'. Thus, each line of
     the file (except possibly the first line) contains data for one
     point in the point pattern. Data are arranged in columns. There
     should be either two columns (for an unmarked point pattern) or
     three columns (for a marked point pattern).

     If 'header=FALSE' then the first two columns of data will be
     interpreted as the x and y coordinates of points. A third column,
     if present, will be interpreted as containing the marks for these
     points. The marks will be converted to a factor if 'multitype =
     TRUE'.

     If 'header=TRUE' then the first line of the file should contain
     string names for each of the columns of data. If there are columns
     named 'x' and 'y' then these will be taken as the cartesian
     coordinates, and any remaining column will be taken as the marks.
     If there are no columns named 'x' and 'y' then the first and
     second columns will be taken as the cartesian coordinates.

     Note that there is intentionally no default for 'window'. The
     window of observation should be specified. If you really need to
     estimate the window, use the Ripley-Rasson estimator 'ripras'.

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

     A point pattern (an object of class '"ppp"', see 'ppp.object').

_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:

     'ppp.object', 'ppp', 'as.ppp', 'ripras'

