annotate libcruft/lapack/dpotf2.f @ 5018:1c65a8e44ef9 ss-2-1-59

[project @ 2004-09-22 03:33:29 by jwe]
author jwe
date Wed, 22 Sep 2004 03:33:29 +0000
parents 15cddaacbc2d
children 68db500cb558
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3271
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
1 SUBROUTINE DPOTF2( UPLO, N, A, LDA, INFO )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
2 *
3333
15cddaacbc2d [project @ 1999-11-03 19:53:59 by jwe]
jwe
parents: 3271
diff changeset
3 * -- LAPACK routine (version 3.0) --
3271
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
4 * Univ. of Tennessee, Univ. of California Berkeley, NAG Ltd.,
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
5 * Courant Institute, Argonne National Lab, and Rice University
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
6 * February 29, 1992
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
7 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
8 * .. Scalar Arguments ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
9 CHARACTER UPLO
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
10 INTEGER INFO, LDA, N
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
11 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
12 * .. Array Arguments ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
13 DOUBLE PRECISION A( LDA, * )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
14 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
15 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
16 * Purpose
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
17 * =======
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
18 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
19 * DPOTF2 computes the Cholesky factorization of a real symmetric
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
20 * positive definite matrix A.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
21 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
22 * The factorization has the form
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
23 * A = U' * U , if UPLO = 'U', or
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
24 * A = L * L', if UPLO = 'L',
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
25 * where U is an upper triangular matrix and L is lower triangular.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
26 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
27 * This is the unblocked version of the algorithm, calling Level 2 BLAS.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
28 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
29 * Arguments
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
30 * =========
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
31 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
32 * UPLO (input) CHARACTER*1
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
33 * Specifies whether the upper or lower triangular part of the
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
34 * symmetric matrix A is stored.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
35 * = 'U': Upper triangular
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
36 * = 'L': Lower triangular
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
37 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
38 * N (input) INTEGER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
39 * The order of the matrix A. N >= 0.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
40 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
41 * A (input/output) DOUBLE PRECISION array, dimension (LDA,N)
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
42 * On entry, the symmetric matrix A. If UPLO = 'U', the leading
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
43 * n by n upper triangular part of A contains the upper
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
44 * triangular part of the matrix A, and the strictly lower
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
45 * triangular part of A is not referenced. If UPLO = 'L', the
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
46 * leading n by n lower triangular part of A contains the lower
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
47 * triangular part of the matrix A, and the strictly upper
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
48 * triangular part of A is not referenced.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
49 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
50 * On exit, if INFO = 0, the factor U or L from the Cholesky
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
51 * factorization A = U'*U or A = L*L'.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
52 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
53 * LDA (input) INTEGER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
54 * The leading dimension of the array A. LDA >= max(1,N).
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
55 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
56 * INFO (output) INTEGER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
57 * = 0: successful exit
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
58 * < 0: if INFO = -k, the k-th argument had an illegal value
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
59 * > 0: if INFO = k, the leading minor of order k is not
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
60 * positive definite, and the factorization could not be
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
61 * completed.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
62 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
63 * =====================================================================
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
64 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
65 * .. Parameters ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
66 DOUBLE PRECISION ONE, ZERO
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
67 PARAMETER ( ONE = 1.0D+0, ZERO = 0.0D+0 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
68 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
69 * .. Local Scalars ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
70 LOGICAL UPPER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
71 INTEGER J
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
72 DOUBLE PRECISION AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
73 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
74 * .. External Functions ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
75 LOGICAL LSAME
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
76 DOUBLE PRECISION DDOT
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
77 EXTERNAL LSAME, DDOT
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
78 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
79 * .. External Subroutines ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
80 EXTERNAL DGEMV, DSCAL, XERBLA
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
81 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
82 * .. Intrinsic Functions ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
83 INTRINSIC MAX, SQRT
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
84 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
85 * .. Executable Statements ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
86 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
87 * Test the input parameters.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
88 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
89 INFO = 0
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
90 UPPER = LSAME( UPLO, 'U' )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
91 IF( .NOT.UPPER .AND. .NOT.LSAME( UPLO, 'L' ) ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
92 INFO = -1
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
93 ELSE IF( N.LT.0 ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
94 INFO = -2
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
95 ELSE IF( LDA.LT.MAX( 1, N ) ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
96 INFO = -4
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
97 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
98 IF( INFO.NE.0 ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
99 CALL XERBLA( 'DPOTF2', -INFO )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
100 RETURN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
101 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
102 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
103 * Quick return if possible
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
104 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
105 IF( N.EQ.0 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
106 $ RETURN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
107 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
108 IF( UPPER ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
109 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
110 * Compute the Cholesky factorization A = U'*U.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
111 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
112 DO 10 J = 1, N
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
113 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
114 * Compute U(J,J) and test for non-positive-definiteness.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
115 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
116 AJJ = A( J, J ) - DDOT( J-1, A( 1, J ), 1, A( 1, J ), 1 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
117 IF( AJJ.LE.ZERO ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
118 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
119 GO TO 30
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
120 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
121 AJJ = SQRT( AJJ )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
122 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
123 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
124 * Compute elements J+1:N of row J.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
125 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
126 IF( J.LT.N ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
127 CALL DGEMV( 'Transpose', J-1, N-J, -ONE, A( 1, J+1 ),
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
128 $ LDA, A( 1, J ), 1, ONE, A( J, J+1 ), LDA )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
129 CALL DSCAL( N-J, ONE / AJJ, A( J, J+1 ), LDA )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
130 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
131 10 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
132 ELSE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
133 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
134 * Compute the Cholesky factorization A = L*L'.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
135 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
136 DO 20 J = 1, N
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
137 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
138 * Compute L(J,J) and test for non-positive-definiteness.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
139 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
140 AJJ = A( J, J ) - DDOT( J-1, A( J, 1 ), LDA, A( J, 1 ),
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
141 $ LDA )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
142 IF( AJJ.LE.ZERO ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
143 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
144 GO TO 30
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
145 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
146 AJJ = SQRT( AJJ )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
147 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
148 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
149 * Compute elements J+1:N of column J.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
150 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
151 IF( J.LT.N ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
152 CALL DGEMV( 'No transpose', N-J, J-1, -ONE, A( J+1, 1 ),
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
153 $ LDA, A( J, 1 ), LDA, ONE, A( J+1, J ), 1 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
154 CALL DSCAL( N-J, ONE / AJJ, A( J+1, J ), 1 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
155 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
156 20 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
157 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
158 GO TO 40
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
159 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
160 30 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
161 INFO = J
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
162 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
163 40 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
164 RETURN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
165 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
166 * End of DPOTF2
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
167 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
168 END