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 1898, Fri Jun 15 23:13:43 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{show,sparseMatrix-method}  \alias{show,sparseMatrix-method}
34  \alias{\%*\%,sparseMatrix,ddenseMatrix-method}  \alias{summary,sparseMatrix-method}
35  \alias{\%*\%,ddenseMatrix,sparseMatrix-method}  %\alias{colMeans,..} etc are now in ./colSums.Rd
36  \alias{crossprod,sparseMatrix,ddenseMatrix-method}  % graph stuff
 \alias{crossprod,ddenseMatrix,sparseMatrix-method}  
37  \alias{coerce,graph,sparseMatrix-method}  \alias{coerce,graph,sparseMatrix-method}
38  \alias{coerce,graphNEL,sparseMatrix-method}  \alias{coerce,graph,CsparseMatrix-method}
39  \title{Virtual Class "sparseMatrix" --- Mother of Sparse Matrices}  \alias{coerce,graphAM,sparseMatrix-method}
40    \alias{coerce,graphNEL,CsparseMatrix-method}
41    \alias{coerce,graphNEL,TsparseMatrix-method}
42    \alias{coerce,sparseMatrix,graph-method}
43    \alias{coerce,sparseMatrix,graphNEL-method}
44    \alias{coerce,TsparseMatrix,graphNEL-method}
45    \alias{coerce,dgTMatrix,graphNEL-method}
46    %
47  \description{Virtual Mother Class of All Sparse Matrices}  \description{Virtual Mother Class of All Sparse Matrices}
48  \section{Slots}{  \section{Slots}{
49    \code{Dim}, and \code{Dimnames}, see \code{\link{Matrix-class}}.    \describe{
50  % Should this be "written in stone" or should they be added?      \item{\code{Dim}:}{Object of class \code{"integer"} - the dimensions
51  %   Note that the current implementation keeps \code{Dimnames} empty for       of the matrix - must be an integer vector with exactly two
52  %   sparse matrices.       non-negative values.}
53        \item{\code{Dimnames}:}{a list of length two - inherited from class
54          \code{Matrix}, see \code{\linkS4class{Matrix}}.}
55        \item{\code{factors}:}{Object of class \code{"list"} - a list
56          of factorizations of the matrix. }
57      }
58  }  }
59  \section{Extends}{  \section{Extends}{
60    Class \code{"Matrix"}, directly.    Class \code{"Matrix"}, directly.
61  }  }
62  \section{Methods}{  \section{Methods}{
63    \describe{    \describe{
64      \item{show}{\code{signature(object = "sparseMatrix")}: The      \item{show}{\code{(object = "sparseMatrix")}: The
65        \code{\link{show}} method for sparse matrices prints        \code{\link{show}} method for sparse matrices prints
66        \emph{\dQuote{structural}} zeroes as \code{"."} or blank.}        \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        \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        \item{coerce}{\code{signature(from "factor", to = "sparseMatrix")}:
84          Coercion of a factor to \code{"sparseMatrix"} produces the matrix
85          of indicator \bf{rows} stored as an object of class
86          \code{"dgCMatrix"}.  To obtain columns represent the interaction
87          of the factor and a numeric covariate, replace the \code{"x"} slot
88          of the result by the numeric covariate then take the transpose.}
89    }    }
90      See also \code{\link{colSums}}, ... %% FIXME
91      for methods with separate help pages.
92  }  }
93  \note{  \note{
94    In method selection for multiplication operations (i.e. \code{\%*\%}    In method selection for multiplication operations (i.e. \code{\%*\%}
# Line 37  Line 101 
101  %\author{Martin}  %\author{Martin}
102  \examples{  \examples{
103  showClass("sparseMatrix") ## and look at the help() of its subclasses  showClass("sparseMatrix") ## and look at the help() of its subclasses
104    M <- Matrix(0, 10000, 100)
105    M[1,1] <- M[2,3] <- 3.14
106    M
107    str(fact <- gl(5, 3, labels = LETTERS[1:5]))
108    as(fact, "sparseMatrix")  # indicator rows
109    \dontshow{% show() was slow in 0.9975-8 because of slow adjust="fancy"
110    op <- options(max.print = 25000, width = 80)
111    sink(print(tempfile()))
112    stopifnot((st <- system.time(show(M)))[1] < 1.0) # only 0.09 on cmath-3
113    sink()
114    st
115    options(op)
116    }
117  }  }
118  \keyword{classes}  \keyword{classes}

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

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