annotate main/sparse/SuperLU/SRC/zgscon.c @ 0:6b33357c7561 octave-forge

Initial revision
author pkienzle
date Wed, 10 Oct 2001 19:54:49 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
1
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
2
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
3 /*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
4 * -- SuperLU routine (version 2.0) --
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
5 * Univ. of California Berkeley, Xerox Palo Alto Research Center,
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
6 * and Lawrence Berkeley National Lab.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
7 * November 15, 1997
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
8 *
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
9 */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
10 /*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
11 * File name: zgscon.c
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
12 * History: Modified from lapack routines ZGECON.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
13 */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
14 #include <math.h>
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
15 #include "util.h"
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
16 #include "zsp_defs.h"
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
17
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
18 void
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
19 zgscon(char *norm, SuperMatrix *L, SuperMatrix *U,
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
20 double anorm, double *rcond, int *info)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
21 {
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
22 /*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
23 Purpose
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
24 =======
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
25
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
26 ZGSCON estimates the reciprocal of the condition number of a general
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
27 real matrix A, in either the 1-norm or the infinity-norm, using
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
28 the LU factorization computed by ZGETRF.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
29
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
30 An estimate is obtained for norm(inv(A)), and the reciprocal of the
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
31 condition number is computed as
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
32 RCOND = 1 / ( norm(A) * norm(inv(A)) ).
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
33
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
34 See supermatrix.h for the definition of 'SuperMatrix' structure.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
35
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
36 Arguments
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
37 =========
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
38
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
39 NORM (input) char*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
40 Specifies whether the 1-norm condition number or the
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
41 infinity-norm condition number is required:
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
42 = '1' or 'O': 1-norm;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
43 = 'I': Infinity-norm.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
44
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
45 L (input) SuperMatrix*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
46 The factor L from the factorization Pr*A*Pc=L*U as computed by
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
47 zgstrf(). Use compressed row subscripts storage for supernodes,
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
48 i.e., L has types: Stype = SC, Dtype = _Z, Mtype = TRLU.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
49
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
50 U (input) SuperMatrix*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
51 The factor U from the factorization Pr*A*Pc=L*U as computed by
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
52 zgstrf(). Use column-wise storage scheme, i.e., U has types:
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
53 Stype = NC, Dtype = _Z, Mtype = TRU.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
54
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
55 ANORM (input) double
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
56 If NORM = '1' or 'O', the 1-norm of the original matrix A.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
57 If NORM = 'I', the infinity-norm of the original matrix A.
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
58
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
59 RCOND (output) double*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
60 The reciprocal of the condition number of the matrix A,
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
61 computed as RCOND = 1/(norm(A) * norm(inv(A))).
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
62
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
63 INFO (output) int*
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
64 = 0: successful exit
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
65 < 0: if INFO = -i, the i-th argument had an illegal value
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
66
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
67 =====================================================================
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
68 */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
69
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
70 /* Local variables */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
71 int kase, kase1, onenrm, i;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
72 double ainvnm;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
73 doublecomplex *work;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
74 extern int zrscl_(int *, doublecomplex *, doublecomplex *, int *);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
75
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
76 extern int zlacon_(int *, doublecomplex *, doublecomplex *, double *, int *);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
77
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
78
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
79 /* Test the input parameters. */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
80 *info = 0;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
81 onenrm = *(unsigned char *)norm == '1' || lsame_(norm, "O");
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
82 if (! onenrm && ! lsame_(norm, "I")) *info = -1;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
83 else if (L->nrow < 0 || L->nrow != L->ncol ||
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
84 L->Stype != SC || L->Dtype != _Z || L->Mtype != TRLU)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
85 *info = -2;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
86 else if (U->nrow < 0 || U->nrow != U->ncol ||
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
87 U->Stype != NC || U->Dtype != _Z || U->Mtype != TRU)
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
88 *info = -3;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
89 if (*info != 0) {
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
90 i = -(*info);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
91 xerbla_("zgscon", &i);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
92 return;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
93 }
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
94
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
95 /* Quick return if possible */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
96 *rcond = 0.;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
97 if ( L->nrow == 0 || U->nrow == 0) {
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
98 *rcond = 1.;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
99 return;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
100 }
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
101
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
102 work = doublecomplexCalloc( 3*L->nrow );
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
103
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
104
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
105 if ( !work )
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
106 ABORT("Malloc fails for work arrays in zgscon.");
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
107
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
108 /* Estimate the norm of inv(A). */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
109 ainvnm = 0.;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
110 if ( onenrm ) kase1 = 1;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
111 else kase1 = 2;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
112 kase = 0;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
113
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
114 do {
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
115 zlacon_(&L->nrow, &work[L->nrow], &work[0], &ainvnm, &kase);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
116
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
117 if (kase == 0) break;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
118
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
119 if (kase == kase1) {
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
120 /* Multiply by inv(L). */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
121 sp_ztrsv("Lower", "No transpose", "Unit", L, U, &work[0], info);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
122
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
123 /* Multiply by inv(U). */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
124 sp_ztrsv("Upper", "No transpose", "Non-unit", L, U, &work[0],info);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
125
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
126 } else {
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
127
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
128 /* Multiply by inv(U'). */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
129 sp_ztrsv("Upper", "Transpose", "Non-unit", L, U, &work[0], info);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
130
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
131 /* Multiply by inv(L'). */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
132 sp_ztrsv("Lower", "Transpose", "Unit", L, U, &work[0], info);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
133
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
134 }
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
135
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
136 } while ( kase != 0 );
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
137
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
138 /* Compute the estimate of the reciprocal condition number. */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
139 if (ainvnm != 0.) *rcond = (1. / ainvnm) / anorm;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
140
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
141 SUPERLU_FREE (work);
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
142 return;
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
143
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
144 } /* zgscon */
6b33357c7561 Initial revision
pkienzle
parents:
diff changeset
145