merge                 package:limma                 R Documentation

_M_e_r_g_e _R_G_L_i_s_t _o_r _M_A_L_i_s_t _D_a_t_a _O_b_j_e_c_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Merge two microarray data sets represented by RGLists in possibly
     irregular order.

_U_s_a_g_e:

     ## S3 method for class 'RGList':
     merge(x,y,...)

_A_r_g_u_m_e_n_t_s:

       x: 'RGList-class' or 'MAList-class' object

       y: 'RGList' object, corresponding to the same genes as for 'x',
          possibly in a different order, but with different arrays.

     ...: other arguments are accepted but not used at present

_D_e_t_a_i_l_s:

     'RGList' and 'MAList' objects are list objects containing numeric
     matrices all of the same dimensions. The RGLists are merged by
     merging each of the components by row names or, if there are no
     row names, by IDs in the 'genes' component. Unlike when using
     'cbind', row names are not required to be in the same order or to
     be unique. In the case of repeated row names, the order of the
     rows with repeated names in preserved. This means that the first
     occurrence of each name in 'x$R' is matched with the first
     occurrence of the same name in 'y$R', the second with the second,
     and so on. The final vector of row names is the same as in 'x'.

     Note: if the 'RGList' objects contain the same number of genes in
     the same order then the appropriate function to combine them is
     'cbind' rather than 'merge'.

_V_a_l_u_e:

     An merged object of the same class as 'x' and 'y' with the same
     components as 'x'. Component matrices have the same rows names as
     in 'x' but columns from 'y' as well as 'x'.

_A_u_t_h_o_r(_s):

     Gordon Smyth

_S_e_e _A_l_s_o:

     R base provides a 'merge' method for merging data.frames.

     An overview of limma commands for reading, subsetting and merging
     data is given in 03.ReadingData.

_E_x_a_m_p_l_e_s:

     M <- A <- matrix(11:14,4,2)
     rownames(M) <- rownames(A) <- c("a","a","b","c")
     MA1 <- new("MAList",list(M=M,A=A))

     M <- A <- matrix(21:24,4,2)
     rownames(M) <- rownames(A) <- c("b","a","a","c")
     MA2 <- new("MAList",list(M=M,A=A))

     merge(MA1,MA2)
     merge(MA2,MA1)