lapack-netlib/SRC/zgesvxx.c

   1 #include <math.h>
   2 #include <stdlib.h>
   3 #include <string.h>
   4 #include <stdio.h>
   5 #include <complex.h>
   6 #ifdef complex
   7 #undef complex
   8 #endif
   9 #ifdef I
  10 #undef I
  11 #endif
  12
  13 #if defined(_WIN64)
  14 typedef long long BLASLONG;
  15 typedef unsigned long long BLASULONG;
  16 #else
  17 typedef long BLASLONG;
  18 typedef unsigned long BLASULONG;
  19 #endif
  20
  21 #ifdef LAPACK_ILP64
  22 typedef BLASLONG blasint;
  23 #if defined(_WIN64)
  24 #define blasabs(x) llabs(x)
  25 #else
  26 #define blasabs(x) labs(x)
  27 #endif
  28 #else
  29 typedef int blasint;
  30 #define blasabs(x) abs(x)
  31 #endif
  32
  33 typedef blasint integer;
  34
  35 typedef unsigned int uinteger;
  36 typedef char *address;
  37 typedef short int shortint;
  38 typedef float real;
  39 typedef double doublereal;
  40 typedef struct { real r, i; } complex;
  41 typedef struct { doublereal r, i; } doublecomplex;
  42 #ifdef _MSC_VER
  43 static inline _Fcomplex Cf(complex *z) {_Fcomplex zz={z->r , z->i}; return zz;}
  44 static inline _Dcomplex Cd(doublecomplex *z) {_Dcomplex zz={z->r , z->i};return zz;}
  45 static inline _Fcomplex * _pCf(complex *z) {return (_Fcomplex*)z;}
  46 static inline _Dcomplex * _pCd(doublecomplex *z) {return (_Dcomplex*)z;}
  47 #else
  48 static inline _Complex float Cf(complex *z) {return z->r + z->i*_Complex_I;}
  49 static inline _Complex double Cd(doublecomplex *z) {return z->r + z->i*_Complex_I;}
  50 static inline _Complex float * _pCf(complex *z) {return (_Complex float*)z;}
  51 static inline _Complex double * _pCd(doublecomplex *z) {return (_Complex double*)z;}
  52 #endif
  53 #define pCf(z) (*_pCf(z))
  54 #define pCd(z) (*_pCd(z))
  55 typedef int logical;
  56 typedef short int shortlogical;
  57 typedef char logical1;
  58 typedef char integer1;
  59
  60 #define TRUE_ (1)
  61 #define FALSE_ (0)
  62
  63 /* Extern is for use with -E */
  64 #ifndef Extern
  65 #define Extern extern
  66 #endif
  67
  68 /* I/O stuff */
  69
  70 typedef int flag;
  71 typedef int ftnlen;
  72 typedef int ftnint;
  73
  74 /*external read, write*/
  75 typedef struct
  76 {       flag cierr;
  77         ftnint ciunit;
  78         flag ciend;
  79         char *cifmt;
  80         ftnint cirec;
  81 } cilist;
  82
  83 /*internal read, write*/
  84 typedef struct
  85 {       flag icierr;
  86         char *iciunit;
  87         flag iciend;
  88         char *icifmt;
  89         ftnint icirlen;
  90         ftnint icirnum;
  91 } icilist;
  92
  93 /*open*/
  94 typedef struct
  95 {       flag oerr;
  96         ftnint ounit;
  97         char *ofnm;
  98         ftnlen ofnmlen;
  99         char *osta;
 100         char *oacc;
 101         char *ofm;
 102         ftnint orl;
 103         char *oblnk;
 104 } olist;
 105
 106 /*close*/
 107 typedef struct
 108 {       flag cerr;
 109         ftnint cunit;
 110         char *csta;
 111 } cllist;
 112
 113 /*rewind, backspace, endfile*/
 114 typedef struct
 115 {       flag aerr;
 116         ftnint aunit;
 117 } alist;
 118
 119 /* inquire */
 120 typedef struct
 121 {       flag inerr;
 122         ftnint inunit;
 123         char *infile;
 124         ftnlen infilen;
 125         ftnint  *inex;  /*parameters in standard's order*/
 126         ftnint  *inopen;
 127         ftnint  *innum;
 128         ftnint  *innamed;
 129         char    *inname;
 130         ftnlen  innamlen;
 131         char    *inacc;
 132         ftnlen  inacclen;
 133         char    *inseq;
 134         ftnlen  inseqlen;
 135         char    *indir;
 136         ftnlen  indirlen;
 137         char    *infmt;
 138         ftnlen  infmtlen;
 139         char    *inform;
 140         ftnint  informlen;
 141         char    *inunf;
 142         ftnlen  inunflen;
 143         ftnint  *inrecl;
 144         ftnint  *innrec;
 145         char    *inblank;
 146         ftnlen  inblanklen;
 147 } inlist;
 148
 149 #define VOID void
 150
 151 union Multitype {       /* for multiple entry points */
 152         integer1 g;
 153         shortint h;
 154         integer i;
 155         /* longint j; */
 156         real r;
 157         doublereal d;
 158         complex c;
 159         doublecomplex z;
 160         };
 161
 162 typedef union Multitype Multitype;
 163
 164 struct Vardesc {        /* for Namelist */
 165         char *name;
 166         char *addr;
 167         ftnlen *dims;
 168         int  type;
 169         };
 170 typedef struct Vardesc Vardesc;
 171
 172 struct Namelist {
 173         char *name;
 174         Vardesc **vars;
 175         int nvars;
 176         };
 177 typedef struct Namelist Namelist;
 178
 179 #define abs(x) ((x) >= 0 ? (x) : -(x))
 180 #define dabs(x) (fabs(x))
 181 #define f2cmin(a,b) ((a) <= (b) ? (a) : (b))
 182 #define f2cmax(a,b) ((a) >= (b) ? (a) : (b))
 183 #define dmin(a,b) (f2cmin(a,b))
 184 #define dmax(a,b) (f2cmax(a,b))
 185 #define bit_test(a,b)   ((a) >> (b) & 1)
 186 #define bit_clear(a,b)  ((a) & ~((uinteger)1 << (b)))
 187 #define bit_set(a,b)    ((a) |  ((uinteger)1 << (b)))
 188
 189 #define abort_() { sig_die("Fortran abort routine called", 1); }
 190 #define c_abs(z) (cabsf(Cf(z)))
 191 #define c_cos(R,Z) { pCf(R)=ccos(Cf(Z)); }
 192 #ifdef _MSC_VER
 193 #define c_div(c, a, b) {Cf(c)._Val[0] = (Cf(a)._Val[0]/Cf(b)._Val[0]); Cf(c)._Val[1]=(Cf(a)._Val[1]/Cf(b)._Val[1]);}
 194 #define z_div(c, a, b) {Cd(c)._Val[0] = (Cd(a)._Val[0]/Cd(b)._Val[0]); Cd(c)._Val[1]=(Cd(a)._Val[1]/df(b)._Val[1]);}
 195 #else
 196 #define c_div(c, a, b) {pCf(c) = Cf(a)/Cf(b);}
 197 #define z_div(c, a, b) {pCd(c) = Cd(a)/Cd(b);}
 198 #endif
 199 #define c_exp(R, Z) {pCf(R) = cexpf(Cf(Z));}
 200 #define c_log(R, Z) {pCf(R) = clogf(Cf(Z));}
 201 #define c_sin(R, Z) {pCf(R) = csinf(Cf(Z));}
 202 //#define c_sqrt(R, Z) {*(R) = csqrtf(Cf(Z));}
 203 #define c_sqrt(R, Z) {pCf(R) = csqrtf(Cf(Z));}
 204 #define d_abs(x) (fabs(*(x)))
 205 #define d_acos(x) (acos(*(x)))
 206 #define d_asin(x) (asin(*(x)))
 207 #define d_atan(x) (atan(*(x)))
 208 #define d_atn2(x, y) (atan2(*(x),*(y)))
 209 #define d_cnjg(R, Z) { pCd(R) = conj(Cd(Z)); }
 210 #define r_cnjg(R, Z) { pCf(R) = conjf(Cf(Z)); }
 211 #define d_cos(x) (cos(*(x)))
 212 #define d_cosh(x) (cosh(*(x)))
 213 #define d_dim(__a, __b) ( *(__a) > *(__b) ? *(__a) - *(__b) : 0.0 )
 214 #define d_exp(x) (exp(*(x)))
 215 #define d_imag(z) (cimag(Cd(z)))
 216 #define r_imag(z) (cimagf(Cf(z)))
 217 #define d_int(__x) (*(__x)>0 ? floor(*(__x)) : -floor(- *(__x)))
 218 #define r_int(__x) (*(__x)>0 ? floor(*(__x)) : -floor(- *(__x)))
 219 #define d_lg10(x) ( 0.43429448190325182765 * log(*(x)) )
 220 #define r_lg10(x) ( 0.43429448190325182765 * log(*(x)) )
 221 #define d_log(x) (log(*(x)))
 222 #define d_mod(x, y) (fmod(*(x), *(y)))
 223 #define u_nint(__x) ((__x)>=0 ? floor((__x) + .5) : -floor(.5 - (__x)))
 224 #define d_nint(x) u_nint(*(x))
 225 #define u_sign(__a,__b) ((__b) >= 0 ? ((__a) >= 0 ? (__a) : -(__a)) : -((__a) >= 0 ? (__a) : -(__a)))
 226 #define d_sign(a,b) u_sign(*(a),*(b))
 227 #define r_sign(a,b) u_sign(*(a),*(b))
 228 #define d_sin(x) (sin(*(x)))
 229 #define d_sinh(x) (sinh(*(x)))
 230 #define d_sqrt(x) (sqrt(*(x)))
 231 #define d_tan(x) (tan(*(x)))
 232 #define d_tanh(x) (tanh(*(x)))
 233 #define i_abs(x) abs(*(x))
 234 #define i_dnnt(x) ((integer)u_nint(*(x)))
 235 #define i_len(s, n) (n)
 236 #define i_nint(x) ((integer)u_nint(*(x)))
 237 #define i_sign(a,b) ((integer)u_sign((integer)*(a),(integer)*(b)))
 238 #define pow_dd(ap, bp) ( pow(*(ap), *(bp)))
 239 #define pow_si(B,E) spow_ui(*(B),*(E))
 240 #define pow_ri(B,E) spow_ui(*(B),*(E))
 241 #define pow_di(B,E) dpow_ui(*(B),*(E))
 242 #define pow_zi(p, a, b) {pCd(p) = zpow_ui(Cd(a), *(b));}
 243 #define pow_ci(p, a, b) {pCf(p) = cpow_ui(Cf(a), *(b));}
 244 #define pow_zz(R,A,B) {pCd(R) = cpow(Cd(A),*(B));}
 245 #define s_cat(lpp, rpp, rnp, np, llp) {         ftnlen i, nc, ll; char *f__rp, *lp;     ll = (llp); lp = (lpp);         for(i=0; i < (int)*(np); ++i) {                 nc = ll;                if((rnp)[i] < nc) nc = (rnp)[i];                ll -= nc;               f__rp = (rpp)[i];               while(--nc >= 0) *lp++ = *(f__rp)++;         }  while(--ll >= 0) *lp++ = ' '; }
 246 #define s_cmp(a,b,c,d) ((integer)strncmp((a),(b),f2cmin((c),(d))))
 247 #define s_copy(A,B,C,D) { int __i,__m; for (__i=0, __m=f2cmin((C),(D)); __i<__m && (B)[__i] != 0; ++__i) (A)[__i] = (B)[__i]; }
 248 #define sig_die(s, kill) { exit(1); }
 249 #define s_stop(s, n) {exit(0);}
 250 static char junk[] = "\n@(#)LIBF77 VERSION 19990503\n";
 251 #define z_abs(z) (cabs(Cd(z)))
 252 #define z_exp(R, Z) {pCd(R) = cexp(Cd(Z));}
 253 #define z_sqrt(R, Z) {pCd(R) = csqrt(Cd(Z));}
 254 #define myexit_() break;
 255 #define mycycle() continue;
 256 #define myceiling(w) {ceil(w)}
 257 #define myhuge(w) {HUGE_VAL}
 258 //#define mymaxloc_(w,s,e,n) {if (sizeof(*(w)) == sizeof(double)) dmaxloc_((w),*(s),*(e),n); else dmaxloc_((w),*(s),*(e),n);}
 259 #define mymaxloc(w,s,e,n) {dmaxloc_(w,*(s),*(e),n)}
 260
 261 /* procedure parameter types for -A and -C++ */
 262
 263 #define F2C_proc_par_types 1
 264 #ifdef __cplusplus
 265 typedef logical (*L_fp)(...);
 266 #else
 267 typedef logical (*L_fp)();
 268 #endif
 269
 270 static float spow_ui(float x, integer n) {
 271         float pow=1.0; unsigned long int u;
 272         if(n != 0) {
 273                 if(n < 0) n = -n, x = 1/x;
 274                 for(u = n; ; ) {
 275                         if(u & 01) pow *= x;
 276                         if(u >>= 1) x *= x;
 277                         else break;
 278                 }
 279         }
 280         return pow;
 281 }
 282 static double dpow_ui(double x, integer n) {
 283         double pow=1.0; unsigned long int u;
 284         if(n != 0) {
 285                 if(n < 0) n = -n, x = 1/x;
 286                 for(u = n; ; ) {
 287                         if(u & 01) pow *= x;
 288                         if(u >>= 1) x *= x;
 289                         else break;
 290                 }
 291         }
 292         return pow;
 293 }
 294 #ifdef _MSC_VER
 295 static _Fcomplex cpow_ui(complex x, integer n) {
 296         complex pow={1.0,0.0}; unsigned long int u;
 297                 if(n != 0) {
 298                 if(n < 0) n = -n, x.r = 1/x.r, x.i=1/x.i;
 299                 for(u = n; ; ) {
 300                         if(u & 01) pow.r *= x.r, pow.i *= x.i;
 301                         if(u >>= 1) x.r *= x.r, x.i *= x.i;
 302                         else break;
 303                 }
 304         }
 305         _Fcomplex p={pow.r, pow.i};
 306         return p;
 307 }
 308 #else
 309 static _Complex float cpow_ui(_Complex float x, integer n) {
 310         _Complex float pow=1.0; unsigned long int u;
 311         if(n != 0) {
 312                 if(n < 0) n = -n, x = 1/x;
 313                 for(u = n; ; ) {
 314                         if(u & 01) pow *= x;
 315                         if(u >>= 1) x *= x;
 316                         else break;
 317                 }
 318         }
 319         return pow;
 320 }
 321 #endif
 322 #ifdef _MSC_VER
 323 static _Dcomplex zpow_ui(_Dcomplex x, integer n) {
 324         _Dcomplex pow={1.0,0.0}; unsigned long int u;
 325         if(n != 0) {
 326                 if(n < 0) n = -n, x._Val[0] = 1/x._Val[0], x._Val[1] =1/x._Val[1];
 327                 for(u = n; ; ) {
 328                         if(u & 01) pow._Val[0] *= x._Val[0], pow._Val[1] *= x._Val[1];
 329                         if(u >>= 1) x._Val[0] *= x._Val[0], x._Val[1] *= x._Val[1];
 330                         else break;
 331                 }
 332         }
 333         _Dcomplex p = {pow._Val[0], pow._Val[1]};
 334         return p;
 335 }
 336 #else
 337 static _Complex double zpow_ui(_Complex double x, integer n) {
 338         _Complex double pow=1.0; unsigned long int u;
 339         if(n != 0) {
 340                 if(n < 0) n = -n, x = 1/x;
 341                 for(u = n; ; ) {
 342                         if(u & 01) pow *= x;
 343                         if(u >>= 1) x *= x;
 344                         else break;
 345                 }
 346         }
 347         return pow;
 348 }
 349 #endif
 350 static integer pow_ii(integer x, integer n) {
 351         integer pow; unsigned long int u;
 352         if (n <= 0) {
 353                 if (n == 0 || x == 1) pow = 1;
 354                 else if (x != -1) pow = x == 0 ? 1/x : 0;
 355                 else n = -n;
 356         }
 357         if ((n > 0) || !(n == 0 || x == 1 || x != -1)) {
 358                 u = n;
 359                 for(pow = 1; ; ) {
 360                         if(u & 01) pow *= x;
 361                         if(u >>= 1) x *= x;
 362                         else break;
 363                 }
 364         }
 365         return pow;
 366 }
 367 static integer dmaxloc_(double *w, integer s, integer e, integer *n)
 368 {
 369         double m; integer i, mi;
 370         for(m=w[s-1], mi=s, i=s+1; i<=e; i++)
 371                 if (w[i-1]>m) mi=i ,m=w[i-1];
 372         return mi-s+1;
 373 }
 374 static integer smaxloc_(float *w, integer s, integer e, integer *n)
 375 {
 376         float m; integer i, mi;
 377         for(m=w[s-1], mi=s, i=s+1; i<=e; i++)
 378                 if (w[i-1]>m) mi=i ,m=w[i-1];
 379         return mi-s+1;
 380 }
 381 static inline void cdotc_(complex *z, integer *n_, complex *x, integer *incx_, complex *y, integer *incy_) {
 382         integer n = *n_, incx = *incx_, incy = *incy_, i;
 383 #ifdef _MSC_VER
 384         _Fcomplex zdotc = {0.0, 0.0};
 385         if (incx == 1 && incy == 1) {
 386                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 387                         zdotc._Val[0] += conjf(Cf(&x[i]))._Val[0] * Cf(&y[i])._Val[0];
 388                         zdotc._Val[1] += conjf(Cf(&x[i]))._Val[1] * Cf(&y[i])._Val[1];
 389                 }
 390         } else {
 391                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 392                         zdotc._Val[0] += conjf(Cf(&x[i*incx]))._Val[0] * Cf(&y[i*incy])._Val[0];
 393                         zdotc._Val[1] += conjf(Cf(&x[i*incx]))._Val[1] * Cf(&y[i*incy])._Val[1];
 394                 }
 395         }
 396         pCf(z) = zdotc;
 397 }
 398 #else
 399         _Complex float zdotc = 0.0;
 400         if (incx == 1 && incy == 1) {
 401                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 402                         zdotc += conjf(Cf(&x[i])) * Cf(&y[i]);
 403                 }
 404         } else {
 405                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 406                         zdotc += conjf(Cf(&x[i*incx])) * Cf(&y[i*incy]);
 407                 }
 408         }
 409         pCf(z) = zdotc;
 410 }
 411 #endif
 412 static inline void zdotc_(doublecomplex *z, integer *n_, doublecomplex *x, integer *incx_, doublecomplex *y, integer *incy_) {
 413         integer n = *n_, incx = *incx_, incy = *incy_, i;
 414 #ifdef _MSC_VER
 415         _Dcomplex zdotc = {0.0, 0.0};
 416         if (incx == 1 && incy == 1) {
 417                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 418                         zdotc._Val[0] += conj(Cd(&x[i]))._Val[0] * Cd(&y[i])._Val[0];
 419                         zdotc._Val[1] += conj(Cd(&x[i]))._Val[1] * Cd(&y[i])._Val[1];
 420                 }
 421         } else {
 422                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 423                         zdotc._Val[0] += conj(Cd(&x[i*incx]))._Val[0] * Cd(&y[i*incy])._Val[0];
 424                         zdotc._Val[1] += conj(Cd(&x[i*incx]))._Val[1] * Cd(&y[i*incy])._Val[1];
 425                 }
 426         }
 427         pCd(z) = zdotc;
 428 }
 429 #else
 430         _Complex double zdotc = 0.0;
 431         if (incx == 1 && incy == 1) {
 432                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 433                         zdotc += conj(Cd(&x[i])) * Cd(&y[i]);
 434                 }
 435         } else {
 436                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 437                         zdotc += conj(Cd(&x[i*incx])) * Cd(&y[i*incy]);
 438                 }
 439         }
 440         pCd(z) = zdotc;
 441 }
 442 #endif
 443 static inline void cdotu_(complex *z, integer *n_, complex *x, integer *incx_, complex *y, integer *incy_) {
 444         integer n = *n_, incx = *incx_, incy = *incy_, i;
 445 #ifdef _MSC_VER
 446         _Fcomplex zdotc = {0.0, 0.0};
 447         if (incx == 1 && incy == 1) {
 448                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 449                         zdotc._Val[0] += Cf(&x[i])._Val[0] * Cf(&y[i])._Val[0];
 450                         zdotc._Val[1] += Cf(&x[i])._Val[1] * Cf(&y[i])._Val[1];
 451                 }
 452         } else {
 453                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 454                         zdotc._Val[0] += Cf(&x[i*incx])._Val[0] * Cf(&y[i*incy])._Val[0];
 455                         zdotc._Val[1] += Cf(&x[i*incx])._Val[1] * Cf(&y[i*incy])._Val[1];
 456                 }
 457         }
 458         pCf(z) = zdotc;
 459 }
 460 #else
 461         _Complex float zdotc = 0.0;
 462         if (incx == 1 && incy == 1) {
 463                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 464                         zdotc += Cf(&x[i]) * Cf(&y[i]);
 465                 }
 466         } else {
 467                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 468                         zdotc += Cf(&x[i*incx]) * Cf(&y[i*incy]);
 469                 }
 470         }
 471         pCf(z) = zdotc;
 472 }
 473 #endif
 474 static inline void zdotu_(doublecomplex *z, integer *n_, doublecomplex *x, integer *incx_, doublecomplex *y, integer *incy_) {
 475         integer n = *n_, incx = *incx_, incy = *incy_, i;
 476 #ifdef _MSC_VER
 477         _Dcomplex zdotc = {0.0, 0.0};
 478         if (incx == 1 && incy == 1) {
 479                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 480                         zdotc._Val[0] += Cd(&x[i])._Val[0] * Cd(&y[i])._Val[0];
 481                         zdotc._Val[1] += Cd(&x[i])._Val[1] * Cd(&y[i])._Val[1];
 482                 }
 483         } else {
 484                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 485                         zdotc._Val[0] += Cd(&x[i*incx])._Val[0] * Cd(&y[i*incy])._Val[0];
 486                         zdotc._Val[1] += Cd(&x[i*incx])._Val[1] * Cd(&y[i*incy])._Val[1];
 487                 }
 488         }
 489         pCd(z) = zdotc;
 490 }
 491 #else
 492         _Complex double zdotc = 0.0;
 493         if (incx == 1 && incy == 1) {
 494                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 495                         zdotc += Cd(&x[i]) * Cd(&y[i]);
 496                 }
 497         } else {
 498                 for (i=0;i<n;i++) { /* zdotc = zdotc + dconjg(x(i))* y(i) */
 499                         zdotc += Cd(&x[i*incx]) * Cd(&y[i*incy]);
 500                 }
 501         }
 502         pCd(z) = zdotc;
 503 }
 504 #endif
 505 /*  -- translated by f2c (version 20000121).
 506    You must link the resulting object file with the libraries:
 507         -lf2c -lm   (in that order)
 508 */
 509
 510
 511
 512
 513 /* > \brief <b> ZGESVXX computes the solution to system of linear equations A * X = B for GE matrices</b> */
 514
 515 /*  =========== DOCUMENTATION =========== */
 516
 517 /* Online html documentation available at */
 518 /*            http://www.netlib.org/lapack/explore-html/ */
 519
 520 /* > \htmlonly */
 521 /* > Download ZGESVXX + dependencies */
 522 /* > <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/zgesvxx
 523 .f"> */
 524 /* > [TGZ]</a> */
 525 /* > <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/zgesvxx
 526 .f"> */
 527 /* > [ZIP]</a> */
 528 /* > <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/zgesvxx
 529 .f"> */
 530 /* > [TXT]</a> */
 531 /* > \endhtmlonly */
 532
 533 /*  Definition: */
 534 /*  =========== */
 535
 536 /*       SUBROUTINE ZGESVXX( FACT, TRANS, N, NRHS, A, LDA, AF, LDAF, IPIV, */
 537 /*                           EQUED, R, C, B, LDB, X, LDX, RCOND, RPVGRW, */
 538 /*                           BERR, N_ERR_BNDS, ERR_BNDS_NORM, */
 539 /*                           ERR_BNDS_COMP, NPARAMS, PARAMS, WORK, RWORK, */
 540 /*                           INFO ) */
 541
 542 /*       CHARACTER          EQUED, FACT, TRANS */
 543 /*       INTEGER            INFO, LDA, LDAF, LDB, LDX, N, NRHS, NPARAMS, */
 544 /*      $                   N_ERR_BNDS */
 545 /*       DOUBLE PRECISION   RCOND, RPVGRW */
 546 /*       INTEGER            IPIV( * ) */
 547 /*       COMPLEX*16         A( LDA, * ), AF( LDAF, * ), B( LDB, * ), */
 548 /*      $                   X( LDX , * ),WORK( * ) */
 549 /*       DOUBLE PRECISION   R( * ), C( * ), PARAMS( * ), BERR( * ), */
 550 /*      $                   ERR_BNDS_NORM( NRHS, * ), */
 551 /*      $                   ERR_BNDS_COMP( NRHS, * ), RWORK( * ) */
 552
 553
 554 /* > \par Purpose: */
 555 /*  ============= */
 556 /* > */
 557 /* > \verbatim */
 558 /* > */
 559 /* >    ZGESVXX uses the LU factorization to compute the solution to a */
 560 /* >    complex*16 system of linear equations  A * X = B,  where A is an */
 561 /* >    N-by-N matrix and X and B are N-by-NRHS matrices. */
 562 /* > */
 563 /* >    If requested, both normwise and maximum componentwise error bounds */
 564 /* >    are returned. ZGESVXX will return a solution with a tiny */
 565 /* >    guaranteed error (O(eps) where eps is the working machine */
 566 /* >    precision) unless the matrix is very ill-conditioned, in which */
 567 /* >    case a warning is returned. Relevant condition numbers also are */
 568 /* >    calculated and returned. */
 569 /* > */
 570 /* >    ZGESVXX accepts user-provided factorizations and equilibration */
 571 /* >    factors; see the definitions of the FACT and EQUED options. */
 572 /* >    Solving with refinement and using a factorization from a previous */
 573 /* >    ZGESVXX call will also produce a solution with either O(eps) */
 574 /* >    errors or warnings, but we cannot make that claim for general */
 575 /* >    user-provided factorizations and equilibration factors if they */
 576 /* >    differ from what ZGESVXX would itself produce. */
 577 /* > \endverbatim */
 578
 579 /* > \par Description: */
 580 /*  ================= */
 581 /* > */
 582 /* > \verbatim */
 583 /* > */
 584 /* >    The following steps are performed: */
 585 /* > */
 586 /* >    1. If FACT = 'E', double precision scaling factors are computed to equilibrate */
 587 /* >    the system: */
 588 /* > */
 589 /* >      TRANS = 'N':  diag(R)*A*diag(C)     *inv(diag(C))*X = diag(R)*B */
 590 /* >      TRANS = 'T': (diag(R)*A*diag(C))**T *inv(diag(R))*X = diag(C)*B */
 591 /* >      TRANS = 'C': (diag(R)*A*diag(C))**H *inv(diag(R))*X = diag(C)*B */
 592 /* > */
 593 /* >    Whether or not the system will be equilibrated depends on the */
 594 /* >    scaling of the matrix A, but if equilibration is used, A is */
 595 /* >    overwritten by diag(R)*A*diag(C) and B by diag(R)*B (if TRANS='N') */
 596 /* >    or diag(C)*B (if TRANS = 'T' or 'C'). */
 597 /* > */
 598 /* >    2. If FACT = 'N' or 'E', the LU decomposition is used to factor */
 599 /* >    the matrix A (after equilibration if FACT = 'E') as */
 600 /* > */
 601 /* >      A = P * L * U, */
 602 /* > */
 603 /* >    where P is a permutation matrix, L is a unit lower triangular */
 604 /* >    matrix, and U is upper triangular. */
 605 /* > */
 606 /* >    3. If some U(i,i)=0, so that U is exactly singular, then the */
 607 /* >    routine returns with INFO = i. Otherwise, the factored form of A */
 608 /* >    is used to estimate the condition number of the matrix A (see */
 609 /* >    argument RCOND). If the reciprocal of the condition number is less */
 610 /* >    than machine precision, the routine still goes on to solve for X */
 611 /* >    and compute error bounds as described below. */
 612 /* > */
 613 /* >    4. The system of equations is solved for X using the factored form */
 614 /* >    of A. */
 615 /* > */
 616 /* >    5. By default (unless PARAMS(LA_LINRX_ITREF_I) is set to zero), */
 617 /* >    the routine will use iterative refinement to try to get a small */
 618 /* >    error and error bounds.  Refinement calculates the residual to at */
 619 /* >    least twice the working precision. */
 620 /* > */
 621 /* >    6. If equilibration was used, the matrix X is premultiplied by */
 622 /* >    diag(C) (if TRANS = 'N') or diag(R) (if TRANS = 'T' or 'C') so */
 623 /* >    that it solves the original system before equilibration. */
 624 /* > \endverbatim */
 625
 626 /*  Arguments: */
 627 /*  ========== */
 628
 629 /* > \verbatim */
 630 /* >     Some optional parameters are bundled in the PARAMS array.  These */
 631 /* >     settings determine how refinement is performed, but often the */
 632 /* >     defaults are acceptable.  If the defaults are acceptable, users */
 633 /* >     can pass NPARAMS = 0 which prevents the source code from accessing */
 634 /* >     the PARAMS argument. */
 635 /* > \endverbatim */
 636 /* > */
 637 /* > \param[in] FACT */
 638 /* > \verbatim */
 639 /* >          FACT is CHARACTER*1 */
 640 /* >     Specifies whether or not the factored form of the matrix A is */
 641 /* >     supplied on entry, and if not, whether the matrix A should be */
 642 /* >     equilibrated before it is factored. */
 643 /* >       = 'F':  On entry, AF and IPIV contain the factored form of A. */
 644 /* >               If EQUED is not 'N', the matrix A has been */
 645 /* >               equilibrated with scaling factors given by R and C. */
 646 /* >               A, AF, and IPIV are not modified. */
 647 /* >       = 'N':  The matrix A will be copied to AF and factored. */
 648 /* >       = 'E':  The matrix A will be equilibrated if necessary, then */
 649 /* >               copied to AF and factored. */
 650 /* > \endverbatim */
 651 /* > */
 652 /* > \param[in] TRANS */
 653 /* > \verbatim */
 654 /* >          TRANS is CHARACTER*1 */
 655 /* >     Specifies the form of the system of equations: */
 656 /* >       = 'N':  A * X = B     (No transpose) */
 657 /* >       = 'T':  A**T * X = B  (Transpose) */
 658 /* >       = 'C':  A**H * X = B  (Conjugate Transpose) */
 659 /* > \endverbatim */
 660 /* > */
 661 /* > \param[in] N */
 662 /* > \verbatim */
 663 /* >          N is INTEGER */
 664 /* >     The number of linear equations, i.e., the order of the */
 665 /* >     matrix A.  N >= 0. */
 666 /* > \endverbatim */
 667 /* > */
 668 /* > \param[in] NRHS */
 669 /* > \verbatim */
 670 /* >          NRHS is INTEGER */
 671 /* >     The number of right hand sides, i.e., the number of columns */
 672 /* >     of the matrices B and X.  NRHS >= 0. */
 673 /* > \endverbatim */
 674 /* > */
 675 /* > \param[in,out] A */
 676 /* > \verbatim */
 677 /* >          A is COMPLEX*16 array, dimension (LDA,N) */
 678 /* >     On entry, the N-by-N matrix A.  If FACT = 'F' and EQUED is */
 679 /* >     not 'N', then A must have been equilibrated by the scaling */
 680 /* >     factors in R and/or C.  A is not modified if FACT = 'F' or */
 681 /* >     'N', or if FACT = 'E' and EQUED = 'N' on exit. */
 682 /* > */
 683 /* >     On exit, if EQUED .ne. 'N', A is scaled as follows: */
 684 /* >     EQUED = 'R':  A := diag(R) * A */
 685 /* >     EQUED = 'C':  A := A * diag(C) */
 686 /* >     EQUED = 'B':  A := diag(R) * A * diag(C). */
 687 /* > \endverbatim */
 688 /* > */
 689 /* > \param[in] LDA */
 690 /* > \verbatim */
 691 /* >          LDA is INTEGER */
 692 /* >     The leading dimension of the array A.  LDA >= f2cmax(1,N). */
 693 /* > \endverbatim */
 694 /* > */
 695 /* > \param[in,out] AF */
 696 /* > \verbatim */
 697 /* >          AF is COMPLEX*16 array, dimension (LDAF,N) */
 698 /* >     If FACT = 'F', then AF is an input argument and on entry */
 699 /* >     contains the factors L and U from the factorization */
 700 /* >     A = P*L*U as computed by ZGETRF.  If EQUED .ne. 'N', then */
 701 /* >     AF is the factored form of the equilibrated matrix A. */
 702 /* > */
 703 /* >     If FACT = 'N', then AF is an output argument and on exit */
 704 /* >     returns the factors L and U from the factorization A = P*L*U */
 705 /* >     of the original matrix A. */
 706 /* > */
 707 /* >     If FACT = 'E', then AF is an output argument and on exit */
 708 /* >     returns the factors L and U from the factorization A = P*L*U */
 709 /* >     of the equilibrated matrix A (see the description of A for */
 710 /* >     the form of the equilibrated matrix). */
 711 /* > \endverbatim */
 712 /* > */
 713 /* > \param[in] LDAF */
 714 /* > \verbatim */
 715 /* >          LDAF is INTEGER */
 716 /* >     The leading dimension of the array AF.  LDAF >= f2cmax(1,N). */
 717 /* > \endverbatim */
 718 /* > */
 719 /* > \param[in,out] IPIV */
 720 /* > \verbatim */
 721 /* >          IPIV is INTEGER array, dimension (N) */
 722 /* >     If FACT = 'F', then IPIV is an input argument and on entry */
 723 /* >     contains the pivot indices from the factorization A = P*L*U */
 724 /* >     as computed by ZGETRF; row i of the matrix was interchanged */
 725 /* >     with row IPIV(i). */
 726 /* > */
 727 /* >     If FACT = 'N', then IPIV is an output argument and on exit */
 728 /* >     contains the pivot indices from the factorization A = P*L*U */
 729 /* >     of the original matrix A. */
 730 /* > */
 731 /* >     If FACT = 'E', then IPIV is an output argument and on exit */
 732 /* >     contains the pivot indices from the factorization A = P*L*U */
 733 /* >     of the equilibrated matrix A. */
 734 /* > \endverbatim */
 735 /* > */
 736 /* > \param[in,out] EQUED */
 737 /* > \verbatim */
 738 /* >          EQUED is CHARACTER*1 */
 739 /* >     Specifies the form of equilibration that was done. */
 740 /* >       = 'N':  No equilibration (always true if FACT = 'N'). */
 741 /* >       = 'R':  Row equilibration, i.e., A has been premultiplied by */
 742 /* >               diag(R). */
 743 /* >       = 'C':  Column equilibration, i.e., A has been postmultiplied */
 744 /* >               by diag(C). */
 745 /* >       = 'B':  Both row and column equilibration, i.e., A has been */
 746 /* >               replaced by diag(R) * A * diag(C). */
 747 /* >     EQUED is an input argument if FACT = 'F'; otherwise, it is an */
 748 /* >     output argument. */
 749 /* > \endverbatim */
 750 /* > */
 751 /* > \param[in,out] R */
 752 /* > \verbatim */
 753 /* >          R is DOUBLE PRECISION array, dimension (N) */
 754 /* >     The row scale factors for A.  If EQUED = 'R' or 'B', A is */
 755 /* >     multiplied on the left by diag(R); if EQUED = 'N' or 'C', R */
 756 /* >     is not accessed.  R is an input argument if FACT = 'F'; */
 757 /* >     otherwise, R is an output argument.  If FACT = 'F' and */
 758 /* >     EQUED = 'R' or 'B', each element of R must be positive. */
 759 /* >     If R is output, each element of R is a power of the radix. */
 760 /* >     If R is input, each element of R should be a power of the radix */
 761 /* >     to ensure a reliable solution and error estimates. Scaling by */
 762 /* >     powers of the radix does not cause rounding errors unless the */
 763 /* >     result underflows or overflows. Rounding errors during scaling */
 764 /* >     lead to refining with a matrix that is not equivalent to the */
 765 /* >     input matrix, producing error estimates that may not be */
 766 /* >     reliable. */
 767 /* > \endverbatim */
 768 /* > */
 769 /* > \param[in,out] C */
 770 /* > \verbatim */
 771 /* >          C is DOUBLE PRECISION array, dimension (N) */
 772 /* >     The column scale factors for A.  If EQUED = 'C' or 'B', A is */
 773 /* >     multiplied on the right by diag(C); if EQUED = 'N' or 'R', C */
 774 /* >     is not accessed.  C is an input argument if FACT = 'F'; */
 775 /* >     otherwise, C is an output argument.  If FACT = 'F' and */
 776 /* >     EQUED = 'C' or 'B', each element of C must be positive. */
 777 /* >     If C is output, each element of C is a power of the radix. */
 778 /* >     If C is input, each element of C should be a power of the radix */
 779 /* >     to ensure a reliable solution and error estimates. Scaling by */
 780 /* >     powers of the radix does not cause rounding errors unless the */
 781 /* >     result underflows or overflows. Rounding errors during scaling */
 782 /* >     lead to refining with a matrix that is not equivalent to the */
 783 /* >     input matrix, producing error estimates that may not be */
 784 /* >     reliable. */
 785 /* > \endverbatim */
 786 /* > */
 787 /* > \param[in,out] B */
 788 /* > \verbatim */
 789 /* >          B is COMPLEX*16 array, dimension (LDB,NRHS) */
 790 /* >     On entry, the N-by-NRHS right hand side matrix B. */
 791 /* >     On exit, */
 792 /* >     if EQUED = 'N', B is not modified; */
 793 /* >     if TRANS = 'N' and EQUED = 'R' or 'B', B is overwritten by */
 794 /* >        diag(R)*B; */
 795 /* >     if TRANS = 'T' or 'C' and EQUED = 'C' or 'B', B is */
 796 /* >        overwritten by diag(C)*B. */
 797 /* > \endverbatim */
 798 /* > */
 799 /* > \param[in] LDB */
 800 /* > \verbatim */
 801 /* >          LDB is INTEGER */
 802 /* >     The leading dimension of the array B.  LDB >= f2cmax(1,N). */
 803 /* > \endverbatim */
 804 /* > */
 805 /* > \param[out] X */
 806 /* > \verbatim */
 807 /* >          X is COMPLEX*16 array, dimension (LDX,NRHS) */
 808 /* >     If INFO = 0, the N-by-NRHS solution matrix X to the original */
 809 /* >     system of equations.  Note that A and B are modified on exit */
 810 /* >     if EQUED .ne. 'N', and the solution to the equilibrated system is */
 811 /* >     inv(diag(C))*X if TRANS = 'N' and EQUED = 'C' or 'B', or */
 812 /* >     inv(diag(R))*X if TRANS = 'T' or 'C' and EQUED = 'R' or 'B'. */
 813 /* > \endverbatim */
 814 /* > */
 815 /* > \param[in] LDX */
 816 /* > \verbatim */
 817 /* >          LDX is INTEGER */
 818 /* >     The leading dimension of the array X.  LDX >= f2cmax(1,N). */
 819 /* > \endverbatim */
 820 /* > */
 821 /* > \param[out] RCOND */
 822 /* > \verbatim */
 823 /* >          RCOND is DOUBLE PRECISION */
 824 /* >     Reciprocal scaled condition number.  This is an estimate of the */
 825 /* >     reciprocal Skeel condition number of the matrix A after */
 826 /* >     equilibration (if done).  If this is less than the machine */
 827 /* >     precision (in particular, if it is zero), the matrix is singular */
 828 /* >     to working precision.  Note that the error may still be small even */
 829 /* >     if this number is very small and the matrix appears ill- */
 830 /* >     conditioned. */
 831 /* > \endverbatim */
 832 /* > */
 833 /* > \param[out] RPVGRW */
 834 /* > \verbatim */
 835 /* >          RPVGRW is DOUBLE PRECISION */
 836 /* >     Reciprocal pivot growth.  On exit, this contains the reciprocal */
 837 /* >     pivot growth factor norm(A)/norm(U). The "f2cmax absolute element" */
 838 /* >     norm is used.  If this is much less than 1, then the stability of */
 839 /* >     the LU factorization of the (equilibrated) matrix A could be poor. */
 840 /* >     This also means that the solution X, estimated condition numbers, */
 841 /* >     and error bounds could be unreliable. If factorization fails with */
 842 /* >     0<INFO<=N, then this contains the reciprocal pivot growth factor */
 843 /* >     for the leading INFO columns of A.  In ZGESVX, this quantity is */
 844 /* >     returned in WORK(1). */
 845 /* > \endverbatim */
 846 /* > */
 847 /* > \param[out] BERR */
 848 /* > \verbatim */
 849 /* >          BERR is DOUBLE PRECISION array, dimension (NRHS) */
 850 /* >     Componentwise relative backward error.  This is the */
 851 /* >     componentwise relative backward error of each solution vector X(j) */
 852 /* >     (i.e., the smallest relative change in any element of A or B that */
 853 /* >     makes X(j) an exact solution). */
 854 /* > \endverbatim */
 855 /* > */
 856 /* > \param[in] N_ERR_BNDS */
 857 /* > \verbatim */
 858 /* >          N_ERR_BNDS is INTEGER */
 859 /* >     Number of error bounds to return for each right hand side */
 860 /* >     and each type (normwise or componentwise).  See ERR_BNDS_NORM and */
 861 /* >     ERR_BNDS_COMP below. */
 862 /* > \endverbatim */
 863 /* > */
 864 /* > \param[out] ERR_BNDS_NORM */
 865 /* > \verbatim */
 866 /* >          ERR_BNDS_NORM is DOUBLE PRECISION array, dimension (NRHS, N_ERR_BNDS) */
 867 /* >     For each right-hand side, this array contains information about */
 868 /* >     various error bounds and condition numbers corresponding to the */
 869 /* >     normwise relative error, which is defined as follows: */
 870 /* > */
 871 /* >     Normwise relative error in the ith solution vector: */
 872 /* >             max_j (abs(XTRUE(j,i) - X(j,i))) */
 873 /* >            ------------------------------ */
 874 /* >                  max_j abs(X(j,i)) */
 875 /* > */
 876 /* >     The array is indexed by the type of error information as described */
 877 /* >     below. There currently are up to three pieces of information */
 878 /* >     returned. */
 879 /* > */
 880 /* >     The first index in ERR_BNDS_NORM(i,:) corresponds to the ith */
 881 /* >     right-hand side. */
 882 /* > */
 883 /* >     The second index in ERR_BNDS_NORM(:,err) contains the following */
 884 /* >     three fields: */
 885 /* >     err = 1 "Trust/don't trust" boolean. Trust the answer if the */
 886 /* >              reciprocal condition number is less than the threshold */
 887 /* >              sqrt(n) * dlamch('Epsilon'). */
 888 /* > */
 889 /* >     err = 2 "Guaranteed" error bound: The estimated forward error, */
 890 /* >              almost certainly within a factor of 10 of the true error */
 891 /* >              so long as the next entry is greater than the threshold */
 892 /* >              sqrt(n) * dlamch('Epsilon'). This error bound should only */
 893 /* >              be trusted if the previous boolean is true. */
 894 /* > */
 895 /* >     err = 3  Reciprocal condition number: Estimated normwise */
 896 /* >              reciprocal condition number.  Compared with the threshold */
 897 /* >              sqrt(n) * dlamch('Epsilon') to determine if the error */
 898 /* >              estimate is "guaranteed". These reciprocal condition */
 899 /* >              numbers are 1 / (norm(Z^{-1},inf) * norm(Z,inf)) for some */
 900 /* >              appropriately scaled matrix Z. */
 901 /* >              Let Z = S*A, where S scales each row by a power of the */
 902 /* >              radix so all absolute row sums of Z are approximately 1. */
 903 /* > */
 904 /* >     See Lapack Working Note 165 for further details and extra */
 905 /* >     cautions. */
 906 /* > \endverbatim */
 907 /* > */
 908 /* > \param[out] ERR_BNDS_COMP */
 909 /* > \verbatim */
 910 /* >          ERR_BNDS_COMP is DOUBLE PRECISION array, dimension (NRHS, N_ERR_BNDS) */
 911 /* >     For each right-hand side, this array contains information about */
 912 /* >     various error bounds and condition numbers corresponding to the */
 913 /* >     componentwise relative error, which is defined as follows: */
 914 /* > */
 915 /* >     Componentwise relative error in the ith solution vector: */
 916 /* >                    abs(XTRUE(j,i) - X(j,i)) */
 917 /* >             max_j ---------------------- */
 918 /* >                         abs(X(j,i)) */
 919 /* > */
 920 /* >     The array is indexed by the right-hand side i (on which the */
 921 /* >     componentwise relative error depends), and the type of error */
 922 /* >     information as described below. There currently are up to three */
 923 /* >     pieces of information returned for each right-hand side. If */
 924 /* >     componentwise accuracy is not requested (PARAMS(3) = 0.0), then */
 925 /* >     ERR_BNDS_COMP is not accessed.  If N_ERR_BNDS < 3, then at most */
 926 /* >     the first (:,N_ERR_BNDS) entries are returned. */
 927 /* > */
 928 /* >     The first index in ERR_BNDS_COMP(i,:) corresponds to the ith */
 929 /* >     right-hand side. */
 930 /* > */
 931 /* >     The second index in ERR_BNDS_COMP(:,err) contains the following */
 932 /* >     three fields: */
 933 /* >     err = 1 "Trust/don't trust" boolean. Trust the answer if the */
 934 /* >              reciprocal condition number is less than the threshold */
 935 /* >              sqrt(n) * dlamch('Epsilon'). */
 936 /* > */
 937 /* >     err = 2 "Guaranteed" error bound: The estimated forward error, */
 938 /* >              almost certainly within a factor of 10 of the true error */
 939 /* >              so long as the next entry is greater than the threshold */
 940 /* >              sqrt(n) * dlamch('Epsilon'). This error bound should only */
 941 /* >              be trusted if the previous boolean is true. */
 942 /* > */
 943 /* >     err = 3  Reciprocal condition number: Estimated componentwise */
 944 /* >              reciprocal condition number.  Compared with the threshold */
 945 /* >              sqrt(n) * dlamch('Epsilon') to determine if the error */
 946 /* >              estimate is "guaranteed". These reciprocal condition */
 947 /* >              numbers are 1 / (norm(Z^{-1},inf) * norm(Z,inf)) for some */
 948 /* >              appropriately scaled matrix Z. */
 949 /* >              Let Z = S*(A*diag(x)), where x is the solution for the */
 950 /* >              current right-hand side and S scales each row of */
 951 /* >              A*diag(x) by a power of the radix so all absolute row */
 952 /* >              sums of Z are approximately 1. */
 953 /* > */
 954 /* >     See Lapack Working Note 165 for further details and extra */
 955 /* >     cautions. */
 956 /* > \endverbatim */
 957 /* > */
 958 /* > \param[in] NPARAMS */
 959 /* > \verbatim */
 960 /* >          NPARAMS is INTEGER */
 961 /* >     Specifies the number of parameters set in PARAMS.  If <= 0, the */
 962 /* >     PARAMS array is never referenced and default values are used. */
 963 /* > \endverbatim */
 964 /* > */
 965 /* > \param[in,out] PARAMS */
 966 /* > \verbatim */
 967 /* >          PARAMS is DOUBLE PRECISION array, dimension NPARAMS */
 968 /* >     Specifies algorithm parameters.  If an entry is < 0.0, then */
 969 /* >     that entry will be filled with default value used for that */
 970 /* >     parameter.  Only positions up to NPARAMS are accessed; defaults */
 971 /* >     are used for higher-numbered parameters. */
 972 /* > */
 973 /* >       PARAMS(LA_LINRX_ITREF_I = 1) : Whether to perform iterative */
 974 /* >            refinement or not. */
 975 /* >         Default: 1.0D+0 */
 976 /* >            = 0.0:  No refinement is performed, and no error bounds are */
 977 /* >                    computed. */
 978 /* >            = 1.0:  Use the extra-precise refinement algorithm. */
 979 /* >              (other values are reserved for future use) */
 980 /* > */
 981 /* >       PARAMS(LA_LINRX_ITHRESH_I = 2) : Maximum number of residual */
 982 /* >            computations allowed for refinement. */
 983 /* >         Default: 10 */
 984 /* >         Aggressive: Set to 100 to permit convergence using approximate */
 985 /* >                     factorizations or factorizations other than LU. If */
 986 /* >                     the factorization uses a technique other than */
 987 /* >                     Gaussian elimination, the guarantees in */
 988 /* >                     err_bnds_norm and err_bnds_comp may no longer be */
 989 /* >                     trustworthy. */
 990 /* > */
 991 /* >       PARAMS(LA_LINRX_CWISE_I = 3) : Flag determining if the code */
 992 /* >            will attempt to find a solution with small componentwise */
 993 /* >            relative error in the double-precision algorithm.  Positive */
 994 /* >            is true, 0.0 is false. */
 995 /* >         Default: 1.0 (attempt componentwise convergence) */
 996 /* > \endverbatim */
 997 /* > */
 998 /* > \param[out] WORK */
 999 /* > \verbatim */
