readelevdata              package:CTFS              R Documentation

_R_e_a_d _a _T_e_x_t _o_r _R_D_a_t_a _D_a_t_a_f_r_a_m_e _a_n_d _M_a_k_e _a _M_a_t_r_i_x, _S_p_e_c_i_f_i_c_a_l_l_y 
_f_o_r _E_l_e_v_a_t_i_o_n _D_a_t_a

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

     Read a tab delimited text file or an RData *dataframe* containing
     the x, y coordinates and elevation at those coordinates The
     standard file has measurements at every 5 by 5 m point in the
     plot.  A matrix is returned for use in topographic mapping
     functions.

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

     readelevdata(elevfile, gridsize = 5, text = FALSE)

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

elevfile: file containing elevation data.  'bcielev.info' is the RData
          *dataframe*.  Or specify a text, tab delimited file.

gridsize: the scale at which the measurement in elevation were made. 
          Must be regular.

    text: indicates where the 'elevfile' is a *text* file or a
          *dataframe*. 

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

     This function is used to convert a spreadsheet text file or a
     *dataframe* to a matrix so that topographic maps can be made of
     the plots.

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

     Returns a *matrix* with rows and columns in the same pattern of
     the actual measurement in the plot.  In the case of the standard
     plot, 1000 by 500 m, measured at 5 m intervals, there are 101 rows
     and 201 columns.  All edges of the plot are included.


     1000 / 5 = 200 + 1 (outer edge) = 201 columns
      500 / 5 = 100 + 1 (outer edge) = 101 rows

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

     Rick Condit and Suzanne Lao

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

     'CTFS.readwrite'

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

     ## Not run: 
     readelevdata(bcielev.info)->elev.mat
     dim(elev.mat)
     bcielev.info[1:10,]
     elev.mat[1:10,1:10]
       
     ## End(Not run)

