laqgs(3P) Sun 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)
PURPOSElaqgs 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).
COPYRIGHT
Copyright (c) 2003, The Regents of the University of California,
through Lawrence Berkeley National Laboratory (subject to receipt of
any required approvals from U.S. Dept. of Energy)
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.
6 Mar 2009 laqgs(3P)