SCM

SCM Repository

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

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

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

revision 481, Wed Feb 2 15:01:50 2005 UTC revision 956, Fri Sep 30 17:28:00 2005 UTC
# Line 1  Line 1 
1  \name{dsyMatrix-class}  \name{dsyMatrix-class}
2  \docType{class}  \docType{class}
3  \alias{\%*\%,dgeMatrix,dsyMatrix-method}  \alias{\%*\%,dgeMatrix,dsyMatrix-method}
4    \alias{\%*\%,dspMatrix,dgeMatrix-method}
5    \alias{\%*\%,dspMatrix,integer-method}
6    \alias{\%*\%,dspMatrix,matrix-method}
7    \alias{\%*\%,dspMatrix,numeric-method}
8  \alias{\%*\%,dsyMatrix,dgeMatrix-method}  \alias{\%*\%,dsyMatrix,dgeMatrix-method}
9  \alias{dsyMatrix-class}  \alias{coerce,dspMatrix,dgeMatrix-method}
10    \alias{coerce,dspMatrix,dsyMatrix-method}
11    \alias{coerce,dspMatrix,lspMatrix-method}
12    \alias{coerce,dspMatrix,matrix-method}
13  \alias{coerce,dsyMatrix,dgeMatrix-method}  \alias{coerce,dsyMatrix,dgeMatrix-method}
14    \alias{coerce,dsyMatrix,dspMatrix-method}
15    \alias{coerce,dsyMatrix,lsyMatrix-method}
16  \alias{coerce,dsyMatrix,matrix-method}  \alias{coerce,dsyMatrix,matrix-method}
17    \alias{show,dsyMatrix-method}
18    \alias{dspMatrix-class}
19    \alias{dsyMatrix-class}
20    \alias{norm,dspMatrix,character-method}
21    \alias{norm,dspMatrix,missing-method}
22  \alias{norm,dsyMatrix,character-method}  \alias{norm,dsyMatrix,character-method}
23  \alias{norm,dsyMatrix,missing-method}  \alias{norm,dsyMatrix,missing-method}
24    \alias{rcond,dspMatrix,character-method}
25    \alias{rcond,dspMatrix,missing-method}
26    \alias{rcond,dsyMatrix,character-method}
27    \alias{rcond,dsyMatrix,missing-method}
28    \alias{solve,dspMatrix,dgeMatrix-method}
29    \alias{solve,dspMatrix,integer-method}
30    \alias{solve,dspMatrix,matrix-method}
31    \alias{solve,dspMatrix,missing-method}
32    \alias{solve,dspMatrix,numeric-method}
33    \alias{solve,dsyMatrix,dgeMatrix-method}
34    \alias{solve,dsyMatrix,matrix-method}
35    \alias{solve,dsyMatrix,missing-method}
36    \alias{t,dspMatrix-method}
37  \alias{t,dsyMatrix-method}  \alias{t,dsyMatrix-method}
38  \title{Class "dsyMatrix" of symmetric matrices}  \alias{unpack,dspMatrix-method}
39  \description{The \code{"dsyMatrix"} class is the class of symmetric  \title{Symmetric Dense Numeric Matrices}
40    matrices in non-packed storage.  Only the upper triangle or the lower  \description{
41    triangle is stored.}    The \code{"dsyMatrix"} class is the class of symmetric, dense matrices
42      in non-packed storage and \code{"dspMatrix"} is the class of symmetric
43      dense matrices in packed storage.  Only the upper triangle or the
44      lower triangle is stored.
45    }
46  \section{Objects from the Class}{  \section{Objects from the Class}{
47  Objects can be created by calls of the form \code{new("dsyMatrix", ...)}.  Objects can be created by calls of the form \code{new("dsyMatrix", ...)}.
48  }  }
# Line 21  Line 52 
52        either "U", for upper triangular, and "L", for lower triangular.}        either "U", for upper triangular, and "L", for lower triangular.}
53      \item{\code{x}:}{Object of class \code{"numeric"}. The numeric      \item{\code{x}:}{Object of class \code{"numeric"}. The numeric
54        values that constitute the matrix, stored in column-major order.}        values that constitute the matrix, stored in column-major order.}
55      \item{\code{Dim}:}{Object of class \code{"integer"}. The dimensions      \item{\code{Dim},\code{Dimnames}:}{The dimension (a length-2
56        of the matrix which must be a two-element vector of non-negative        \code{"integer"}) and corresponding names (or \code{NULL}), see the
57        integers.}        \code{\link{Matrix-class}}.}
     \item{\code{norm}:}{Object of class \code{"numeric"}. A named  
       numeric vector of norms of the matrix.  Some possible components  
       are \code{"O"}, the one norm; \code{"I"}, the infinity norm;  
       \code{"F"}, the Frobenius norm; and \code{"M"}, the maximum  
       absolute value.}  
