loadData             package:maigesPack             R Documentation

_L_o_a_d _c_D_N_A _m_i_c_r_o_a_r_r_a_y _d_a_t_a _t_a_b_l_e_s

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

     This function loads a cDNA microarray dataset into a temporary
     'maigesPreRaw' object.

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

     loadData(fileConf=paste(R.home(), "library/maiges/doc/gastro/load_gastro.conf", sep="/"))

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

fileConf: string specifying a file name containing the parameters to
          load data. This file must contain all the information
          necessary to load the data, which are the following:

          __d_a_t_a_D_i_r_: specify a folder name containing the data files to
               be loaded. The function tests the presence or not of the
               final bar.

          __e_x_t_: string specifying the extension of the tables (if the
               _sampleFile_ below don't contain this information). You
               don't need to put the _dot_ onto string beginning, the
               function tests this automatically.

          __s_a_m_p_l_e_F_i_l_e_: string containing the file name with the
               descriptions of the biological samples hybridised,
               including  the respective intensity data files. This
               file must be  spreadsheet-like separated by tabs in a
               plain text format. The column fields *'File'* and
               *'Ref'* are mandatory (with exactly these names). The
               first one describes the files containing the numerical
               data and the second one describes the channel used to
               label the reference sample, must be 'green' or 'red' and
               they are not case sensitive.

          __d_a_t_a_s_e_t_I_d_: string with a dataset identification.

          __g_e_n_e_M_a_p_: as in _sampleFile_, this item is a character
               string giving a file name. This file must describe the
               genes on the slides. Also it must be a plain text
               spreadsheet-like separated by tabs. There are no
               mandatory field, but it is strongly recommended that you
               specify some fields containing gene names, genbank ID,
               cluster ID and gene annotations for a nice gene
               identification.

          __h_e_a_d_e_r_s_: character string (in the R format) specifying the
               column fields from data files you want to load.

          __s_k_i_p_: number of lines to be skipped in the numeric tables.

          __s_e_p_: character that separates the fields on the numeric
               tables.

          __g_r_i_d_R_: number of print tip rows inside the slide.

          __g_r_i_d_C_: number of print tip columns inside the slide.

          __p_r_i_n_t_T_i_p_R_: number of rows inside each print tip.

          __p_r_i_n_t_T_i_p_C_: number of columns inside each print tip.

          You can see an example of this configuration file in
          RHOME/library/maiges/doc/gastro/load_gastro.conf.

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

     This function takes the file name with initial arguments and load
     the dataset specified by this config file. It generate a
     'maigesPreRaw' object. During the process the function writes a
     file named load.out on your working folder, that is a log of the
     process, that you can check and verify if all was done correctly.
     Obviously, the parameters _dataDir_, _sampleFile_, _geneMap_,
     _sep_, _gridR_, _gridC_, _printTipR_, _printTipC_ and _headers_
     must be specified. All other parameters may be specified as NULL
     and, if so, they are ignored. It is possible to specify any fields
     that you want in the headers parameter, but it is  strongly
     recommended that you specify the fields of spot intensity and
     background for both channels and the filed giving quality weights
     for all spots.

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

     This function returns a 'maigesPreRaw' object containing the
     dataset loaded.

     Once an object of class 'maigesPreRaw' was generated, you may use
     the functions 'addGeneGrps' and 'addPaths' to load informaation
     about gene groups and gene networks, respectively.

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

     Gustavo H. Esteves <gesteves@vision.ime.usp.br>

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

     ## Don't run because you don't have data tables.
     ## Not run: 
     gastro = loadData(fileConf="load_gastro.conf")
     ## End(Not run)

