sparseQR-class            package:Matrix            R Documentation

_S_p_a_r_s_e _Q_R _d_e_c_o_m_p_o_s_i_t_i_o_n _o_f _a _s_p_a_r_s_e _m_a_t_r_i_x

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

     Objects of this class represent a QR decomposition of a sparse
     rectangular matrix.

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

     The decomposition is of the form 'A[p+1,] == Q %*% R', if the 'q'
     slot if of length 0 or 'A[p+1,q+1] == Q %*% R' where A is a sparse
     m by n matrix (m >= n), R is an m by n matrix that is zero below
     the main diagonal.  The 'p' slot is a 0-based permutation of '1:m'
     applied to the rows of the original matrix.  If the 'q' slot has
     length 'n' it is a 0-based permutation of '1:n' applied to the
     columns of the original matrix to reduce the amount of "fill-in"
     in the matrix R.

     The matrix Q is a "virtual matrix".  It is the product of n
     Householder transformations.  The information to generate these
     Householder transformations is stored in the 'V' and 'beta' slots.

     The '"sparseQR"' methods for the 'qr.*' functions return objects
     of class '"dgeMatrix"' (see 'dgeMatrix').  Results from 'qr.coef',
     'qr.resid' and 'qr.fitted' (when 'k == ncol(R)') are well-defined
     and should match those from the corresponding dense matrix
     calculations.  However, because the matrix 'Q' is not uniquely
     defined, the results of 'qr.qy' and 'qr.qty' do not necessarily
     match those from the corresponding dense matrix calculations.

     Also, the results of 'qr.qy' and 'qr.qty' apply to the permuted
     column order when the 'q'  slot has length 'n'.

_O_b_j_e_c_t_s _f_r_o_m _t_h_e _C_l_a_s_s:

     Objects can be created by calls of the form 'new("sparseQR", ...)'
     but are more commonly created by function 'qr' applied to a sparse
     matrix such as a matrix of class 'dgCMatrix'.

_S_l_o_t_s:


     '_V': Object of class '"dgCMatrix"'.  The columns of 'V' are the
          vectors that generate the Householder transformations of
          which the matrix Q is composed.

     '_b_e_t_a': Object of class '"numeric"', the normalizing factors for
          the Householder transformations.

     '_p': Object of class '"integer"': Permutation (of '0:(n-1)')
          applied to the rows of the original matrix.

     '_R': Object of class '"dgCMatrix"' An upper triangular matrix of
          dimension   

     '_q': Object of class '"integer"': Permutation applied from the
          right. Can be of length 0 which implies no permutation.

_M_e_t_h_o_d_s:


     _q_r._R 'signature(qr = "sparseQR")': ... 

     _q_r._c_o_e_f 'signature(qr = "sparseQR", y = "dgeMatrix")': ... 

     _q_r._c_o_e_f 'signature(qr = "sparseQR", y = "matrix")': ... 

     _q_r._c_o_e_f 'signature(qr = "sparseQR", y = "numeric")': ... 

     _q_r._f_i_t_t_e_d 'signature(qr = "sparseQR", y = "dgeMatrix")': ... 

     _q_r._f_i_t_t_e_d 'signature(qr = "sparseQR", y = "matrix")': ... 

     _q_r._f_i_t_t_e_d 'signature(qr = "sparseQR", y = "numeric")': ... 

     _q_r._q_t_y 'signature(qr = "sparseQR", y = "dgeMatrix")': ... 

     _q_r._q_t_y 'signature(qr = "sparseQR", y = "matrix")': ... 

     _q_r._q_t_y 'signature(qr = "sparseQR", y = "numeric")': ... 

     _q_r._q_y 'signature(qr = "sparseQR", y = "dgeMatrix")': ... 

     _q_r._q_y 'signature(qr = "sparseQR", y = "matrix")': ... 

     _q_r._q_y 'signature(qr = "sparseQR", y = "numeric")': ... 

     _q_r._r_e_s_i_d 'signature(qr = "sparseQR", y = "dgeMatrix")': ... 

     _q_r._r_e_s_i_d 'signature(qr = "sparseQR", y = "matrix")': ... 

     _q_r._r_e_s_i_d 'signature(qr = "sparseQR", y = "numeric")': ... 

     _s_o_l_v_e 'signature(a = "sparseQR", b = "ANY")': simply uses
          'qr.coef(a,b)'.

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

     'qr', 'qr.Q', 'qr.R',     'qr.fitted', 'qr.resid', 'qr.coef',
     'qr.qty',   'qr.qy', 'dgCMatrix', 'dgeMatrix'.

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

     data(KNex); mm <- KNex$mm
     str(mmQR <- qr(mm))

