gridded-methods              package:sp              R Documentation

_s_p_e_c_i_f_y _s_p_a_t_i_a_l _d_a_t_a _a_s _b_e_i_n_g _g_r_i_d_d_e_d, _o_r _f_i_n_d _o_u_t _w_h_e_t_h_e_r _t_h_e_y _a_r_e

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

     returns logical (TRUE or FALSE) telling whether the object is
     gridded or not; in assignment promotes a non-gridded structure to
     a gridded one, or demotes a gridded structure back to a
     non-structured one.

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

             gridded(obj)
             gridded(obj) <- TRUE
             fullgrid(obj)
             fullgrid(obj) <- TRUE
             gridparameters(obj)

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

     obj: object deriviving from class "Spatial" (for gridded), or 

     object of class SpatialGridDataFrame-class (for fullgrid and
     gridparameters)

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

     if obj derives from class Spatial, gridded(object) will tell
     whether it is has topology on a regular grid; if assigned TRUE, if
     the object derives from SpatialPoints and has gridded topology,
     grid topology will be added to object, and the class of the object
     will be promoted to SpatialGrid-class or 
     SpatialGridDataFrame-class

     'fullgrid' returns a logical, telling whether the grid is full and
     ordered (i.e., in full matrix form), or whether it is not full or
     unordered (i.e. a list of points that happen to lie on a grid. If
     assigned, the way the points are stored may be changed. Changing a
     set of points to full matrix form and back may change the original
     order of the points, and will remove duplicate points if they were
     present.

     'gridparameters' returns, if 'obj' inherits from
     SpatialDataFrameGrid its grid parameters, else it returns
     numeric(0).  The returned value is a data.frame with three
     columns, named cellcentre.offset ("lower left cell centre
     coordinates"), cellsize, and cells.dim (cell dimension); the rows
     correspond to the spatial dimensions.

_M_e_t_h_o_d_s:

     _o_b_j = "_S_p_a_t_i_a_l" object deriviving from class "Spatial" 

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

     # just 9 points on a grid:
     x <- c(1,1,1,2,2,2,3,3,3)
     y <- c(1,2,3,1,2,3,1,2,3)
     xy <- cbind(x,y)
     S <- SpatialPoints(xy)
     class(S)
     plot(S)
     gridded(S) <- TRUE
     gridded(S)
     class(S)
     summary(S)
     plot(S)
     gridded(S) <- FALSE
     gridded(S)
     class(S)

     # data.frame
     data(meuse.grid)
     coordinates(meuse.grid) <- ~x+y
     gridded(meuse.grid) <- TRUE
     plot(meuse.grid) # not much good
     summary(meuse.grid)

