slaqgs (3p)

Name

slaqgs - brates a general sparse M by N matrix A.

Synopsis

#include <sunperf.h>


void slaqgs(SuperMatrix *A, float *r, float  *c,  float  rowcnd,  float
colcnd, float amax, char *equed)


void dlaqgs(SuperMatrix *A, double *r, double *c, double rowcnd, double
colcnd, double amax, char *equed)


void claqgs(SuperMatrix *A, complex *r,  complex  *c,  complex  rowcnd,
complex colcnd, complex amax, char *equed)


void zlaqgs(SuperMatrix *A, doublecomplex *r, doublecomplex *c, double-
complex rowcnd,  doublecomplex  colcnd,  doublecomplex  amax,
char *equed)


void  slaqgs_64(SuperMatrix_64  *A,  float  *r, float *c, float rowcnd,
float colcnd, float amax, char *equed)


void dlaqgs_64(SuperMatrix_64 *A, double *r, double *c, double  rowcnd,
double colcnd, double amax, char *equed)


void  claqgs_64(SuperMatrix_64  *A,  complex  *r,  complex  *c, complex
rowcnd, complex colcnd, complex amax, char *equed)


void zlaqgs_64(SuperMatrix_64 *A, doublecomplex *r,  doublecomplex  *c,
doublecomplex  rowcnd,  doublecomplex  colcnd,  doublecomplex
amax, char *equed)

Description

Oracle Solaris Studio Performance Library                            laqgs(3P)



NAME
       laqgs: claqgs, dlaqgs, slaqgs, zlaqgs - a SuperLU function that equili-
       brates a general sparse M by N matrix A.


SYNOPSIS
       #include <sunperf.h>


       void slaqgs(SuperMatrix *A, float *r, float  *c,  float  rowcnd,  float
                 colcnd, float amax, char *equed)


       void dlaqgs(SuperMatrix *A, double *r, double *c, double rowcnd, double
                 colcnd, double amax, char *equed)


       void claqgs(SuperMatrix *A, complex *r,  complex  *c,  complex  rowcnd,
                 complex colcnd, complex amax, char *equed)


       void zlaqgs(SuperMatrix *A, doublecomplex *r, doublecomplex *c, double-
                 complex rowcnd,  doublecomplex  colcnd,  doublecomplex  amax,
                 char *equed)


       void  slaqgs_64(SuperMatrix_64  *A,  float  *r, float *c, float rowcnd,
                 float colcnd, float amax, char *equed)


       void dlaqgs_64(SuperMatrix_64 *A, double *r, double *c, double  rowcnd,
                 double colcnd, double amax, char *equed)


       void  claqgs_64(SuperMatrix_64  *A,  complex  *r,  complex  *c, complex
                 rowcnd, complex colcnd, complex amax, char *equed)


       void zlaqgs_64(SuperMatrix_64 *A, doublecomplex *r,  doublecomplex  *c,
                 doublecomplex  rowcnd,  doublecomplex  colcnd,  doublecomplex
                 amax, char *equed)


PURPOSE
       laqgs equilibrates a general sparse M by N matrix A using the  row  and
       column scaling factors in the arrays r and c.
       r and c are previously computed by routine sgsequ.


ARGUMENTS
       SuperMatrix *A (input/output)
              A  general  matrix  in  sparse  format with dimensions (A->nrow,
              A->ncol).  Currently, the type of A can be:
              Stype = NC; Dtype = SLU_S; Mtype = GE.
              On exit, A is equilibrated.


       float *r (input)
              An array of dimension (A->nrow) that contains the row scale fac-
              tors for A.


       float *c (input)
              An  array  of dimension (A->ncol) that contains the column scale
              factors for A.


       float rowcnd (input)
              Ratio of the smallest value of r to the largest value of r.


       float colcnd (input)
              Ratio of the smallest value of c to the largest value of c.


       float amax (input)
              Absolute value of largest matrix entry.


       char *equed (output)
              Specifies the form of equilibration that was done.


            = 'N':
                   No equilibration

            = 'R': Row  equilibration,  i.e.,  A  has  been  premultiplied  by
                   diag(r).

            = 'C': Column  equilibration,  i.e.,  A has been postmultiplied by
                   diag(c).

            = 'B': Both  row  and  column  equilibration,  i.e.,  A  has  been
                   replaced by diag(r) * A * diag(c).


SEE ALSO
       gsequ

       SuperMatrix

       http://crd.lbl.gov/~xiaoye/SuperLU/

       James  W.  Demmel,  Stanley C. Eisenstat, John R. Gilbert, Xiaoye S. Li
       and Joseph W. H. Liu, "A supernodal approach to sparse  partial  pivot-
       ing",  SIAM J. Matrix Analysis and Applications, Vol. 20, Num. 3, 1999,
       pp. 720-755.



                                  7 Nov 2015                         laqgs(3P)