home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Educational / R-0.49-MI / R-0.49-I / help / base / dataentry < prev    next >
Encoding:
Text File  |  1997-04-23  |  1.7 KB  |  45 lines
  1.     
  2.     _S_p_r_e_a_d_s_h_e_e_t _I_n_t_e_r_f_a_c_e _f_o_r _E_n_t_e_r_i_n_g _D_a_t_a
  3.     
  4.          data.entry(..., Modes=NULL, Names=NULL)
  5.          dataentry(data, modes)
  6.          de(..., Modes=NULL, Names=NULL)
  7.     
  8.     _D_e_s_c_r_i_p_t_i_o_n:
  9.     
  10.          This is a fairly big suite of programs designed to make
  11.          the interface to the spreadsheet painless for users.
  12.          data.entry has side effects, any changes made in the
  13.          spreadsheet are reflected in the variables.  The func-
  14.          tions de, de.ncols, de.setup and de.restore are
  15.          designed to help achieve these side effects.  If the
  16.          user passes in a matrix, X say, then the matrix is bro-
  17.          ken into columns before dataentry is called. Then on
  18.          return the columns are collected and glued back
  19.          together and the result assigned to the variable X.  If
  20.          you don't want this behaviour use dataentry directly.
  21.     
  22.          The primitive function is dataentry. It takes a list of
  23.          vectors of possibly different lengths and modes (the
  24.          second argument) and opens a spreadsheet with these
  25.          variables being the columns.  The columns of the
  26.          dataentry window are returned as vectors in a list when
  27.          the spreadsheet is closed.
  28.     
  29.          de.ncols counts the number of columns which are sup-
  30.          plied as arguments to data.entry. It attempts to count
  31.          columns in lists, matrices and vectors.  de.setup sets
  32.          things up so that on return the columns can be
  33.          regrouped and reassigned to the correct name. This is
  34.          handled by de.restore.
  35.     
  36.     _S_e_e _A_l_s_o:
  37.     
  38.          vi, ed.
  39.     
  40.     _E_x_a_m_p_l_e_s:
  41.     
  42.          # call data entry with variables x and y
  43.          data.entry(x,y)
  44.     
  45.