attachSdf              package:SQLiteDF              R Documentation

_A_t_t_a_c_h _S_D_F _D_a_t_a_b_a_s_e

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

     Attaches a SDF to the workspace by adding to the SDF list in
     'workspace.db' and then attaching the SDF file in the SQLite
     engine.

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

     attachSdf(sdf_filename, sdf_iname = NULL)

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

sdf_filename: A string containing a path (recommended is relative path)
          to the SDF database file. 

sdf_iname: A string containing an internal name with which the SDF to
          be attached will be renamed. By default, the internal name
          stored in the SDF's attribute table will be used as the
          internal name. Duplicates will be resolved by appending
          numbers. 

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

     Attaching a SDF into the SQLiteDF workspace involves adding an
     entry in 'workspace.db' and then attaching to the SQLite engine.
     Checks are made to avoid attaching the same file twice. This is
     done by storing the full path name of the SDF file in
     'workspace.db'. When loading SQLiteDF, the relative path is used
     to locate the SDF files and then the full path are recalculated.
     When a SDF file is to be attached with 'attachSdf', its full path
     is calculated and then it is compared with those in the workspace.
     These restrictions are to avoid possibly subtle problems. (In
     retrospect, I can't imagine any serious problem yet but since it's
     there already... To think that I cringed for a week on this
     problem, I _am_ an idiot.)

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

     Returns an sqlite.data.frame object of the attached SDF if
     successful. 'NULL' with an error message displayed otherwise.

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

     Miguel A. R. Manese

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

     'sqlite.data.frame' 'attachSdf' 'lsSdf'

