root.data                package:xps                R Documentation

_C_r_e_a_t_e _c_l_a_s_s _D_a_t_a_T_r_e_e_S_e_t _a_c_c_e_s_s_i_n_g _R_O_O_T _d_a_t_a _f_i_l_e

_D_e_s_c_r_i_p_t_i_o_n:

     Create class DataTreeSet accessing ROOT data file.

_U_s_a_g_e:

     root.data(xps.scheme, rootfile = character(0), celnames = "*")

_A_r_g_u_m_e_n_t_s:

xps.scheme: A 'SchemeTreeSet' containing the correct scheme for the
          ROOT data file.

rootfile: name of ROOT data file, including full path.

celnames: optional 'character' vector of tree names to get only subset
          of trees.

_D_e_t_a_i_l_s:

     An S4 class 'DataTreeSet' will be created, serving as R wrapper to
     the  existing 'ROOT' data file 'rootfile'.

     If the 'DataTreeSet' should only handle a subset of the trees
     stored in  'rootfile', the tree names must be supplied as vector
     'celnames'.

     To get the names of all trees stored in 'rootfile' you can call
     function  'getTreeNames' first.

_V_a_l_u_e:

     A 'DataTreeSet' object.

_N_o_t_e:

     Use 'root.data' to access the ROOT data file from new R sessions 
     to avoid creating a new 'ROOT' data file for every R session.

_A_u_t_h_o_r(_s):

     Christian Stratowa

_S_e_e _A_l_s_o:

     'import.data', 'DataTreeSet'

_E_x_a_m_p_l_e_s:

     ## get scheme and import CEL-files from package
     scheme.test3 <- root.scheme(paste(.path.package("xps"),"schemes/SchemeTest3.root",sep="/"))
     data.test3 <- import.data(scheme.test3,"tmp_datatest3",celdir=paste(.path.package("xps"),"raw",sep="/"),verbose=FALSE)

     ## use subset of CEL-files
     subdata.test3 <- root.data(scheme.test3,"tmp_datatest3_cel.root", celnames=c("TestA1.cel","TestB2.cel"))

