SCM

SCM Repository

[matrix] Annotation of /pkg/man/sparseMatrix-class.Rd
ViewVC logotype

Annotation of /pkg/man/sparseMatrix-class.Rd

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1855 - (view) (download) (as text)

1 : maechler 676 \name{sparseMatrix-class}
2 :     \docType{class}
3 : maechler 956 \title{Virtual Class "sparseMatrix" --- Mother of Sparse Matrices}
4 : maechler 676 \alias{sparseMatrix-class}
5 : maechler 1472 %% Group methods
6 :     \alias{Math,sparseMatrix-method}
7 :     %\alias{Math2,sparseMatrix,numeric-method}
8 : maechler 1799 \alias{Ops,sparseMatrix,sparseMatrix-method}
9 :     \alias{Ops,sparseMatrix,numeric-method}
10 :     \alias{Ops,numeric,sparseMatrix-method}
11 : maechler 1654 \alias{Ops,diagonalMatrix,sparseMatrix-method}
12 :     \alias{Ops,sparseMatrix,diagonalMatrix-method}
13 : maechler 1472 %
14 : maechler 1708 \alias{cbind2,sparseMatrix,sparseMatrix-method}
15 :     \alias{cbind2,sparseMatrix,matrix-method}
16 :     \alias{cbind2,matrix,sparseMatrix-method}
17 :     \alias{cbind2,sparseMatrix,numeric-method}
18 :     \alias{cbind2,numeric,sparseMatrix-method}
19 :     \alias{rbind2,sparseMatrix,sparseMatrix-method}
20 :     \alias{rbind2,sparseMatrix,matrix-method}
21 :     \alias{rbind2,matrix,sparseMatrix-method}
22 :     \alias{rbind2,sparseMatrix,numeric-method}
23 :     \alias{rbind2,numeric,sparseMatrix-method}
24 :     %
25 : maechler 1472 \alias{coerce,ANY,sparseMatrix-method}
26 : maechler 1747 \alias{coerce,sparseMatrix,generalMatrix-method}
27 : maechler 1845 \alias{coerce,sparseMatrix,symmetricMatrix-method}
28 :     \alias{coerce,sparseMatrix,triangularMatrix-method}
29 : maechler 956 \alias{-,sparseMatrix,missing-method}
30 : maechler 1472 \alias{diag,sparseMatrix-method}
31 : maechler 1845 \alias{dim<-,sparseMatrix-method}
32 : maechler 676 \alias{show,sparseMatrix-method}
33 : maechler 1852 \alias{summary,sparseMatrix-method}
34 : maechler 1855 %\alias{colMeans, etc are now in ./colSums.Rd
35 : maechler 1271 % graph stuff
36 : maechler 871 \alias{coerce,graph,sparseMatrix-method}
37 : bates 1479 \alias{coerce,graph,CsparseMatrix-method}
38 : maechler 1271 \alias{coerce,graphAM,sparseMatrix-method}
39 : bates 1479 \alias{coerce,graphNEL,CsparseMatrix-method}
40 : maechler 1565 \alias{coerce,graphNEL,TsparseMatrix-method}
41 : maechler 908 \alias{coerce,sparseMatrix,graph-method}
42 :     \alias{coerce,sparseMatrix,graphNEL-method}
43 : maechler 1271 \alias{coerce,TsparseMatrix,graphNEL-method}
44 : maechler 908 \alias{coerce,dgTMatrix,graphNEL-method}
45 : maechler 1271 %
46 : maechler 676 \description{Virtual Mother Class of All Sparse Matrices}
47 :     \section{Slots}{
48 : maechler 925 \describe{
49 :     \item{\code{Dim}:}{Object of class \code{"integer"} - the dimensions
50 :     of the matrix - must be an integer vector with exactly two
51 :     non-negative values.}
52 :     \item{\code{Dimnames}:}{a list of length two - inherited from class
53 : maechler 1281 \code{Matrix}, see \code{\linkS4class{Matrix}}.}
54 : maechler 925 \item{\code{factors}:}{Object of class \code{"list"} - a list
55 :     of factorizations of the matrix. }
56 :     }
57 : maechler 676 }
58 :     \section{Extends}{
59 :     Class \code{"Matrix"}, directly.
60 :     }
61 :     \section{Methods}{
62 :     \describe{
63 : maechler 1855 \item{show}{\code{(object = "sparseMatrix")}: The
64 : maechler 676 \code{\link{show}} method for sparse matrices prints
65 : maechler 1737 \emph{\dQuote{structural}} zeroes as \code{"."} using the
66 :     non-exported \code{prSpMatrix} function which allows further
67 :     customization such as replacing \code{"."} by \code{" "} (blank).
68 :    
69 :     Note that \code{\link{options}(max.print)} will influence how many
70 :     entries of large matrices are printed at all.}
71 : maechler 1855 \item{summary}{\code{(object = "sparseMatrix")}: Returns
72 :     an object of S3 class \code{"sparseSummary"} which is basically a
73 :     \code{\link{data.frame}} with columns \code{(i,j,x)} with the
74 :     non-zero entries. The \code{\link{print}} method resemble's
75 :     Matlab's way of printing sparse matrices.}
76 :     \item{diag}{\code{(x = "sparseMatrix")}: extracts the diagonal of a
77 :     sparse matrix.}
78 :     \item{dim<-}{\code{signature(x = "sparseMatrix", value = "ANY")}:
79 :     allows to \emph{reshape} a sparse matrix to a sparse matrix with
80 :     the same entries but different dimensions. \code{value} must be of
81 :     length two and fulfill \code{prod(value) == prod(dim(x))}.}
82 : maechler 676 }
83 : maechler 1855 See also \code{\link{colSums}}, ... %% FIXME
84 :     for methods with separate help pages.
85 : maechler 676 }
86 : bates 685 \note{
87 :     In method selection for multiplication operations (i.e. \code{\%*\%}
88 : maechler 868 and the two-argument form of \code{\link[base]{crossprod}})
89 : bates 685 the sparseMatrix class takes precedence in the sense that if one
90 :     operand is a sparse matrix and the other is any type of dense matrix
91 :     then the dense matrix is coerced to a \code{dgeMatrix} and the
92 :     appropriate sparse matrix method is used.
93 :     }
94 : maechler 676 %\author{Martin}
95 :     \examples{
96 :     showClass("sparseMatrix") ## and look at the help() of its subclasses
97 : maechler 1737 M <- Matrix(0, 10000, 100)
98 :     M[1,1] <- M[2,3] <- 3.14
99 :     M
100 :     \dontshow{% show() was slow in 0.9975-8 because of slow adjust="fancy"
101 :     op <- options(max.print = 25000, width = 80)
102 :     sink(print(tempfile()))
103 :     stopifnot((st <- system.time(show(M)))[1] < 1.0) # only 0.09 on cmath-3
104 :     sink()
105 :     st
106 :     options(op)
107 : maechler 676 }
108 : maechler 1737 }
109 : maechler 676 \keyword{classes}

root@r-forge.r-project.org
ViewVC Help
Powered by ViewVC 1.0.0  
Thanks to:
Vienna University of Economics and Business Powered By FusionForge