annotate libcruft/lapack/dlae2.f @ 3333:15cddaacbc2d

[project @ 1999-11-03 19:53:59 by jwe]
author jwe
date Wed, 03 Nov 1999 19:54:52 +0000
parents ffa60dc8e49b
children 68db500cb558
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2814
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
1 SUBROUTINE DLAE2( A, B, C, RT1, RT2 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
2 *
3333
15cddaacbc2d [project @ 1999-11-03 19:53:59 by jwe]
jwe
parents: 2814
diff changeset
3 * -- LAPACK auxiliary routine (version 3.0) --
2814
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
4 * Univ. of Tennessee, Univ. of California Berkeley, NAG Ltd.,
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
5 * Courant Institute, Argonne National Lab, and Rice University
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
6 * October 31, 1992
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
7 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
8 * .. Scalar Arguments ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
9 DOUBLE PRECISION A, B, C, RT1, RT2
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
10 * ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
11 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
12 * Purpose
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
13 * =======
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
14 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
15 * DLAE2 computes the eigenvalues of a 2-by-2 symmetric matrix
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
16 * [ A B ]
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
17 * [ B C ].
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
18 * On return, RT1 is the eigenvalue of larger absolute value, and RT2
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
19 * is the eigenvalue of smaller absolute value.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
20 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
21 * Arguments
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
22 * =========
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
23 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
24 * A (input) DOUBLE PRECISION
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
25 * The (1,1) element of the 2-by-2 matrix.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
26 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
27 * B (input) DOUBLE PRECISION
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
28 * The (1,2) and (2,1) elements of the 2-by-2 matrix.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
29 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
30 * C (input) DOUBLE PRECISION
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
31 * The (2,2) element of the 2-by-2 matrix.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
32 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
33 * RT1 (output) DOUBLE PRECISION
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
34 * The eigenvalue of larger absolute value.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
35 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
36 * RT2 (output) DOUBLE PRECISION
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
37 * The eigenvalue of smaller absolute value.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
38 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
39 * Further Details
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
40 * ===============
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
41 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
42 * RT1 is accurate to a few ulps barring over/underflow.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
43 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
44 * RT2 may be inaccurate if there is massive cancellation in the
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
45 * determinant A*C-B*B; higher precision or correctly rounded or
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
46 * correctly truncated arithmetic would be needed to compute RT2
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
47 * accurately in all cases.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
48 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
49 * Overflow is possible only if RT1 is within a factor of 5 of overflow.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
50 * Underflow is harmless if the input data is 0 or exceeds
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
51 * underflow_threshold / macheps.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
52 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
53 * =====================================================================
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
54 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
55 * .. Parameters ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
56 DOUBLE PRECISION ONE
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
57 PARAMETER ( ONE = 1.0D0 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
58 DOUBLE PRECISION TWO
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
59 PARAMETER ( TWO = 2.0D0 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
60 DOUBLE PRECISION ZERO
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
61 PARAMETER ( ZERO = 0.0D0 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
62 DOUBLE PRECISION HALF
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
63 PARAMETER ( HALF = 0.5D0 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
64 * ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
65 * .. Local Scalars ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
66 DOUBLE PRECISION AB, ACMN, ACMX, ADF, DF, RT, SM, TB
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
67 * ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
68 * .. Intrinsic Functions ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
69 INTRINSIC ABS, SQRT
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
70 * ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
71 * .. Executable Statements ..
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
72 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
73 * Compute the eigenvalues
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
74 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
75 SM = A + C
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
76 DF = A - C
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
77 ADF = ABS( DF )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
78 TB = B + B
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
79 AB = ABS( TB )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
80 IF( ABS( A ).GT.ABS( C ) ) THEN
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
81 ACMX = A
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
82 ACMN = C
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
83 ELSE
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
84 ACMX = C
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
85 ACMN = A
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
86 END IF
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
87 IF( ADF.GT.AB ) THEN
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
88 RT = ADF*SQRT( ONE+( AB / ADF )**2 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
89 ELSE IF( ADF.LT.AB ) THEN
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
90 RT = AB*SQRT( ONE+( ADF / AB )**2 )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
91 ELSE
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
92 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
93 * Includes case AB=ADF=0
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
94 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
95 RT = AB*SQRT( TWO )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
96 END IF
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
97 IF( SM.LT.ZERO ) THEN
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
98 RT1 = HALF*( SM-RT )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
99 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
100 * Order of execution important.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
101 * To get fully accurate smaller eigenvalue,
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
102 * next line needs to be executed in higher precision.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
103 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
104 RT2 = ( ACMX / RT1 )*ACMN - ( B / RT1 )*B
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
105 ELSE IF( SM.GT.ZERO ) THEN
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
106 RT1 = HALF*( SM+RT )
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
107 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
108 * Order of execution important.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
109 * To get fully accurate smaller eigenvalue,
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
110 * next line needs to be executed in higher precision.
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
111 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
112 RT2 = ( ACMX / RT1 )*ACMN - ( B / RT1 )*B
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
113 ELSE
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
114 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
115 * Includes case RT1 = RT2 = 0
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
116 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
117 RT1 = HALF*RT
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
118 RT2 = -HALF*RT
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
119 END IF
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
120 RETURN
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
121 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
122 * End of DLAE2
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
123 *
ffa60dc8e49b [project @ 1997-03-14 04:30:59 by jwe]
jwe
parents:
diff changeset
124 END