annotate libcruft/lapack/dpotf2.f @ 8203:a9da991c77aa

update contrib.txi
author John W. Eaton <jwe@octave.org>
date Wed, 08 Oct 2008 14:29:51 -0400
parents 68db500cb558
children
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 *
7034
68db500cb558 [project @ 2007-10-16 18:54:19 by jwe]
jwe
parents: 3333
diff changeset
3 * -- LAPACK routine (version 3.1) --
68db500cb558 [project @ 2007-10-16 18:54:19 by jwe]
jwe
parents: 3333
diff changeset
4 * Univ. of Tennessee, Univ. of California Berkeley and NAG Ltd..
68db500cb558 [project @ 2007-10-16 18:54:19 by jwe]
jwe
parents: 3333
diff changeset
5 * November 2006
3271
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
6 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
7 * .. Scalar Arguments ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
8 CHARACTER UPLO
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
9 INTEGER INFO, LDA, N
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
10 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
11 * .. Array Arguments ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
12 DOUBLE PRECISION A( LDA, * )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
13 * ..
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 * Purpose
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
16 * =======
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 * DPOTF2 computes the Cholesky factorization of a real symmetric
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
19 * positive definite matrix A.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
20 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
21 * The factorization has the form
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
22 * A = U' * U , if UPLO = 'U', or
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
23 * A = L * L', if UPLO = 'L',
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
24 * 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
25 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
26 * 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
27 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
28 * Arguments
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
29 * =========
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 * UPLO (input) CHARACTER*1
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
32 * Specifies whether the upper or lower triangular part of the
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
33 * symmetric matrix A is stored.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
34 * = 'U': Upper triangular
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
35 * = 'L': Lower triangular
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
36 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
37 * N (input) INTEGER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
38 * The order of the matrix A. N >= 0.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
39 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
40 * A (input/output) DOUBLE PRECISION array, dimension (LDA,N)
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
41 * 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
42 * 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
43 * triangular part of the matrix A, and the strictly lower
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
44 * 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
45 * 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
46 * triangular part of the matrix A, and the strictly upper
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
47 * triangular part of A is not referenced.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
48 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
49 * 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
50 * factorization A = U'*U or A = L*L'.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
51 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
52 * LDA (input) INTEGER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
53 * 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
54 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
55 * INFO (output) INTEGER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
56 * = 0: successful exit
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
57 * < 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
58 * > 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
59 * positive definite, and the factorization could not be
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
60 * completed.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
61 *
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 * .. Parameters ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
65 DOUBLE PRECISION ONE, ZERO
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
66 PARAMETER ( ONE = 1.0D+0, ZERO = 0.0D+0 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
67 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
68 * .. Local Scalars ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
69 LOGICAL UPPER
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
70 INTEGER J
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
71 DOUBLE PRECISION AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
72 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
73 * .. External Functions ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
74 LOGICAL LSAME
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
75 DOUBLE PRECISION DDOT
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
76 EXTERNAL LSAME, DDOT
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
77 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
78 * .. External Subroutines ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
79 EXTERNAL DGEMV, DSCAL, XERBLA
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
80 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
81 * .. Intrinsic Functions ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
82 INTRINSIC MAX, SQRT
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
83 * ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
84 * .. Executable Statements ..
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
85 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
86 * Test the input parameters.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
87 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
88 INFO = 0
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
89 UPPER = LSAME( UPLO, 'U' )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
90 IF( .NOT.UPPER .AND. .NOT.LSAME( UPLO, 'L' ) ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
91 INFO = -1
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
92 ELSE IF( N.LT.0 ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
93 INFO = -2
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
94 ELSE IF( LDA.LT.MAX( 1, N ) ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
95 INFO = -4
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
96 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
97 IF( INFO.NE.0 ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
98 CALL XERBLA( 'DPOTF2', -INFO )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
99 RETURN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
100 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
101 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
102 * Quick return if possible
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
103 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
104 IF( N.EQ.0 )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
105 $ RETURN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
106 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
107 IF( UPPER ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
108 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
109 * Compute the Cholesky factorization A = U'*U.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
110 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
111 DO 10 J = 1, N
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
112 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
113 * Compute U(J,J) and test for non-positive-definiteness.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
114 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
115 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
116 IF( AJJ.LE.ZERO ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
117 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
118 GO TO 30
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
119 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
120 AJJ = SQRT( AJJ )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
121 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
122 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
123 * Compute elements J+1:N of row J.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
124 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
125 IF( J.LT.N ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
126 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
127 $ 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
128 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
129 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
130 10 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
131 ELSE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
132 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
133 * Compute the Cholesky factorization A = L*L'.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
134 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
135 DO 20 J = 1, N
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
136 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
137 * Compute L(J,J) and test for non-positive-definiteness.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
138 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
139 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
140 $ LDA )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
141 IF( AJJ.LE.ZERO ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
142 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
143 GO TO 30
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
144 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
145 AJJ = SQRT( AJJ )
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
146 A( J, J ) = AJJ
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
147 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
148 * Compute elements J+1:N of column J.
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
149 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
150 IF( J.LT.N ) THEN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
151 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
152 $ 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
153 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
154 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
155 20 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
156 END IF
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
157 GO TO 40
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
158 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
159 30 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
160 INFO = J
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
161 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
162 40 CONTINUE
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
163 RETURN
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
164 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
165 * End of DPOTF2
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
166 *
d7af069013cf [project @ 1999-10-01 21:39:49 by jwe]
jwe
parents:
diff changeset
167 END