58      \item{\code{rcond}:}{Object of class \code{"numeric"}. A named      \item{\code{rcond}:}{Object of class \code{"numeric"}. A named
59        numeric vector of reciprocal condition numbers in either the        numeric vector of reciprocal condition numbers in either the
60        1-norm \code{"O"} or the infinity norm \code{"I"}.}        1-norm \code{"O"} or the infinity norm \code{"I"}.}
# Line 37  Line 63 
63    }    }
64  }  }
65  \section{Extends}{  \section{Extends}{
66  Class \code{"dgeMatrix"}, directly.    \code{"dsyMatrix"} extends class \code{"dgeMatrix"}, directly, whereas\cr
67  Class \code{"Matrix"}, by class \code{"dgeMatrix"}.    \code{"dspMatrix"} extends class \code{"ddenseMatrix"}, directly.
68    
69      Both extend class \code{"symmetricMatrix"}, directly,
70      and class \code{"Matrix"} and others, \emph{in}directly, use
71      \code{\link{showClass}("dsyMatrix")}, e.g., for details.
72  }  }
73  \section{Methods}{  \section{Methods}{
74    \describe{    \describe{
75        \item{coerce}{\code{signature(from = "dspMatrix", to = "dgeMatrix")}}
76      \item{coerce}{\code{signature(from = "dsyMatrix", to = "dgeMatrix")}}      \item{coerce}{\code{signature(from = "dsyMatrix", to = "dgeMatrix")}}
77        \item{coerce}{\code{signature(from = "dspMatrix", to = "matrix")}}
78      \item{coerce}{\code{signature(from = "dsyMatrix", to = "matrix")}}      \item{coerce}{\code{signature(from = "dsyMatrix", to = "matrix")}}
79        \item{coerce}{\code{signature(from = "dsyMatrix", to = "dspMatrix")}}
80        \item{coerce}{\code{signature(from = "dspMatrix", to = "dsyMatrix")}}
81        \item{norm}{\code{signature(x = "dspMatrix", type = "character")}}
82      \item{norm}{\code{signature(x = "dsyMatrix", type = "character")}}      \item{norm}{\code{signature(x = "dsyMatrix", type = "character")}}
83        \item{norm}{\code{signature(x = "dspMatrix", type = "missing")}}
84        \item{norm}{\code{signature(x = "dsyMatrix", type = "missing")}}
85        \item{solve}{\code{signature(a = "dspMatrix", b = "missing")}}
86        \item{solve}{\code{signature(a = "dsyMatrix", b = "missing")}}
87        \item{solve}{\code{signature(a = "dspMatrix", b = "dgeMatrix")}}
88        \item{solve}{\code{signature(a = "dsyMatrix", b = "dgeMatrix")}}
89        \item{solve}{\code{signature(a = "dspMatrix", b = "matrix")}}
90        \item{solve}{\code{signature(a = "dsyMatrix", b = "matrix")}}
91    }    }
92  }  }
93  %\references{}  %\references{}
94  %\author{}  %\author{}
95  \seealso{  \seealso{
96    \code{\link{dgeMatrix-class}}, \code{\link{Matrix-class}}    \code{\link{dgeMatrix-class}}, \code{\link{Matrix-class}},
97      \code{\link[base]{solve}}, \code{\link{norm}}, \code{\link{rcond}},
98      \code{\link[base]{t}}
99    }
100    \examples{
101    ## Only upper triangular part matters (when uplo == "U" as per default)
102    (sy2 <- new("dsyMatrix", Dim = as.integer(c(2,2)), x = c(14, NA,32,77)))
103    (c2 <- chol(sy2))
104    all.equal(c2, c2. <- chol(as(sy2, "dpoMatrix")))# equal, but not same class
105    str(c2)
106    
107    ## An example where chol() can't work
108    (sy3 <- new("dsyMatrix", Dim = as.integer(c(2,2)), x = c(14, -1, 2, -7)))
109    
110    validObject(as(sy3, "dpoMatrix"), test=TRUE) # >> is not pos.def.
111    % .... Lapack routine dpotrf returned error code 2 -- FIXME: better message
112    try(chol(sy3)) ## Error: not pos.def
113  }  }
 %\examples{}  
114  \keyword{classes}  \keyword{classes}

Legend:
Removed from v.481  
changed lines
  Added in v.956

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