SCM

SCM Repository

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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 871, Fri Aug 26 17:26:49 2005 UTC revision 2005, Wed Jul 18 14:46:20 2007 UTC
# Line 1  Line 1 
1  \name{sparseMatrix-class}  \name{sparseMatrix-class}
2  \docType{class}  \docType{class}
3    \title{Virtual Class "sparseMatrix" --- Mother of Sparse Matrices}
4  \alias{sparseMatrix-class}  \alias{sparseMatrix-class}
5    %% Group methods
6    \alias{Math,sparseMatrix-method}
7    %\alias{Math2,sparseMatrix,numeric-method}
8    \alias{Ops,sparseMatrix,sparseMatrix-method}
9    \alias{Ops,sparseMatrix,numeric-method}
10    \alias{Ops,numeric,sparseMatrix-method}
11    \alias{Ops,diagonalMatrix,sparseMatrix-method}
12    \alias{Ops,sparseMatrix,diagonalMatrix-method}
13    %
14    \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    \alias{coerce,ANY,sparseMatrix-method}
26    \alias{coerce,factor,sparseMatrix-method}
27    \alias{coerce,sparseMatrix,generalMatrix-method}
28    \alias{coerce,sparseMatrix,symmetricMatrix-method}
29    \alias{coerce,sparseMatrix,triangularMatrix-method}
30    \alias{-,sparseMatrix,missing-method}
31    \alias{diag,sparseMatrix-method}
32    \alias{dim<-,sparseMatrix-method}
33    \alias{print,sparseMatrix-method}
34  \alias{show,sparseMatrix-method}  \alias{show,sparseMatrix-method}
35  \alias{\%*\%,sparseMatrix,ddenseMatrix-method}  \alias{summary,sparseMatrix-method}
36  \alias{\%*\%,ddenseMatrix,sparseMatrix-method}  \alias{norm,sparseMatrix,character-method}
37  \alias{crossprod,sparseMatrix,ddenseMatrix-method}  %\alias{colMeans,..} etc are now in ./colSums.Rd
38  \alias{crossprod,ddenseMatrix,sparseMatrix-method}  % graph stuff
39  \alias{coerce,graph,sparseMatrix-method}  \alias{coerce,graph,sparseMatrix-method}
40  \alias{coerce,graphNEL,sparseMatrix-method}  \alias{coerce,graph,CsparseMatrix-method}
41  \title{Virtual Class "sparseMatrix" --- Mother of Sparse Matrices}  \alias{coerce,graphAM,sparseMatrix-method}
42    \alias{coerce,graphNEL,CsparseMatrix-method}
43    \alias{coerce,graphNEL,TsparseMatrix-method}
44    \alias{coerce,sparseMatrix,graph-method}
45    \alias{coerce,sparseMatrix,graphNEL-method}
46    \alias{coerce,TsparseMatrix,graphNEL-method}
47    \alias{coerce,dgTMatrix,graphNEL-method}
48    %
49  \description{Virtual Mother Class of All Sparse Matrices}  \description{Virtual Mother Class of All Sparse Matrices}
50  \section{Slots}{  \section{Slots}{
51    \code{Dim}, and \code{Dimnames}, see \code{\link{Matrix-class}}.    \describe{
52  % Should this be "written in stone" or should they be added?      \item{\code{Dim}:}{Object of class \code{"integer"} - the dimensions
53  %   Note that the current implementation keeps \code{Dimnames} empty for       of the matrix - must be an integer vector with exactly two
54  %   sparse matrices.       non-negative values.}
55        \item{\code{Dimnames}:}{a list of length two - inherited from class
56          \code{Matrix}, see \code{\linkS4class{Matrix}}.}
57        \item{\code{factors}:}{Object of class \code{"list"} - a list
58          of factorizations of the matrix. }
59      }
60  }  }
61  \section{Extends}{  \section{Extends}{
62    Class \code{"Matrix"}, directly.    Class \code{"Matrix"}, directly.
63  }  }
64  \section{Methods}{  \section{Methods}{
65    \describe{    \describe{
66      \item{show}{\code{signature(object = "sparseMatrix")}: The      \item{show}{\code{(object = "sparseMatrix")}: The
67        \code{\link{show}} method for sparse matrices prints        \code{\link{show}} method for sparse matrices prints
68        \emph{\dQuote{structural}} zeroes as \code{"."} or blank.}        \emph{\dQuote{structural}} zeroes as \code{"."} using
69          \code{\link{printSpMatrix}()} which allows further customization.}
70        \item{print}{\code{signature(x = "sparseMatrix")}, ....\cr
71          The \code{\link{print}} method for sparse matrices by default is the
72          same as \code{show()} but can be called with extra optional
73          arguments, see \code{\link{printSpMatrix}()}.}
74        \item{summary}{\code{(object = "sparseMatrix")}: Returns
75          an object of S3 class \code{"sparseSummary"} which is basically a
76          \code{\link{data.frame}} with columns \code{(i,j,x)} with the
77          non-zero entries.   The \code{\link{print}} method resemble's
78          Matlab's way of printing sparse matrices.}
79        \item{diag}{\code{(x = "sparseMatrix")}: extracts the diagonal of a
80          sparse matrix.}
81        \item{dim<-}{\code{signature(x = "sparseMatrix", value = "ANY")}:
82          allows to \emph{reshape} a sparse matrix to a sparse matrix with
83          the same entries but different dimensions. \code{value} must be of
84          length two and fulfill \code{prod(value) == prod(dim(x))}.}
85        \item{coerce}{\code{signature(from = "factor", to = "sparseMatrix")}:
86          Coercion of a factor to \code{"sparseMatrix"} produces the matrix
87          of indicator \bold{rows} stored as an object of class
88          \code{"dgCMatrix"}.  To obtain columns representing the interaction
89          of the factor and a numeric covariate, replace the \code{"x"} slot
90          of the result by the numeric covariate then take the transpose.}
91    }    }
92      See also \code{\link{colSums}}, ... %% FIXME
93      for methods with separate help pages.
94  }  }
95  \note{  \note{
96    In method selection for multiplication operations (i.e. \code{\%*\%}    In method selection for multiplication operations (i.e. \code{\%*\%}
# Line 37  Line 103 
103  %\author{Martin}  %\author{Martin}
104  \examples{  \examples{
105  showClass("sparseMatrix") ## and look at the help() of its subclasses  showClass("sparseMatrix") ## and look at the help() of its subclasses
106    M <- Matrix(0, 10000, 100)
107    M[1,1] <- M[2,3] <- 3.14
108    M  ## show(.) method suppresses printing of the majority of rows
109    
110    ## factor -> t( <sparse design matrix> ) :
111    (fact <- gl(5, 3, 30, labels = LETTERS[1:5]))
112    (Xt <- as(fact, "sparseMatrix"))  # indicator rows
113    X <- t(Xt)
114  }  }
115  \keyword{classes}  \keyword{classes}

Legend:
Removed from v.871  
changed lines
  Added in v.2005

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