cBind                 package:Matrix                 R Documentation

_V_e_r_s_i_o_n_s _o_f '_c_b_i_n_d' _a_n_d '_r_b_i_n_d' _r_e_c_u_r_s_i_v_e_l_y _b_u_i_l_t _o_n _c_b_i_n_d_2/_r_b_i_n_d_2

_D_e_s_c_r_i_p_t_i_o_n:

     The base functions 'cbind' and 'rbind' are defined for an
     arbitrary number of arguments and hence have the first formal
     argument '...'.  For that reason, S4 methods cannot easily be
     defined for binding together matrices inheriting from 'Matrix'.

     For that reason, 'cbind2' and 'rbind2' have been provided for
     binding together _two_ matrices, and we have defined methods for
     these and the ''Matrix''-matrices.

     As a substitute for _S4-enabled_ versions of 'cbind' and 'rbind',
     you can use 'cBind' and 'rBind' with identical syntax and semantic
     in order to bind together multiple matrices ('"matrix"' or
     '"Matrix"' and vectors.

_U_s_a_g_e:

     cBind(..., deparse.level = 1)
     rBind(..., deparse.level = 1)

_A_r_g_u_m_e_n_t_s:

     ...: matrix-like R objects to be bound together, see 'cbind' and
          'rbind'.

deparse.level: integer determining under which circumstances column and
          row names are built from the actual arguments' 'expression',
          see 'cbind'.

_D_e_t_a_i_l_s:

     The implementation of these is _recursive_, calling 'cbind2' or
     'rbind2' respectively, where these have methods defined and so
     should dispatch appropriately.

_V_a_l_u_e:

     typically a 'matrix-like' object of a similar 'class' as the first
     argument in '...'.

_A_u_t_h_o_r(_s):

     Martin Maechler

_S_e_e _A_l_s_o:

     'cbind2', 'cbind', 'Methods'.

_E_x_a_m_p_l_e_s:

     (a <- matrix(c(2:1,1:2), 2,2))
     cbind(0, rBind(a, 7)) # remains traditional matrix

     D <- Diagonal(2)
     cBind(4, a, D, -1, D, 0) # a sparse Matrix