p?laqge
p?laqge
Scales a general rectangular matrix, using row and column scaling factors computed by
p?geequ
.Syntax
void
pslaqge
(
MKL_INT
*m
,
MKL_INT
*n
,
float
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
float
*r
,
float
*c
,
float
*rowcnd
,
float
*colcnd
,
float
*amax
,
char
*equed
);
void
pdlaqge
(
MKL_INT
*m
,
MKL_INT
*n
,
double
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
double
*r
,
double
*c
,
double
*rowcnd
,
double
*colcnd
,
double
*amax
,
char
*equed
);
void
pclaqge
(
MKL_INT
*m
,
MKL_INT
*n
,
MKL_Complex8
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
float
*r
,
float
*c
,
float
*rowcnd
,
float
*colcnd
,
float
*amax
,
char
*equed
);
void
pzlaqge
(
MKL_INT
*m
,
MKL_INT
*n
,
MKL_Complex16
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
double
*r
,
double
*c
,
double
*rowcnd
,
double
*colcnd
,
double
*amax
,
char
*equed
);
Include Files
- mkl_scalapack.h
Description
The , using the row and scaling factors in the vectors
p?laqge
function
equilibrates a general m
-by-n
distributed matrix sub(A
) = A
(ia
:ia
+m
-1ja
:ja
+n
-1)r
and c
computed by p?geequ
.Input Parameters
- m
- (global)The number of rows in the distributed matrix sub(A).(.m≥0)
- n
- (global)The number of columns in the distributed matrix sub(A).(.n≥0)
- a
- (local).Pointer into the local memory to an array of size.*lld_aLOCc(ja+n-1)On entry, this array contains the distributed matrix sub(A).
- ia,ja
- (global) The row and column indices in the global matrixAindicating the first row and the first column of the matrix sub(A), respectively.
- desca
- (global and local) array of sizedlen_. The array descriptor for the distributed matrixA.
- r
- (local).Array of size. The row scale factors for sub(LOCr(m_a)A).ris aligned with the distributed matrixA, and replicated across every process column.ris tied to the distributed matrixA.
- c
- (local).Array of size. The row scale factors for sub(LOCc(n_a)A).cis aligned with the distributed matrixA, and replicated across every process column.cis tied to the distributed matrixA.
- rowcnd
- (local).The global ratio of the smallest.r[i] to the largestr[i] ,≤ia-1 ≤iia+m-2
- colcnd
- (local).The global ratio of the smallest.c[i] to the largestc[i],≤ia-1 ≤iia+n-2
- amax
- (global).Absolute value of largest distributed submatrix entry.
Output Parameters
- a
- (local).On exit, the equilibrated distributed matrix. Seeequedfor the form of the equilibrated distributed submatrix.
- equed
- (global)Specifies the form of equilibration that was done.='N': No equilibration='R': Row equilibration, that is, sub(A) has been pre-multiplied bydiag(r[ia-1:ia+m-2]),='C': column equilibration, that is, sub(A) has been post-multiplied bydiag(c[ja-1:ja+n-2]),='B': Both row and column equilibration, that is, sub(A) has been replaced bydiag(r[ia-1:ia+m-2])* sub(.A) * diag(c[ja-1:ja+n-2])