lapack-netlib/SRC/csysvxx.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> CSYSVXX computes the solution to system of linear equations A * X = B for SY 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 CSYSVXX + dependencies */
 522 /* > <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/csysvxx
 523 .f"> */
 524 /* > [TGZ]</a> */
 525 /* > <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/csysvxx
 526 .f"> */
 527 /* > [ZIP]</a> */
 528 /* > <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/csysvxx
 529 .f"> */
 530 /* > [TXT]</a> */
 531 /* > \endhtmlonly */
 532
 533 /*  Definition: */
 534 /*  =========== */
 535
 536 /*       SUBROUTINE CSYSVXX( FACT, UPLO, N, NRHS, A, LDA, AF, LDAF, IPIV, */
 537 /*                           EQUED, S, B, LDB, X, LDX, RCOND, RPVGRW, BERR, */
 538 /*                           N_ERR_BNDS, ERR_BNDS_NORM, ERR_BNDS_COMP, */
 539 /*                           NPARAMS, PARAMS, WORK, RWORK, INFO ) */
 540
 541 /*       CHARACTER          EQUED, FACT, UPLO */
 542 /*       INTEGER            INFO, LDA, LDAF, LDB, LDX, N, NRHS, NPARAMS, */
 543 /*      $                   N_ERR_BNDS */
 544 /*       REAL               RCOND, RPVGRW */
 545 /*       INTEGER            IPIV( * ) */
 546 /*       COMPLEX            A( LDA, * ), AF( LDAF, * ), B( LDB, * ), */
 547 /*      $                   X( LDX, * ), WORK( * ) */
 548 /*       REAL               S( * ), PARAMS( * ), BERR( * ), */
 549 /*      $                   ERR_BNDS_NORM( NRHS, * ), */
 550 /*      $                   ERR_BNDS_COMP( NRHS, * ), RWORK( * ) */
 551
 552
 553 /* > \par Purpose: */
 554 /*  ============= */
 555 /* > */
 556 /* > \verbatim */
 557 /* > */
 558 /* >    CSYSVXX uses the diagonal pivoting factorization to compute the */
 559 /* >    solution to a complex system of linear equations A * X = B, where */
 560 /* >    A is an N-by-N symmetric matrix and X and B are N-by-NRHS */
 561 /* >    matrices. */
 562 /* > */
 563 /* >    If requested, both normwise and maximum componentwise error bounds */
 564 /* >    are returned. CSYSVXX 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 /* >    CSYSVXX 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 /* >    CSYSVXX 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 CSYSVXX 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', real scaling factors are computed to equilibrate */
 587 /* >    the system: */
 588 /* > */
 589 /* >      diag(S)*A*diag(S)     *inv(diag(S))*X = diag(S)*B */
 590 /* > */
 591 /* >    Whether or not the system will be equilibrated depends on the */
 592 /* >    scaling of the matrix A, but if equilibration is used, A is */
 593 /* >    overwritten by diag(S)*A*diag(S) and B by diag(S)*B. */
 594 /* > */
 595 /* >    2. If FACT = 'N' or 'E', the LU decomposition is used to factor */
 596 /* >    the matrix A (after equilibration if FACT = 'E') as */
 597 /* > */
 598 /* >       A = U * D * U**T,  if UPLO = 'U', or */
 599 /* >       A = L * D * L**T,  if UPLO = 'L', */
 600 /* > */
 601 /* >    where U (or L) is a product of permutation and unit upper (lower) */
 602 /* >    triangular matrices, and D is symmetric and block diagonal with */
 603 /* >    1-by-1 and 2-by-2 diagonal blocks. */
 604 /* > */
 605 /* >    3. If some D(i,i)=0, so that D is exactly singular, then the */
 606 /* >    routine returns with INFO = i. Otherwise, the factored form of A */
 607 /* >    is used to estimate the condition number of the matrix A (see */
 608 /* >    argument RCOND).  If the reciprocal of the condition number is */
 609 /* >    less than machine precision, the routine still goes on to solve */
 610 /* >    for X and compute error bounds as described below. */
 611 /* > */
 612 /* >    4. The system of equations is solved for X using the factored form */
 613 /* >    of A. */
 614 /* > */
 615 /* >    5. By default (unless PARAMS(LA_LINRX_ITREF_I) is set to zero), */
 616 /* >    the routine will use iterative refinement to try to get a small */
 617 /* >    error and error bounds.  Refinement calculates the residual to at */
 618 /* >    least twice the working precision. */
 619 /* > */
 620 /* >    6. If equilibration was used, the matrix X is premultiplied by */
 621 /* >    diag(R) so that it solves the original system before */
 622 /* >    equilibration. */
 623 /* > \endverbatim */
 624
 625 /*  Arguments: */
 626 /*  ========== */
 627
 628 /* > \verbatim */
 629 /* >     Some optional parameters are bundled in the PARAMS array.  These */
 630 /* >     settings determine how refinement is performed, but often the */
 631 /* >     defaults are acceptable.  If the defaults are acceptable, users */
 632 /* >     can pass NPARAMS = 0 which prevents the source code from accessing */
 633 /* >     the PARAMS argument. */
 634 /* > \endverbatim */
 635 /* > */
 636 /* > \param[in] FACT */
 637 /* > \verbatim */
 638 /* >          FACT is CHARACTER*1 */
 639 /* >     Specifies whether or not the factored form of the matrix A is */
 640 /* >     supplied on entry, and if not, whether the matrix A should be */
 641 /* >     equilibrated before it is factored. */
 642 /* >       = 'F':  On entry, AF and IPIV contain the factored form of A. */
 643 /* >               If EQUED is not 'N', the matrix A has been */
 644 /* >               equilibrated with scaling factors given by S. */
 645 /* >               A, AF, and IPIV are not modified. */
 646 /* >       = 'N':  The matrix A will be copied to AF and factored. */
 647 /* >       = 'E':  The matrix A will be equilibrated if necessary, then */
 648 /* >               copied to AF and factored. */
 649 /* > \endverbatim */
 650 /* > */
 651 /* > \param[in] UPLO */
 652 /* > \verbatim */
 653 /* >          UPLO is CHARACTER*1 */
 654 /* >       = 'U':  Upper triangle of A is stored; */
 655 /* >       = 'L':  Lower triangle of A is stored. */
 656 /* > \endverbatim */
 657 /* > */
 658 /* > \param[in] N */
 659 /* > \verbatim */
 660 /* >          N is INTEGER */
 661 /* >     The number of linear equations, i.e., the order of the */
 662 /* >     matrix A.  N >= 0. */
 663 /* > \endverbatim */
 664 /* > */
 665 /* > \param[in] NRHS */
 666 /* > \verbatim */
 667 /* >          NRHS is INTEGER */
 668 /* >     The number of right hand sides, i.e., the number of columns */
 669 /* >     of the matrices B and X.  NRHS >= 0. */
 670 /* > \endverbatim */
 671 /* > */
 672 /* > \param[in,out] A */
 673 /* > \verbatim */
 674 /* >          A is COMPLEX array, dimension (LDA,N) */
 675 /* >     The symmetric matrix A.  If UPLO = 'U', the leading N-by-N */
 676 /* >     upper triangular part of A contains the upper triangular */
 677 /* >     part of the matrix A, and the strictly lower triangular */
 678 /* >     part of A is not referenced.  If UPLO = 'L', the leading */
 679 /* >     N-by-N lower triangular part of A contains the lower */
 680 /* >     triangular part of the matrix A, and the strictly upper */
 681 /* >     triangular part of A is not referenced. */
 682 /* > */
 683 /* >     On exit, if FACT = 'E' and EQUED = 'Y', A is overwritten by */
 684 /* >     diag(S)*A*diag(S). */
 685 /* > \endverbatim */
 686 /* > */
 687 /* > \param[in] LDA */
 688 /* > \verbatim */
 689 /* >          LDA is INTEGER */
 690 /* >     The leading dimension of the array A.  LDA >= f2cmax(1,N). */
 691 /* > \endverbatim */
 692 /* > */
 693 /* > \param[in,out] AF */
 694 /* > \verbatim */
 695 /* >          AF is COMPLEX array, dimension (LDAF,N) */
 696 /* >     If FACT = 'F', then AF is an input argument and on entry */
 697 /* >     contains the block diagonal matrix D and the multipliers */
 698 /* >     used to obtain the factor U or L from the factorization A = */
 699 /* >     U*D*U**T or A = L*D*L**T as computed by SSYTRF. */
 700 /* > */
 701 /* >     If FACT = 'N', then AF is an output argument and on exit */
 702 /* >     returns the block diagonal matrix D and the multipliers */
 703 /* >     used to obtain the factor U or L from the factorization A = */
 704 /* >     U*D*U**T or A = L*D*L**T. */
 705 /* > \endverbatim */
 706 /* > */
 707 /* > \param[in] LDAF */
 708 /* > \verbatim */
 709 /* >          LDAF is INTEGER */
 710 /* >     The leading dimension of the array AF.  LDAF >= f2cmax(1,N). */
 711 /* > \endverbatim */
 712 /* > */
 713 /* > \param[in,out] IPIV */
 714 /* > \verbatim */
 715 /* >          IPIV is INTEGER array, dimension (N) */
 716 /* >     If FACT = 'F', then IPIV is an input argument and on entry */
 717 /* >     contains details of the interchanges and the block */
 718 /* >     structure of D, as determined by SSYTRF.  If IPIV(k) > 0, */
 719 /* >     then rows and columns k and IPIV(k) were interchanged and */
 720 /* >     D(k,k) is a 1-by-1 diagonal block.  If UPLO = 'U' and */
 721 /* >     IPIV(k) = IPIV(k-1) < 0, then rows and columns k-1 and */
 722 /* >     -IPIV(k) were interchanged and D(k-1:k,k-1:k) is a 2-by-2 */
 723 /* >     diagonal block.  If UPLO = 'L' and IPIV(k) = IPIV(k+1) < 0, */
 724 /* >     then rows and columns k+1 and -IPIV(k) were interchanged */
 725 /* >     and D(k:k+1,k:k+1) is a 2-by-2 diagonal block. */
 726 /* > */
 727 /* >     If FACT = 'N', then IPIV is an output argument and on exit */
 728 /* >     contains details of the interchanges and the block */
 729 /* >     structure of D, as determined by SSYTRF. */
 730 /* > \endverbatim */
 731 /* > */
 732 /* > \param[in,out] EQUED */
 733 /* > \verbatim */
 734 /* >          EQUED is CHARACTER*1 */
 735 /* >     Specifies the form of equilibration that was done. */
 736 /* >       = 'N':  No equilibration (always true if FACT = 'N'). */
 737 /* >       = 'Y':  Both row and column equilibration, i.e., A has been */
 738 /* >               replaced by diag(S) * A * diag(S). */
 739 /* >     EQUED is an input argument if FACT = 'F'; otherwise, it is an */
 740 /* >     output argument. */
 741 /* > \endverbatim */
 742 /* > */
 743 /* > \param[in,out] S */
 744 /* > \verbatim */
 745 /* >          S is REAL array, dimension (N) */
 746 /* >     The scale factors for A.  If EQUED = 'Y', A is multiplied on */
 747 /* >     the left and right by diag(S).  S is an input argument if FACT = */
 748 /* >     'F'; otherwise, S is an output argument.  If FACT = 'F' and EQUED */
 749 /* >     = 'Y', each element of S must be positive.  If S is output, each */
 750 /* >     element of S is a power of the radix. If S is input, each element */
 751 /* >     of S should be a power of the radix to ensure a reliable solution */
 752 /* >     and error estimates. Scaling by powers of the radix does not cause */
 753 /* >     rounding errors unless the result underflows or overflows. */
 754 /* >     Rounding errors during scaling lead to refining with a matrix that */
 755 /* >     is not equivalent to the input matrix, producing error estimates */
 756 /* >     that may not be reliable. */
 757 /* > \endverbatim */
 758 /* > */
 759 /* > \param[in,out] B */
 760 /* > \verbatim */
 761 /* >          B is COMPLEX array, dimension (LDB,NRHS) */
 762 /* >     On entry, the N-by-NRHS right hand side matrix B. */
 763 /* >     On exit, */
 764 /* >     if EQUED = 'N', B is not modified; */
 765 /* >     if EQUED = 'Y', B is overwritten by diag(S)*B; */
 766 /* > \endverbatim */
 767 /* > */
 768 /* > \param[in] LDB */
 769 /* > \verbatim */
 770 /* >          LDB is INTEGER */
 771 /* >     The leading dimension of the array B.  LDB >= f2cmax(1,N). */
 772 /* > \endverbatim */
 773 /* > */
 774 /* > \param[out] X */
 775 /* > \verbatim */
 776 /* >          X is COMPLEX array, dimension (LDX,NRHS) */
 777 /* >     If INFO = 0, the N-by-NRHS solution matrix X to the original */
 778 /* >     system of equations.  Note that A and B are modified on exit if */
 779 /* >     EQUED .ne. 'N', and the solution to the equilibrated system is */
 780 /* >     inv(diag(S))*X. */
 781 /* > \endverbatim */
 782 /* > */
 783 /* > \param[in] LDX */
 784 /* > \verbatim */
 785 /* >          LDX is INTEGER */
 786 /* >     The leading dimension of the array X.  LDX >= f2cmax(1,N). */
 787 /* > \endverbatim */
 788 /* > */
 789 /* > \param[out] RCOND */
 790 /* > \verbatim */
 791 /* >          RCOND is REAL */
 792 /* >     Reciprocal scaled condition number.  This is an estimate of the */
 793 /* >     reciprocal Skeel condition number of the matrix A after */
 794 /* >     equilibration (if done).  If this is less than the machine */
 795 /* >     precision (in particular, if it is zero), the matrix is singular */
 796 /* >     to working precision.  Note that the error may still be small even */
 797 /* >     if this number is very small and the matrix appears ill- */
 798 /* >     conditioned. */
 799 /* > \endverbatim */
 800 /* > */
 801 /* > \param[out] RPVGRW */
 802 /* > \verbatim */
 803 /* >          RPVGRW is REAL */
 804 /* >     Reciprocal pivot growth.  On exit, this contains the reciprocal */
 805 /* >     pivot growth factor norm(A)/norm(U). The "f2cmax absolute element" */
 806 /* >     norm is used.  If this is much less than 1, then the stability of */
 807 /* >     the LU factorization of the (equilibrated) matrix A could be poor. */
 808 /* >     This also means that the solution X, estimated condition numbers, */
 809 /* >     and error bounds could be unreliable. If factorization fails with */
 810 /* >     0<INFO<=N, then this contains the reciprocal pivot growth factor */
 811 /* >     for the leading INFO columns of A. */
 812 /* > \endverbatim */
 813 /* > */
 814 /* > \param[out] BERR */
 815 /* > \verbatim */
 816 /* >          BERR is REAL array, dimension (NRHS) */
 817 /* >     Componentwise relative backward error.  This is the */
 818 /* >     componentwise relative backward error of each solution vector X(j) */
 819 /* >     (i.e., the smallest relative change in any element of A or B that */
 820 /* >     makes X(j) an exact solution). */
 821 /* > \endverbatim */
 822 /* > */
 823 /* > \param[in] N_ERR_BNDS */
 824 /* > \verbatim */
 825 /* >          N_ERR_BNDS is INTEGER */
 826 /* >     Number of error bounds to return for each right hand side */
 827 /* >     and each type (normwise or componentwise).  See ERR_BNDS_NORM and */
 828 /* >     ERR_BNDS_COMP below. */
 829 /* > \endverbatim */
 830 /* > */
 831 /* > \param[out] ERR_BNDS_NORM */
 832 /* > \verbatim */
 833 /* >          ERR_BNDS_NORM is REAL array, dimension (NRHS, N_ERR_BNDS) */
 834 /* >     For each right-hand side, this array contains information about */
 835 /* >     various error bounds and condition numbers corresponding to the */
 836 /* >     normwise relative error, which is defined as follows: */
 837 /* > */
 838 /* >     Normwise relative error in the ith solution vector: */
 839 /* >             max_j (abs(XTRUE(j,i) - X(j,i))) */
 840 /* >            ------------------------------ */
 841 /* >                  max_j abs(X(j,i)) */
 842 /* > */
 843 /* >     The array is indexed by the type of error information as described */
 844 /* >     below. There currently are up to three pieces of information */
 845 /* >     returned. */
 846 /* > */
 847 /* >     The first index in ERR_BNDS_NORM(i,:) corresponds to the ith */
 848 /* >     right-hand side. */
 849 /* > */
 850 /* >     The second index in ERR_BNDS_NORM(:,err) contains the following */
 851 /* >     three fields: */
 852 /* >     err = 1 "Trust/don't trust" boolean. Trust the answer if the */
 853 /* >              reciprocal condition number is less than the threshold */
 854 /* >              sqrt(n) * slamch('Epsilon'). */
 855 /* > */
 856 /* >     err = 2 "Guaranteed" error bound: The estimated forward error, */
 857 /* >              almost certainly within a factor of 10 of the true error */
 858 /* >              so long as the next entry is greater than the threshold */
 859 /* >              sqrt(n) * slamch('Epsilon'). This error bound should only */
 860 /* >              be trusted if the previous boolean is true. */
 861 /* > */
 862 /* >     err = 3  Reciprocal condition number: Estimated normwise */
 863 /* >              reciprocal condition number.  Compared with the threshold */
 864 /* >              sqrt(n) * slamch('Epsilon') to determine if the error */
 865 /* >              estimate is "guaranteed". These reciprocal condition */
 866 /* >              numbers are 1 / (norm(Z^{-1},inf) * norm(Z,inf)) for some */
 867 /* >              appropriately scaled matrix Z. */
 868 /* >              Let Z = S*A, where S scales each row by a power of the */
 869 /* >              radix so all absolute row sums of Z are approximately 1. */
 870 /* > */
 871 /* >     See Lapack Working Note 165 for further details and extra */
 872 /* >     cautions. */
 873 /* > \endverbatim */
 874 /* > */
 875 /* > \param[out] ERR_BNDS_COMP */
 876 /* > \verbatim */
 877 /* >          ERR_BNDS_COMP is REAL array, dimension (NRHS, N_ERR_BNDS) */
 878 /* >     For each right-hand side, this array contains information about */
 879 /* >     various error bounds and condition numbers corresponding to the */
 880 /* >     componentwise relative error, which is defined as follows: */
 881 /* > */
 882 /* >     Componentwise relative error in the ith solution vector: */
 883 /* >                    abs(XTRUE(j,i) - X(j,i)) */
 884 /* >             max_j ---------------------- */
 885 /* >                         abs(X(j,i)) */
 886 /* > */
 887 /* >     The array is indexed by the right-hand side i (on which the */
 888 /* >     componentwise relative error depends), and the type of error */
 889 /* >     information as described below. There currently are up to three */
 890 /* >     pieces of information returned for each right-hand side. If */
 891 /* >     componentwise accuracy is not requested (PARAMS(3) = 0.0), then */
 892 /* >     ERR_BNDS_COMP is not accessed.  If N_ERR_BNDS < 3, then at most */
 893 /* >     the first (:,N_ERR_BNDS) entries are returned. */
 894 /* > */
 895 /* >     The first index in ERR_BNDS_COMP(i,:) corresponds to the ith */
 896 /* >     right-hand side. */
 897 /* > */
 898 /* >     The second index in ERR_BNDS_COMP(:,err) contains the following */
 899 /* >     three fields: */
 900 /* >     err = 1 "Trust/don't trust" boolean. Trust the answer if the */
 901 /* >              reciprocal condition number is less than the threshold */
 902 /* >              sqrt(n) * slamch('Epsilon'). */
 903 /* > */
 904 /* >     err = 2 "Guaranteed" error bound: The estimated forward error, */
 905 /* >              almost certainly within a factor of 10 of the true error */
 906 /* >              so long as the next entry is greater than the threshold */
 907 /* >              sqrt(n) * slamch('Epsilon'). This error bound should only */
 908 /* >              be trusted if the previous boolean is true. */
 909 /* > */
 910 /* >     err = 3  Reciprocal condition number: Estimated componentwise */
 911 /* >              reciprocal condition number.  Compared with the threshold */
 912 /* >              sqrt(n) * slamch('Epsilon') to determine if the error */
 913 /* >              estimate is "guaranteed". These reciprocal condition */
 914 /* >              numbers are 1 / (norm(Z^{-1},inf) * norm(Z,inf)) for some */
 915 /* >              appropriately scaled matrix Z. */
 916 /* >              Let Z = S*(A*diag(x)), where x is the solution for the */
 917 /* >              current right-hand side and S scales each row of */
 918 /* >              A*diag(x) by a power of the radix so all absolute row */
 919 /* >              sums of Z are approximately 1. */
 920 /* > */
 921 /* >     See Lapack Working Note 165 for further details and extra */
 922 /* >     cautions. */
 923 /* > \endverbatim */
 924 /* > */
 925 /* > \param[in] NPARAMS */
 926 /* > \verbatim */
 927 /* >          NPARAMS is INTEGER */
 928 /* >     Specifies the number of parameters set in PARAMS.  If <= 0, the */
 929 /* >     PARAMS array is never referenced and default values are used. */
 930 /* > \endverbatim */
 931 /* > */
 932 /* > \param[in,out] PARAMS */
 933 /* > \verbatim */
 934 /* >          PARAMS is REAL array, dimension NPARAMS */
 935 /* >     Specifies algorithm parameters.  If an entry is < 0.0, then */
 936 /* >     that entry will be filled with default value used for that */
 937 /* >     parameter.  Only positions up to NPARAMS are accessed; defaults */
 938 /* >     are used for higher-numbered parameters. */
 939 /* > */
 940 /* >       PARAMS(LA_LINRX_ITREF_I = 1) : Whether to perform iterative */
 941 /* >            refinement or not. */
 942 /* >         Default: 1.0 */
 943 /* >            = 0.0:  No refinement is performed, and no error bounds are */
 944 /* >                    computed. */
 945 /* >            = 1.0:  Use the double-precision refinement algorithm, */
 946 /* >                    possibly with doubled-single computations if the */
 947 /* >                    compilation environment does not support DOUBLE */
 948 /* >                    PRECISION. */
 949 /* >              (other values are reserved for future use) */
 950 /* > */
 951 /* >       PARAMS(LA_LINRX_ITHRESH_I = 2) : Maximum number of residual */
 952 /* >            computations allowed for refinement. */
 953 /* >         Default: 10 */
 954 /* >         Aggressive: Set to 100 to permit convergence using approximate */
 955 /* >                     factorizations or factorizations other than LU. If */
 956 /* >                     the factorization uses a technique other than */
 957 /* >                     Gaussian elimination, the guarantees in */
 958 /* >                     err_bnds_norm and err_bnds_comp may no longer be */
 959 /* >                     trustworthy. */
 960 /* > */
 961 /* >       PARAMS(LA_LINRX_CWISE_I = 3) : Flag determining if the code */
 962 /* >            will attempt to find a solution with small componentwise */
 963 /* >            relative error in the double-precision algorithm.  Positive */
 964 /* >            is true, 0.0 is false. */
 965 /* >         Default: 1.0 (attempt componentwise convergence) */
 966 /* > \endverbatim */
 967 /* > */
 968 /* > \param[out] WORK */
 969 /* > \verbatim */
 970 /* >          WORK is COMPLEX array, dimension (2*N) */
 971 /* > \endverbatim */
 972 /* > */
 973 /* > \param[out] RWORK */
 974 /* > \verbatim */
 975 /* >          RWORK is REAL array, dimension (2*N) */
 976 /* > \endverbatim */
 977 /* > */
 978 /* > \param[out] INFO */
 979 /* > \verbatim */
 980 /* >          INFO is INTEGER */
 981 /* >       = 0:  Successful exit. The solution to every right-hand side is */
 982 /* >         guaranteed. */
 983 /* >       < 0:  If INFO = -i, the i-th argument had an illegal value */
 984 /* >       > 0 and <= N:  U(INFO,INFO) is exactly zero.  The factorization */
 985 /* >         has been completed, but the factor U is exactly singular, so */
 986 /* >         the solution and error bounds could not be computed. RCOND = 0 */
 987 /* >         is returned. */
 988 /* >       = N+J: The solution corresponding to the Jth right-hand side is */
 989 /* >         not guaranteed. The solutions corresponding to other right- */
 990 /* >         hand sides K with K > J may not be guaranteed as well, but */
 991 /* >         only the first such right-hand side is reported. If a small */
 992 /* >         componentwise error is not requested (PARAMS(3) = 0.0) then */
 993 /* >         the Jth right-hand side is the first with a normwise error */
 994 /* >         bound that is not guaranteed (the smallest J such */
 995 /* >         that ERR_BNDS_NORM(J,1) = 0.0). By default (PARAMS(3) = 1.0) */
 996 /* >         the Jth right-hand side is the first with either a normwise or */
 997 /* >         componentwise error bound that is not guaranteed (the smallest */
 998 /* >         J such that either ERR_BNDS_NORM(J,1) = 0.0 or */
 999 /* >         ERR_BNDS_COMP(J,1) = 0.0). See the definition of */
