SCM

SCM Repository

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

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

Parent Directory Parent Directory | Revision Log Revision Log


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

1 : bates 480 \name{dsCMatrix-class}
2 : maechler 849 \title{Symmetric, compressed, sparse column matrices}
3 : bates 10 \docType{class}
4 : bates 480 \alias{dsCMatrix-class}
5 : bates 547 \alias{dsTMatrix-class}
6 : bates 480 \alias{solve,dsCMatrix,matrix-method}
7 : bates 683 \alias{solve,dsCMatrix,dgeMatrix-method}
8 : bates 480 \alias{chol,dsCMatrix,missing-method}
9 :     \alias{chol,dsCMatrix,logical-method}
10 :     \alias{t,dsCMatrix-method}
11 : bates 558 \alias{t,dsTMatrix-method}
12 : bates 480 \alias{coerce,dsCMatrix,dgTMatrix-method}
13 :     \alias{coerce,dsCMatrix,dgeMatrix-method}
14 :     \alias{coerce,dsCMatrix,matrix-method}
15 : bates 744 \alias{coerce,dsCMatrix,lsCMatrix-method}
16 : bates 558 \alias{coerce,dsTMatrix,matrix-method}
17 :     \alias{coerce,dsTMatrix,dgeMatrix-method}
18 : bates 589 \alias{coerce,dsTMatrix,dsCMatrix-method}
19 : bates 558 \alias{coerce,dsTMatrix,dsyMatrix-method}
20 : bates 863 \alias{coerce,graphNEL,dsCMatrix-method}
21 : bates 480 \alias{determinant,dsCMatrix,missing-method}
22 :     \alias{determinant,dsCMatrix,logical-method}
23 :     \description{The \code{dsCMatrix} class is a class of symmetric, sparse
24 : bates 10 matrices in the compressed, column-oriented format. In this
25 :     implementation the non-zero elements in the columns are sorted into
26 : bates 547 increasing row order. The \code{dsTMatrix} class is a class of
27 :     symmetric, sparse matrices in triplet format.}
28 : bates 10 \section{Objects from the Class}{
29 : bates 547 Objects can be created by calls of the form \code{new("dsCMatrix",
30 :     ...)} or \code{new("dsTMatrix", ...)}
31 : bates 10 }
32 :     \section{Slots}{
33 :     \describe{
34 :     \item{\code{uplo}:}{A character object indicating if the upper
35 :     triangle (\code{"U"} or \code{"u"}) or the lower triangle
36 :     (\code{"L"} or \code{"l"}) is stored. At present only the lower
37 :     triangle form is allowed.}
38 :     \item{\code{p}:}{Object of class \code{"integer"} of pointers, one
39 :     for each column, to the initial (zero-based) index of elements in
40 : bates 547 the column. (Only present in the \code{dsCMatrix} class.)}
41 : bates 10 \item{\code{i}:}{Object of class \code{"integer"} of length nnzero
42 :     (number of non-zero elements). These are the row numbers for
43 :     each non-zero element in the matrix.}
44 : bates 547 \item{\code{j}:}{Object of class \code{"integer"} of length nnzero
45 :     (number of non-zero elements). These are the column numbers for
46 :     each non-zero element in the matrix. (Only present in the
47 : maechler 849 \code{dsTMatrix} class.)}
48 : bates 10 \item{\code{x}:}{Object of class \code{"numeric"} - the non-zero
49 :     elements of the matrix.}
50 : bates 476 \item{\code{factors}:}{Object of class \code{"list"} - a list
51 : bates 10 of factorizations of the matrix. }
52 :     \item{\code{Dim}:}{Object of class \code{"integer"} - the dimensions
53 :     of the matrix - must be an integer vector with exactly two
54 :     non-negative values.}
55 :     }
56 :     }
57 :     \section{Extends}{
58 : bates 480 Class \code{"dgCMatrix"}, directly.
59 : bates 10 }
60 :     \section{Methods}{
61 :     \describe{
62 : bates 480 \item{solve}{\code{signature(a = "dsCMatrix", b = "matrix")}: Solve
63 : bates 10 a linear system of equations defined by \code{x} using a Cholesky
64 :     decomposition.}
65 : bates 480 \item{chol}{\code{signature(x = "dsCMatrix", pivot = "logical")}:
66 : bates 10 Returns (and stores) the Cholesky decomposition of the matrix
67 :     \code{x}. If \code{pivot} is \code{TRUE} (the default) Metis is
68 :     used to create a reordering of the rows and columns of \code{x} so
69 :     as to minimize fill-in.}
70 : bates 480 \item{determinant}{\code{signature(x = "dsCMatrix", logarithm =
71 : bates 396 "missing")}: Evaluate the determinant of \code{x} on the
72 :     logarithm scale. This creates and stores the Cholesky factorization.}
73 : bates 480 \item{determinant}{\code{signature(x = "dsCMatrix", logarithm =
74 : bates 396 "logical")}: Evaluate the determinant of \code{x} on the
75 :     logarithm scale or not, according to the \code{logarithm}
76 :     argument. This creates and stores the Cholesky factorization.}
77 : bates 558 \item{t}{\code{signature(x = "dsCMatrix")}: Transpose. Because
78 :     \code{x} is symmetric this has no effect.}
79 :     \item{t}{\code{signature(x = "dsTMatrix")}: Transpose. For the
80 :     \code{dsTMatrix} class the row and column indices are interchanged
81 :     so that a matrix for which the upper triangle is stored produces a
82 :     matrix for which the lower triangle is stored and vice versa.}
83 : bates 480 \item{coerce}{\code{signature(from = "dsCMatrix", to = "dgTMatrix")}}
84 :     \item{coerce}{\code{signature(from = "dsCMatrix", to = "dgeMatrix")}}
85 :     \item{coerce}{\code{signature(from = "dsCMatrix", to = "matrix")}}
86 : bates 558 \item{coerce}{\code{signature(from = "dsTMatrix", to = "dgeMatrix")}}
87 : bates 589 \item{coerce}{\code{signature(from = "dsTMatrix", to = "dsCMatrix")}}
88 : bates 558 \item{coerce}{\code{signature(from = "dsTMatrix", to = "dsyMatrix")}}
89 :     \item{coerce}{\code{signature(from = "dsTMatrix", to = "matrix")}}
90 : bates 10 }
91 :     }
92 :     %\references{}
93 :     %\author{}
94 :     %\note{}
95 :     \seealso{
96 : bates 480 \code{\link{dgCMatrix-class}}, \code{\link{dgTMatrix-class}},
97 :     \code{\link{dgeMatrix-class}}
98 : bates 10 }
99 :     %\examples{}
100 :     \keyword{classes}
101 :     \keyword{algebra}

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