convertS3toS4            package:rflowcyt            R Documentation

_C_o_n_v_e_r_t_s _S_3 _c_l_a_s_s _F_C_S _o_b_j_e_c_t _t_o _S_4 _c_l_a_s_s _F_C_S _o_b_j_e_c_t

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

     This function will update any S3 class 'FCS' object to S4 class.

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

     convertS3toS4(S3file, myFCSobj.name = "", fileName = "")

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

  S3file: S3 Class FCS object location and filename

myFCSobj.name: character string indicating the FCS object name 

fileName: character string indicating the file name of the binary raw
          FCS data, from which the FCS object originates and which is
          read by 'read.FCS'

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

     The FCS object is obtained as the result of 'read.FCS' which has
     been currently updated to output FCS objects as class S4 instead
     of S3.

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

     A Class S4 'FCS' object with the following slots: 

    data: matrix of the data, where the rows are the cells/observations
          and the columns are the different fluoroescence measurements

metadata: of class 'FCSmetadata' with the following slots:

          _m_o_d_e the mode of the raw binary file

          _s_i_z_e numeric value describing the total number of rows or
               observations/cells

          _n_p_a_r_a_m numeric value describing the number of columns or
               parameters

          _s_h_o_r_t_n_a_m_e_s a vector of the short names of the column
               variables of the data

          _l_o_n_g_n_a_m_e_s a vector of the long names of the column variables
               of the data

          _p_a_r_a_m_r_a_n_g_e_s the vector of corresponding ranges or maximum
               values for each column variable

          _f_i_l_e_n_a_m_e character string of the name of the raw data file
               from which the object originates

          _o_b_j_e_c_t_n_a_m_e character string of the name of the FCS S4 object

          _o_r_i_g_i_n_a_l Boolean value indicating whether the data is the
               original

          _f_c_s_i_n_f_o list of other parameters

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

     A.J. Rossini and J.Y. Wan

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

     'read.FCS', 'FCS'

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

       if (require(rfcdmin)){

          ## if previously read-in as S3 FCS object
          facscan256.fcs<- paste(system.file("fcs", package="rfcdmin"),
                                   "facscan256.fcs",
                                   sep="/")

          ## reading in the FCS files
          FCSobj.S3<-read.FCS(facscan256.fcs, UseS3=TRUE)

          ## convert to S4 FCS

          FCSobj.S4<- convertS3toS4(FCSobj.S3,
                                    myFCSobj.name="FCSobj.S4",
                                    fileName=facscan256.fcs)
       }

