facmul                package:Matrix                R Documentation

_M_u_l_t_i_p_l_i_c_a_t_i_o_n _b_y _D_e_c_o_m_p_o_s_i_t_i_o_n _F_a_c_t_o_r_s

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

     Performs multiplication by factors for certain decompositions (and
     allows explicit formation of those factors).

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

     facmul(x, factor, y, transpose, left, ...)

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

       x: a matrix decomposition.  No missing values or IEEE special
          values are allowed. 

  factor: an indicator for selecting a particular factor for
          multiplication. 

       y: a matrix or vector to be multiplied by the factor or its
          transpose. No missing values or IEEE special values are
          allowed. 

transpose: a logical value.  When 'FALSE' (the default) the factor is
          applied.  When 'TRUE' the transpose of the factor is applied. 

    left: a logical value.  When 'TRUE' (the default) the factor is
          applied from the left.  When 'FALSE' the factor is applied
          from the right. 

     ...: the method for '"qr.Matrix"' has additional arguments. 

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

     the product of the selected factor (or its transpose) and 'y'

_N_O_T_E:

     Factors for decompositions such as 'lu' and 'qr' can be stored in
     a compact form. The function 'facmul' allows multiplication
     without explicit formation of the factors, saving both storage and
     operations.

_R_e_f_e_r_e_n_c_e_s:

     Golub, G., and Van Loan, C. F. (1989). _Matrix Computations,_ 2nd
     edition, Johns Hopkins, Baltimore.

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

     library(Matrix)
     x <- Matrix(rnorm(9), 3, 3)
     ## Not run: 
     qrx <- qr(x)                      # QR factorization of x
     y <- rnorm(3)
     facmul( qr(x), factor = "Q", y)   # form Q y
     ## End(Not run)

