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