nnzero                package:Matrix                R Documentation

_T_h_e _N_u_m_b_e_r _o_f _N_o_n-_Z_e_r_o _V_a_l_u_e_s _o_f _a _M_a_t_r_i_x

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

     Returns the number of non-zero values of a numeric-like R object,
     and in particular an object 'x' inheriting from class 'Matrix'.

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

     nnzero(x, na.counted = NA)

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

       x: an R object, typically inheriting from class 'Matrix' or
          'numeric'.

na.counted: a 'logical' describing how 'NA's should be counted.  There
          are three possible settings for 'na.counted':

          _T_R_U_E 'NA's _are_ counted as non-zero (since they are not
               zero).

          _N_A (default)the result will be 'NA' if there are 'NA''s in
               'x' (since NA's are not known, i.e., _may be_ zero).

          _F_A_L_S_E 'NA's are _omitted_ from 'x' before the non-zero
               entries are counted.

          For sparse matrices, you may often want to use 'na.counted =
          TRUE'. 

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

     the number of non zero entries in 'x' (typically 'integer').

     Note that for a _symmetric_ sparse matrix 'S' (i.e., inheriting
     from class 'symmetricMatrix'), 'nnzero(S)' is typically _twice_
     the 'length(S@x)'.

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

     The 'Matrix' class also has a 'length' method; typically,
     'length(M)' is much larger than 'nnzero(M)' for a sparse matrix M,
     and the latter is a better indication of the _size_ of 'M'.

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

     m <- Matrix(0+1:28, nrow = 4)
     m[-3,c(2,4:5,7)] <- m[ 3, 1:4] <- m[1:3, 6] <- 0
     (mT <- as(m, "dgTMatrix"))
     nnzero(mT)
     (S <- crossprod(mT))
     nnzero(S)
     str(S) # slots are smaller than nnzero()
     stopifnot(nnzero(S) == sum(as.matrix(S) != 0))# failed earlier

     data(KNex)
     M <- KNex$mm
     class(M)
     dim(M)
     length(M); stopifnot(length(M) == prod(dim(M)))
     nnzero(M) # more relevant than length
     ## the above are also visible from
     str(M)

