.TH DLANEG 1 "November 2006" " LAPACK auxiliary routine (version 3.1) " " LAPACK auxiliary routine (version 3.1) "
.SH NAME
DLANEG - the Sturm count, the number of negative pivots encountered while factoring tridiagonal T - sigma I = L D L^T
.SH SYNOPSIS
.TP 17
FUNCTION DLANEG(
N, D, LLD, SIGMA, PIVMIN, R )
.TP 17
.ti +4
IMPLICIT
NONE
.TP 17
.ti +4
INTEGER
DLANEG
.TP 17
.ti +4
INTEGER
N, R
.TP 17
.ti +4
DOUBLE
PRECISION PIVMIN, SIGMA
.TP 17
.ti +4
DOUBLE
PRECISION D( * ), LLD( * )
.SH PURPOSE
DLANEG computes the Sturm count, the number of negative pivots
encountered while factoring tridiagonal T - sigma I = L D L^T.
This implementation works directly on the factors without forming
the tridiagonal matrix T. The Sturm count is also the number of
eigenvalues of T less than sigma.
.br
This routine is called from DLARRB.
.br
The current routine does not use the PIVMIN parameter but rather
requires IEEE-754 propagation of Infinities and NaNs. This
routine also has no input range restrictions but does require
default exception handling such that x/0 produces Inf when x is
non-zero, and Inf/Inf produces NaN. For more information, see:
Marques, Riedy, and Voemel, "Benefits of IEEE-754 Features in
Modern Symmetric Tridiagonal Eigensolvers," SIAM Journal on
Scientific Computing, v28, n5, 2006. DOI 10.1137/050641624
(Tech report version in LAWN 172 with the same title.)
.br
.SH ARGUMENTS
.TP 8
N (input) INTEGER
The order of the matrix.
.TP 8
D (input) DOUBLE PRECISION array, dimension (N)
The N diagonal elements of the diagonal matrix D.
.TP 8
LLD (input) DOUBLE PRECISION array, dimension (N-1)
The (N-1) elements L(i)*L(i)*D(i).
.TP 8
SIGMA (input) DOUBLE PRECISION
Shift amount in T - sigma I = L D L^T.
.TP 8
PIVMIN (input) DOUBLE PRECISION
The minimum pivot in the Sturm sequence. May be used
when zero pivots are encountered on non-IEEE-754
architectures.
.TP 8
R (input) INTEGER
The twist index for the twisted factorization that is used
for the negcount.
.SH FURTHER DETAILS
Based on contributions by
.br
Osni Marques, LBNL/NERSC, USA
.br
Christof Voemel, University of California, Berkeley, USA
Jason Riedy, University of California, Berkeley, USA
.br