1000 /* >         ERR_BNDS_NORM(:,1) and ERR_BNDS_COMP(:,1). To get information */
1001 /* >         about all of the right-hand sides check ERR_BNDS_NORM or */
1002 /* >         ERR_BNDS_COMP. */
1003 /* > \endverbatim */
1004
1005 /*  Authors: */
1006 /*  ======== */
1007
1008 /* > \author Univ. of Tennessee */
1009 /* > \author Univ. of California Berkeley */
1010 /* > \author Univ. of Colorado Denver */
1011 /* > \author NAG Ltd. */
1012
1013 /* > \date April 2012 */
1014
1015 /* > \ingroup complexSYsolve */
1016
1017 /*  ===================================================================== */
1018 /* Subroutine */ int csysvxx_(char *fact, char *uplo, integer *n, integer *
1019         nrhs, complex *a, integer *lda, complex *af, integer *ldaf, integer *
1020         ipiv, char *equed, real *s, complex *b, integer *ldb, complex *x,
1021         integer *ldx, real *rcond, real *rpvgrw, real *berr, integer *
1022         n_err_bnds__, real *err_bnds_norm__, real *err_bnds_comp__, integer *
1023         nparams, real *params, complex *work, real *rwork, integer *info)
1024 {
1025     /* System generated locals */
1026     integer a_dim1, a_offset, af_dim1, af_offset, b_dim1, b_offset, x_dim1,
1027             x_offset, err_bnds_norm_dim1, err_bnds_norm_offset,
1028             err_bnds_comp_dim1, err_bnds_comp_offset, i__1;
1029     real r__1, r__2;
1030
1031     /* Local variables */
1032     real amax, smin, smax;
1033     integer j;
1034     extern real cla_syrpvgrw_(char *, integer *, integer *, complex *,
1035             integer *, complex *, integer *, integer *, real *);
1036     extern logical lsame_(char *, char *);
1037     real scond;
1038     logical equil, rcequ;
1039     extern real slamch_(char *);
1040     logical nofact;
1041     extern /* Subroutine */ int clacpy_(char *, integer *, integer *, complex
1042             *, integer *, complex *, integer *), xerbla_(char *,
1043             integer *, ftnlen);
1044     real bignum;
1045     integer infequ;
1046     extern /* Subroutine */ int claqsy_(char *, integer *, complex *, integer
1047             *, real *, real *, real *, char *), csytrf_(char *
1048             , integer *, complex *, integer *, integer *, complex *, integer *
1049             , integer *);
1050     real smlnum;
1051     extern /* Subroutine */ int clascl2_(integer *, integer *, real *,
1052             complex *, integer *), csytrs_(char *, integer *, integer *,
1053             complex *, integer *, integer *, complex *, integer *, integer *), csyequb_(char *, integer *, complex *, integer *, real *,
1054              real *, real *, complex *, integer *), csyrfsx_(char *,
1055             char *, integer *, integer *, complex *, integer *, complex *,
1056             integer *, integer *, real *, complex *, integer *, complex *,
1057             integer *, real *, real *, integer *, real *, real *, integer *,
1058             real *, complex *, real *, integer *);
1059
1060
1061 /*  -- LAPACK driver routine (version 3.7.0) -- */
1062 /*  -- LAPACK is a software package provided by Univ. of Tennessee,    -- */
1063 /*  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- */
1064 /*     April 2012 */
1065
1066
1067 /*  ================================================================== */
1068
1069
1070     /* Parameter adjustments */
1071     err_bnds_comp_dim1 = *nrhs;
1072     err_bnds_comp_offset = 1 + err_bnds_comp_dim1 * 1;
1073     err_bnds_comp__ -= err_bnds_comp_offset;
1074     err_bnds_norm_dim1 = *nrhs;
1075     err_bnds_norm_offset = 1 + err_bnds_norm_dim1 * 1;
1076     err_bnds_norm__ -= err_bnds_norm_offset;
1077     a_dim1 = *lda;
1078     a_offset = 1 + a_dim1 * 1;
1079     a -= a_offset;
1080     af_dim1 = *ldaf;
1081     af_offset = 1 + af_dim1 * 1;
1082     af -= af_offset;
1083     --ipiv;
1084     --s;
1085     b_dim1 = *ldb;
1086     b_offset = 1 + b_dim1 * 1;
1087     b -= b_offset;
1088     x_dim1 = *ldx;
1089     x_offset = 1 + x_dim1 * 1;
1090     x -= x_offset;
1091     --berr;
1092     --params;
1093     --work;
1094     --rwork;
1095
1096     /* Function Body */
1097     *info = 0;
1098     nofact = lsame_(fact, "N");
1099     equil = lsame_(fact, "E");
1100     smlnum = slamch_("Safe minimum");
1101     bignum = 1.f / smlnum;
1102     if (nofact || equil) {
1103         *(unsigned char *)equed = 'N';
1104         rcequ = FALSE_;
1105     } else {
1106         rcequ = lsame_(equed, "Y");
1107     }
1108
1109 /*     Default is failure.  If an input parameter is wrong or */
1110 /*     factorization fails, make everything look horrible.  Only the */
1111 /*     pivot growth is set here, the rest is initialized in CSYRFSX. */
1112
1113     *rpvgrw = 0.f;
1114
1115 /*     Test the input parameters.  PARAMS is not tested until CSYRFSX. */
1116
1117     if (! nofact && ! equil && ! lsame_(fact, "F")) {
1118         *info = -1;
1119     } else if (! lsame_(uplo, "U") && ! lsame_(uplo,
1120             "L")) {
1121         *info = -2;
1122     } else if (*n < 0) {
1123         *info = -3;
1124     } else if (*nrhs < 0) {
1125         *info = -4;
1126     } else if (*lda < f2cmax(1,*n)) {
1127         *info = -6;
1128     } else if (*ldaf < f2cmax(1,*n)) {
1129         *info = -8;
1130     } else if (lsame_(fact, "F") && ! (rcequ || lsame_(
1131             equed, "N"))) {
1132         *info = -10;
1133     } else {
1134         if (rcequ) {
1135             smin = bignum;
1136             smax = 0.f;
1137             i__1 = *n;
1138             for (j = 1; j <= i__1; ++j) {
1139 /* Computing MIN */
1140                 r__1 = smin, r__2 = s[j];
1141                 smin = f2cmin(r__1,r__2);
1142 /* Computing MAX */
1143                 r__1 = smax, r__2 = s[j];
1144                 smax = f2cmax(r__1,r__2);
1145 /* L10: */
1146             }
1147             if (smin <= 0.f) {
1148                 *info = -11;
1149             } else if (*n > 0) {
1150                 scond = f2cmax(smin,smlnum) / f2cmin(smax,bignum);
1151             } else {
1152                 scond = 1.f;
1153             }
1154         }
1155         if (*info == 0) {
1156             if (*ldb < f2cmax(1,*n)) {
1157                 *info = -13;
1158             } else if (*ldx < f2cmax(1,*n)) {
1159                 *info = -15;
1160             }
1161         }
1162     }
1163
1164     if (*info != 0) {
1165         i__1 = -(*info);
1166         xerbla_("CSYSVXX", &i__1, (ftnlen)7);
1167         return 0;
1168     }
1169
1170     if (equil) {
1171
1172 /*     Compute row and column scalings to equilibrate the matrix A. */
1173
1174         csyequb_(uplo, n, &a[a_offset], lda, &s[1], &scond, &amax, &work[1], &
1175                 infequ);
1176         if (infequ == 0) {
1177
1178 /*     Equilibrate the matrix. */
1179
1180             claqsy_(uplo, n, &a[a_offset], lda, &s[1], &scond, &amax, equed);
1181             rcequ = lsame_(equed, "Y");
1182         }
1183     }
1184
1185 /*     Scale the right hand-side. */
1186
1187     if (rcequ) {
1188         clascl2_(n, nrhs, &s[1], &b[b_offset], ldb);
1189     }
1190
1191     if (nofact || equil) {
1192
1193 /*        Compute the LDL^T or UDU^T factorization of A. */
1194
1195         clacpy_(uplo, n, n, &a[a_offset], lda, &af[af_offset], ldaf);
1196         i__1 = f2cmax(1,*n) * 5;
1197         csytrf_(uplo, n, &af[af_offset], ldaf, &ipiv[1], &work[1], &i__1,
1198                 info);
1199
1200 /*        Return if INFO is non-zero. */
1201
1202         if (*info > 0) {
1203
1204 /*           Pivot in column INFO is exactly 0 */
1205 /*           Compute the reciprocal pivot growth factor of the */
1206 /*           leading rank-deficient INFO columns of A. */
1207
1208             if (*n > 0) {
1209                 *rpvgrw = cla_syrpvgrw_(uplo, n, info, &a[a_offset], lda, &
1210                         af[af_offset], ldaf, &ipiv[1], &rwork[1]);
1211             }
1212             return 0;
1213         }
1214     }
1215
1216 /*     Compute the reciprocal pivot growth factor RPVGRW. */
1217
1218     if (*n > 0) {
1219         *rpvgrw = cla_syrpvgrw_(uplo, n, info, &a[a_offset], lda, &af[
1220                 af_offset], ldaf, &ipiv[1], &rwork[1]);
1221     }
1222
1223 /*     Compute the solution matrix X. */
1224
1225     clacpy_("Full", n, nrhs, &b[b_offset], ldb, &x[x_offset], ldx);
1226     csytrs_(uplo, n, nrhs, &af[af_offset], ldaf, &ipiv[1], &x[x_offset], ldx,
1227             info);
1228
1229 /*     Use iterative refinement to improve the computed solution and */
1230 /*     compute error bounds and backward error estimates for it. */
1231
1232     csyrfsx_(uplo, equed, n, nrhs, &a[a_offset], lda, &af[af_offset], ldaf, &
1233             ipiv[1], &s[1], &b[b_offset], ldb, &x[x_offset], ldx, rcond, &
1234             berr[1], n_err_bnds__, &err_bnds_norm__[err_bnds_norm_offset], &
1235             err_bnds_comp__[err_bnds_comp_offset], nparams, &params[1], &work[
1236             1], &rwork[1], info);
1237
1238 /*     Scale solutions. */
1239
1240     if (rcequ) {
1241         clascl2_(n, nrhs, &s[1], &x[x_offset], ldx);
1242     }
1243
1244     return 0;
1245
1246 /*     End of CSYSVXX */
1247
1248 } /* csysvxx_ */
1249