\HeaderA{chol2inv}{Inverse from Choleski Decomposition}{chol2inv}
\aliasA{La.chol2inv}{chol2inv}{La.chol2inv}
\keyword{algebra}{chol2inv}
\keyword{array}{chol2inv}
\begin{Description}\relax
Invert a symmetric, positive definite square matrix from its Choleski
decomposition.
\end{Description}
\begin{Usage}
\begin{verbatim}
chol2inv(x, size = NCOL(x), LINPACK = FALSE)
La.chol2inv(x, size = ncol(x))
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] a matrix.  The first \code{nc} columns of the upper triangle
contain the Choleski decomposition of the matrix to be inverted.
\item[\code{size}] the number of columns of \code{x} containing the
Choleski decomposition.
\item[\code{LINPACK}] logical. Should LINPACK be used (for compatibility with
\R{} < 1.7.0)?
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{chol2inv(LINPACK=TRUE)} provides an interface to the LINPACK
routine DPODI.
\code{La.chol2inv} provides an interface to the LAPACK routine DPOTRI.
\end{Details}
\begin{Value}
The inverse of the decomposed matrix.
\end{Value}
\begin{References}\relax
Dongarra, J. J., Bunch, J. R., Moler, C. B. and Stewart, G. W. (1978)
\emph{LINPACK Users Guide}.
Philadelphia: SIAM Publications.

Anderson. E. and ten others (1999)
\emph{LAPACK Users' Guide}. Third Edition.
SIAM.
Available on-line at
\url{http://www.netlib.org/lapack/lug/lapack_lug.html}.
\end{References}
\begin{SeeAlso}\relax
\code{\LinkA{chol}{chol}},
\code{\LinkA{solve}{solve}}.
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
cma <- chol(ma  <- cbind(1, 1:3, c(1,3,7)))
ma %*% chol2inv(cma)
\end{ExampleCode}
\end{Examples}

