File: ddisna.l

package info (click to toggle)
lapack 3.0.20000531a-28
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 61,920 kB
  • ctags: 46,200
  • sloc: fortran: 584,835; perl: 8,226; makefile: 2,331; awk: 71; sh: 45
file content (73 lines) | stat: -rwxr-xr-x 2,272 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
.TH DDISNA l "15 June 2000" "LAPACK version 3.0" ")"
.SH NAME
DDISNA - compute the reciprocal condition numbers for the eigenvectors of a real symmetric or complex Hermitian matrix or for the left or right singular vectors of a general m-by-n matrix
.SH SYNOPSIS
.TP 19
SUBROUTINE DDISNA(
JOB, M, N, D, SEP, INFO )
.TP 19
.ti +4
CHARACTER
JOB
.TP 19
.ti +4
INTEGER
INFO, M, N
.TP 19
.ti +4
DOUBLE
PRECISION D( * ), SEP( * )
.SH PURPOSE
DDISNA computes the reciprocal condition numbers for the eigenvectors of a real symmetric or complex Hermitian matrix or for the left or right singular vectors of a general m-by-n matrix. The reciprocal condition number is the 'gap' between the corresponding eigenvalue or
singular value and the nearest other one.
.br

The bound on the error, measured by angle in radians, in the I-th
computed vector is given by
.br

       DLAMCH( 'E' ) * ( ANORM / SEP( I ) )
.br

where ANORM = 2-norm(A) = max( abs( D(j) ) ).  SEP(I) is not allowed
to be smaller than DLAMCH( 'E' )*ANORM in order to limit the size of
the error bound.
.br

DDISNA may also be used to compute error bounds for eigenvectors of
the generalized symmetric definite eigenproblem.
.br

.SH ARGUMENTS
.TP 8
JOB     (input) CHARACTER*1
Specifies for which problem the reciprocal condition numbers
should be computed:
.br
= 'E':  the eigenvectors of a symmetric/Hermitian matrix;
.br
= 'L':  the left singular vectors of a general matrix;
.br
= 'R':  the right singular vectors of a general matrix.
.TP 8
M       (input) INTEGER
The number of rows of the matrix. M >= 0.
.TP 8
N       (input) INTEGER
If JOB = 'L' or 'R', the number of columns of the matrix,
in which case N >= 0. Ignored if JOB = 'E'.
.TP 8
D       (input) DOUBLE PRECISION array, dimension (M) if JOB = 'E'
dimension (min(M,N)) if JOB = 'L' or 'R'
The eigenvalues (if JOB = 'E') or singular values (if JOB =
'L' or 'R') of the matrix, in either increasing or decreasing
order. If singular values, they must be non-negative.
.TP 8
SEP     (output) DOUBLE PRECISION array, dimension (M) if JOB = 'E'
dimension (min(M,N)) if JOB = 'L' or 'R'
The reciprocal condition numbers of the vectors.
.TP 8
INFO    (output) INTEGER
= 0:  successful exit.
.br
< 0:  if INFO = -i, the i-th argument had an illegal value.