getFileNames.ggobi          package:Rggobi          R Documentation

_I_d_e_n_t_i_f_y _t_h_e _f_i_l_e_s _a_s_s_o_c_i_a_t_e_d _w_i_t_h _a _g_g_o_b_i _i_n_s_t_a_n_c_e'_s _d_a_t_a _s_e_t_s.

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

     It is often convenient to be able to query the source of a data
     set currently in ggobi. When the data is read from a file, the
     name of the file or URL is sufficient. This function returns the
     name of the primary file from which  the data was read.  It can
     also be asked to return a list of the secondary  or auxillary
     files that were read due to a reference in the primary file.

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

     getFileNames.ggobi(auxillary = FALSE, .gobi=getDefaultGGobi())

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

auxillary: a logical value indicating whether to retur the secondary or
          auxillary files that were read based on a reference in the
          primary or other files. 

   .gobi: the ggobi instance whose data sources are to be queried.

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

     A list with an element for each dataset in the ggobi instance. If
     'auxillary' is 'FALSE', each element is a single string giving the
     name of the primary file containing the data. If 'auxillary' is
     'TRUE', the list's element is a character vector containing all
     the files read when processing the primary file.

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

     Duncan Temple Lang

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.ggobi.org>

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

     'getGGobi' 'setData.ggobi'

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

      g <- ggobi(system.file("data", "sat.xml", package="Rggobi"), args="-noinit")
      g$setData(system.file("data", "sat.xml", package="Rggobi"), add=TRUE)

      g$getFileNames()