1000 /* >          WORK is COMPLEX*16 array, dimension (2*N) */
1001 /* > \endverbatim */
1002 /* > */
1003 /* > \param[out] RWORK */
1004 /* > \verbatim */
1005 /* >          RWORK is DOUBLE PRECISION array, dimension (2*N) */
1006 /* > \endverbatim */
1007 /* > */
1008 /* > \param[out] INFO */
1009 /* > \verbatim */
1010 /* >          INFO is INTEGER */
1011 /* >       = 0:  Successful exit. The solution to every right-hand side is */
1012 /* >         guaranteed. */
1013 /* >       < 0:  If INFO = -i, the i-th argument had an illegal value */
1014 /* >       > 0 and <= N:  U(INFO,INFO) is exactly zero.  The factorization */
1015 /* >         has been completed, but the factor U is exactly singular, so */
1016 /* >         the solution and error bounds could not be computed. RCOND = 0 */
1017 /* >         is returned. */
1018 /* >       = N+J: The solution corresponding to the Jth right-hand side is */
1019 /* >         not guaranteed. The solutions corresponding to other right- */
1020 /* >         hand sides K with K > J may not be guaranteed as well, but */
1021 /* >         only the first such right-hand side is reported. If a small */
1022 /* >         componentwise error is not requested (PARAMS(3) = 0.0) then */
1023 /* >         the Jth right-hand side is the first with a normwise error */
1024 /* >         bound that is not guaranteed (the smallest J such */
1025 /* >         that ERR_BNDS_NORM(J,1) = 0.0). By default (PARAMS(3) = 1.0) */
1026 /* >         the Jth right-hand side is the first with either a normwise or */
1027 /* >         componentwise error bound that is not guaranteed (the smallest */
1028 /* >         J such that either ERR_BNDS_NORM(J,1) = 0.0 or */
1029 /* >         ERR_BNDS_COMP(J,1) = 0.0). See the definition of */
1030 /* >         ERR_BNDS_NORM(:,1) and ERR_BNDS_COMP(:,1). To get information */
1031 /* >         about all of the right-hand sides check ERR_BNDS_NORM or */
1032 /* >         ERR_BNDS_COMP. */
1033 /* > \endverbatim */
1034
1035 /*  Authors: */
1036 /*  ======== */
1037
1038 /* > \author Univ. of Tennessee */
1039 /* > \author Univ. of California Berkeley */
1040 /* > \author Univ. of Colorado Denver */
1041 /* > \author NAG Ltd. */
1042
1043 /* > \date April 2012 */
1044
1045 /* > \ingroup complex16GEsolve */
1046
1047 /*  ===================================================================== */
1048 /* Subroutine */ int zgesvxx_(char *fact, char *trans, integer *n, integer *
1049         nrhs, doublecomplex *a, integer *lda, doublecomplex *af, integer *
1050         ldaf, integer *ipiv, char *equed, doublereal *r__, doublereal *c__,
1051         doublecomplex *b, integer *ldb, doublecomplex *x, integer *ldx,
1052         doublereal *rcond, doublereal *rpvgrw, doublereal *berr, integer *
1053         n_err_bnds__, doublereal *err_bnds_norm__, doublereal *
1054         err_bnds_comp__, integer *nparams, doublereal *params, doublecomplex *
1055         work, doublereal *rwork, integer *info)
1056 {
1057     /* System generated locals */
1058     integer a_dim1, a_offset, af_dim1, af_offset, b_dim1, b_offset, x_dim1,
1059             x_offset, err_bnds_norm_dim1, err_bnds_norm_offset,
1060             err_bnds_comp_dim1, err_bnds_comp_offset, i__1;
1061     doublereal d__1, d__2;
1062
1063     /* Local variables */
1064     doublereal amax;
1065     extern doublereal zla_gerpvgrw_(integer *, integer *, doublecomplex *,
1066             integer *, doublecomplex *, integer *);
1067     integer j;
1068     extern logical lsame_(char *, char *);
1069     doublereal rcmin, rcmax;
1070     logical equil;
1071     extern doublereal dlamch_(char *);
1072     doublereal colcnd;
1073     logical nofact;
1074     extern /* Subroutine */ int xerbla_(char *, integer *, ftnlen);
1075     doublereal bignum;
1076     extern /* Subroutine */ int zlaqge_(integer *, integer *, doublecomplex *,
1077              integer *, doublereal *, doublereal *, doublereal *, doublereal *
1078             , doublereal *, char *);
1079     integer infequ;
1080     logical colequ;
1081     doublereal rowcnd;
1082     logical notran;
1083     extern /* Subroutine */ int zgetrf_(integer *, integer *, doublecomplex *,
1084              integer *, integer *, integer *), zlacpy_(char *, integer *,
1085             integer *, doublecomplex *, integer *, doublecomplex *, integer *);
1086     doublereal smlnum;
1087     extern /* Subroutine */ int zgetrs_(char *, integer *, integer *,
1088             doublecomplex *, integer *, integer *, doublecomplex *, integer *,
1089              integer *);
1090     logical rowequ;
1091     extern /* Subroutine */ int zlascl2_(integer *, integer *, doublereal *,
1092             doublecomplex *, integer *), zgeequb_(integer *, integer *,
1093             doublecomplex *, integer *, doublereal *, doublereal *,
1094             doublereal *, doublereal *, doublereal *, integer *), zgerfsx_(
1095             char *, char *, integer *, integer *, doublecomplex *, integer *,
1096             doublecomplex *, integer *, integer *, doublereal *, doublereal *,
1097              doublecomplex *, integer *, doublecomplex *, integer *,
1098             doublereal *, doublereal *, integer *, doublereal *, doublereal *,
1099              integer *, doublereal *, doublecomplex *, doublereal *, integer *
1100             );
1101
1102
1103 /*  -- LAPACK driver routine (version 3.7.0) -- */
1104 /*  -- LAPACK is a software package provided by Univ. of Tennessee,    -- */
1105 /*  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- */
1106 /*     April 2012 */
1107
1108
1109 /*  ================================================================== */
1110
1111
1112     /* Parameter adjustments */
1113     err_bnds_comp_dim1 = *nrhs;
1114     err_bnds_comp_offset = 1 + err_bnds_comp_dim1 * 1;
1115     err_bnds_comp__ -= err_bnds_comp_offset;
1116     err_bnds_norm_dim1 = *nrhs;
1117     err_bnds_norm_offset = 1 + err_bnds_norm_dim1 * 1;
1118     err_bnds_norm__ -= err_bnds_norm_offset;
1119     a_dim1 = *lda;
1120     a_offset = 1 + a_dim1 * 1;
1121     a -= a_offset;
1122     af_dim1 = *ldaf;
1123     af_offset = 1 + af_dim1 * 1;
1124     af -= af_offset;
1125     --ipiv;
1126     --r__;
1127     --c__;
1128     b_dim1 = *ldb;
1129     b_offset = 1 + b_dim1 * 1;
1130     b -= b_offset;
1131     x_dim1 = *ldx;
1132     x_offset = 1 + x_dim1 * 1;
1133     x -= x_offset;
1134     --berr;
1135     --params;
1136     --work;
1137     --rwork;
1138
1139     /* Function Body */
1140     *info = 0;
1141     nofact = lsame_(fact, "N");
1142     equil = lsame_(fact, "E");
1143     notran = lsame_(trans, "N");
1144     smlnum = dlamch_("Safe minimum");
1145     bignum = 1. / smlnum;
1146     if (nofact || equil) {
1147         *(unsigned char *)equed = 'N';
1148         rowequ = FALSE_;
1149         colequ = FALSE_;
1150     } else {
1151         rowequ = lsame_(equed, "R") || lsame_(equed,
1152                 "B");
1153         colequ = lsame_(equed, "C") || lsame_(equed,
1154                 "B");
1155     }
1156
1157 /*     Default is failure.  If an input parameter is wrong or */
1158 /*     factorization fails, make everything look horrible.  Only the */
1159 /*     pivot growth is set here, the rest is initialized in ZGERFSX. */
1160
1161     *rpvgrw = 0.;
1162
1163 /*     Test the input parameters.  PARAMS is not tested until ZGERFSX. */
1164
1165     if (! nofact && ! equil && ! lsame_(fact, "F")) {
1166         *info = -1;
1167     } else if (! notran && ! lsame_(trans, "T") && !
1168             lsame_(trans, "C")) {
1169         *info = -2;
1170     } else if (*n < 0) {
1171         *info = -3;
1172     } else if (*nrhs < 0) {
1173         *info = -4;
1174     } else if (*lda < f2cmax(1,*n)) {
1175         *info = -6;
1176     } else if (*ldaf < f2cmax(1,*n)) {
1177         *info = -8;
1178     } else if (lsame_(fact, "F") && ! (rowequ || colequ
1179             || lsame_(equed, "N"))) {
1180         *info = -10;
1181     } else {
1182         if (rowequ) {
1183             rcmin = bignum;
1184             rcmax = 0.;
1185             i__1 = *n;
1186             for (j = 1; j <= i__1; ++j) {
1187 /* Computing MIN */
1188                 d__1 = rcmin, d__2 = r__[j];
1189                 rcmin = f2cmin(d__1,d__2);
1190 /* Computing MAX */
1191                 d__1 = rcmax, d__2 = r__[j];
1192                 rcmax = f2cmax(d__1,d__2);
1193 /* L10: */
1194             }
1195             if (rcmin <= 0.) {
1196                 *info = -11;
1197             } else if (*n > 0) {
1198                 rowcnd = f2cmax(rcmin,smlnum) / f2cmin(rcmax,bignum);
1199             } else {
1200                 rowcnd = 1.;
1201             }
1202         }
1203         if (colequ && *info == 0) {
1204             rcmin = bignum;
1205             rcmax = 0.;
1206             i__1 = *n;
1207             for (j = 1; j <= i__1; ++j) {
1208 /* Computing MIN */
1209                 d__1 = rcmin, d__2 = c__[j];
1210                 rcmin = f2cmin(d__1,d__2);
1211 /* Computing MAX */
1212                 d__1 = rcmax, d__2 = c__[j];
1213                 rcmax = f2cmax(d__1,d__2);
1214 /* L20: */
1215             }
1216             if (rcmin <= 0.) {
1217                 *info = -12;
1218             } else if (*n > 0) {
1219                 colcnd = f2cmax(rcmin,smlnum) / f2cmin(rcmax,bignum);
1220             } else {
1221                 colcnd = 1.;
1222             }
1223         }
1224         if (*info == 0) {
1225             if (*ldb < f2cmax(1,*n)) {
1226                 *info = -14;
1227             } else if (*ldx < f2cmax(1,*n)) {
1228                 *info = -16;
1229             }
1230         }
1231     }
1232
1233     if (*info != 0) {
1234         i__1 = -(*info);
1235         xerbla_("ZGESVXX", &i__1, (ftnlen)7);
1236         return 0;
1237     }
1238
1239     if (equil) {
1240
1241 /*     Compute row and column scalings to equilibrate the matrix A. */
1242
1243         zgeequb_(n, n, &a[a_offset], lda, &r__[1], &c__[1], &rowcnd, &colcnd,
1244                 &amax, &infequ);
1245         if (infequ == 0) {
1246
1247 /*     Equilibrate the matrix. */
1248
1249             zlaqge_(n, n, &a[a_offset], lda, &r__[1], &c__[1], &rowcnd, &
1250                     colcnd, &amax, equed);
1251             rowequ = lsame_(equed, "R") || lsame_(equed,
1252                      "B");
1253             colequ = lsame_(equed, "C") || lsame_(equed,
1254                      "B");
1255         }
1256
1257 /*     If the scaling factors are not applied, set them to 1.0. */
1258
1259         if (! rowequ) {
1260             i__1 = *n;
1261             for (j = 1; j <= i__1; ++j) {
1262                 r__[j] = 1.;
1263             }
1264         }
1265         if (! colequ) {
1266             i__1 = *n;
1267             for (j = 1; j <= i__1; ++j) {
1268                 c__[j] = 1.;
1269             }
1270         }
1271     }
1272
1273 /*     Scale the right-hand side. */
1274
1275     if (notran) {
1276         if (rowequ) {
1277             zlascl2_(n, nrhs, &r__[1], &b[b_offset], ldb);
1278         }
1279     } else {
1280         if (colequ) {
1281             zlascl2_(n, nrhs, &c__[1], &b[b_offset], ldb);
1282         }
1283     }
1284
1285     if (nofact || equil) {
1286
1287 /*        Compute the LU factorization of A. */
1288
1289         zlacpy_("Full", n, n, &a[a_offset], lda, &af[af_offset], ldaf);
1290         zgetrf_(n, n, &af[af_offset], ldaf, &ipiv[1], info);
1291
1292 /*        Return if INFO is non-zero. */
1293
1294         if (*info > 0) {
1295
1296 /*           Pivot in column INFO is exactly 0 */
1297 /*           Compute the reciprocal pivot growth factor of the */
1298 /*           leading rank-deficient INFO columns of A. */
1299
1300             *rpvgrw = zla_gerpvgrw_(n, info, &a[a_offset], lda, &af[
1301                     af_offset], ldaf);
1302             return 0;
1303         }
1304     }
1305
1306 /*     Compute the reciprocal pivot growth factor RPVGRW. */
1307
1308     *rpvgrw = zla_gerpvgrw_(n, n, &a[a_offset], lda, &af[af_offset], ldaf);
1309
1310 /*     Compute the solution matrix X. */
1311
1312     zlacpy_("Full", n, nrhs, &b[b_offset], ldb, &x[x_offset], ldx);
1313     zgetrs_(trans, n, nrhs, &af[af_offset], ldaf, &ipiv[1], &x[x_offset], ldx,
1314              info);
1315
1316 /*     Use iterative refinement to improve the computed solution and */
1317 /*     compute error bounds and backward error estimates for it. */
1318
1319     zgerfsx_(trans, equed, n, nrhs, &a[a_offset], lda, &af[af_offset], ldaf, &
1320             ipiv[1], &r__[1], &c__[1], &b[b_offset], ldb, &x[x_offset], ldx,
1321             rcond, &berr[1], n_err_bnds__, &err_bnds_norm__[
1322             err_bnds_norm_offset], &err_bnds_comp__[err_bnds_comp_offset],
1323             nparams, &params[1], &work[1], &rwork[1], info);
1324
1325 /*     Scale solutions. */
1326
1327     if (colequ && notran) {
1328         zlascl2_(n, nrhs, &c__[1], &x[x_offset], ldx);
1329     } else if (rowequ && ! notran) {
1330         zlascl2_(n, nrhs, &r__[1], &x[x_offset], ldx);
1331     }
1332
1333     return 0;
1334
1335 /*     End of ZGESVXX */
1336
1337 } /* zgesvxx_ */
1338