p?lange
p?lange
Returns the value of the 1-norm, Frobenius norm, infinity-norm, or the largest absolute value of any element, of a general rectangular matrix.
Syntax
float
pslange
(
char
*norm
,
MKL_INT
*m
,
MKL_INT
*n
,
float
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
float
*work
);
double
pdlange
(
char
*norm
,
MKL_INT
*m
,
MKL_INT
*n
,
double
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
double
*work
);
float
pclange
(
char
*norm
,
MKL_INT
*m
,
MKL_INT
*n
,
MKL_Complex8
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
float
*work
);
double
pzlange
(
char
*norm
,
MKL_INT
*m
,
MKL_INT
*n
,
MKL_Complex16
*a
,
MKL_INT
*ia
,
MKL_INT
*ja
,
MKL_INT
*desca
,
double
*work
);
Include Files
- mkl_scalapack.h
Description
The
p?lange
function
returns the value of the 1-norm, or the Frobenius norm, or the infinity norm, or the element of largest absolute value of a distributed matrix sub(,
.A
) = A
(ia
:ia
+m
-1ja
:ja
+n
-1)Input Parameters
- norm
- (global) Specifies what value is returned by thefunction:='M'or'm':, largest absolute value of the matrixval=max(abs(Aij))A, it s not a matrix norm.='1'or'O'or'o':, 1-norm of the matrixval=norm1(A)A(maximum column sum),='I'or'i':, infinity norm of the matrixval=normI(A)A(maximum row sum),='F','f','E'or'e':, Frobenius norm of the matrixval=normF(A)A(square root of sum of squares).
- m
- (global)The number of rows in the distributed matrix sub(A). When,m= 0p?langeis set to zero.m≥0.
- n
- (global)The number of columns in the distributed matrix sub(A). When,n= 0p?langeis set to zero.n≥0.
- a
- (local).Pointer into the local memory to an array of sizecontaining the local pieces of the distributed matrix sub(lld_a*LOCc(ja+n-1)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 matrix A.
- work
- (local).Array sizelwork.iflwork≥0ornorm='M''m'(not referenced),nq0 if,norm= '1''O'or'o',mp0 ifornorm='I''i',0 if,norm='F''f','E'or'e'(not referenced),where,iroffa=mod(ia-1,mb_a),icoffa=mod(ja-1,nb_a),iarow=indxg2p(ia,mb_a,myrow,rsrc_a,nprow),iacol=indxg2p(ja,nb_a,mycol,csrc_a,npcol)mp0 =numroc(m+iroffa,mb_a,myrow,iarow,nprow),,nq0 =numroc(n+icoffa,nb_a,mycol,iacol,npcol)indxg2pandnumrocare ScaLAPACK toolfunctions;myrow,mycol,nprow, andnpcolcan be determined by calling thefunctionblacs_gridinfo.
Output Parameters
- val
- The value returned by thefunction.