next up previous contents index
Next: Examples Up: Symmetric Indefinite Linear Systems Previous: Purpose   Contents   Index

Arguments

A
(input/output) REAL or COMPLEX square array, shape $(:,:)$.
On entry, the matrix $A$.
If ${\bf UPLO}$ = 'U', the upper triangular part of A contains the upper triangular part of the matrix $A$, and the strictly lower triangular part of ${\bf A}$ is not referenced.
If ${\bf UPLO}$ = 'L', the lower triangular part of ${\bf A}$ contains the lower triangular part of the matrix $A$, and the strictly upper triangular part of ${\bf A}$ is not referenced.
On exit, the block diagonal matrix $D$ and the multipliers used to obtain the factor $U$ or $L$ from the factorization of $A$.

B
(input/output) REAL or COMPLEX array, shape $(:,:)$ with $size({\bf B},1) = size({\bf A},1)$ or shape $(:)$ with $size({\bf B})=size({\bf A},1)$.
On entry, the matrix $B$.
On exit, the solution matrix $X$.

UPLO
Optional (input) CHARACTER(LEN=1)

\begin{optionarg}
\item[{$=$\ 'U':}] Upper triangle of $A$\ is stored;
\item[{$=$\ 'L':}] Lower triangle of $A$\ is stored.
\end{optionarg}
Default value: 'U'.

IPIV
Optional (output) INTEGER array, shape $(:)$ with $size({\bf IPIV})=size({\bf A},1)$.
Details of the row and column interchanges and the block structure of $D$.
If ${\bf IPIV}_k > 0$, then rows and columns $k$ and ${\bf IPIV}_k$ were interchanged, and $D_{k,k}$ is a $1 \times 1$ diagonal block.
If ${\bf IPIV}_k < 0$, then there are two cases:

\begin{numbersec}
\item If ${\bf UPLO} =$\ 'U' and ${\bf IPIV}_k = {\bf IPIV}_{...
...nd $D_{k:k+1,k:k+1}$\ is a
\hbox{$2 \times 2$} diagonal block.
\end{numbersec}

INFO
Optional (output) INTEGER

\begin{infoarg}
\item[{$=$\ 0:}] successful exit.
\item[{$<$\ 0:}] if ${\bf IN...
...l matrix $D$\ is
singular, so the solution could not be computed.
\end{infoarg}
If INFO is not present and an error occurs, then the program is terminated with an error message.
References: [1] and [17,9,20,21].
next up previous contents index
Next: Examples Up: Symmetric Indefinite Linear Systems Previous: Purpose   Contents   Index
Susan Blackford 2001-08-19