Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

p?lacon

Estimates the 1-norm of a square matrix, using the reverse communication for evaluating matrix-vector products.

Syntax

void
pslacon
(
MKL_INT
*n
,
float
*v
,
MKL_INT
*iv
,
MKL_INT
*jv
,
MKL_INT
*descv
,
float
*x
,
MKL_INT
*ix
,
MKL_INT
*jx
,
MKL_INT
*descx
,
MKL_INT
*isgn
,
float
*est
,
MKL_INT
*kase
);
void
pdlacon
(
MKL_INT
*n
,
double
*v
,
MKL_INT
*iv
,
MKL_INT
*jv
,
MKL_INT
*descv
,
double
*x
,
MKL_INT
*ix
,
MKL_INT
*jx
,
MKL_INT
*descx
,
MKL_INT
*isgn
,
double
*est
,
MKL_INT
*kase
);
void
pclacon
(
MKL_INT
*n
,
MKL_Complex8
*v
,
MKL_INT
*iv
,
MKL_INT
*jv
,
MKL_INT
*descv
,
MKL_Complex8
*x
,
MKL_INT
*ix
,
MKL_INT
*jx
,
MKL_INT
*descx
,
float
*est
,
MKL_INT
*kase
);
void
pzlacon
(
MKL_INT
*n
,
MKL_Complex16
*v
,
MKL_INT
*iv
,
MKL_INT
*jv
,
MKL_INT
*descv
,
MKL_Complex16
*x
,
MKL_INT
*ix
,
MKL_INT
*jx
,
MKL_INT
*descx
,
double
*est
,
MKL_INT
*kase
);
Include Files
  • mkl_scalapack.h
Description
The
p?lacon
function
estimates the 1-norm of a square, real/unitary distributed matrix
A
. Reverse communication is used for evaluating matrix-vector products.
x
and
v
are aligned with the distributed matrix
A
, this information is implicitly contained within
iv
,
ix
,
descv
, and
descx
.
Input Parameters
n
(global) The length of the distributed vectors
v
and
x. n
0.
v
(local).
Pointer into the local memory to an array of size
LOCr
(
n
+mod(
iv
-1,
mb_v
)). On the final return,
v
=
a
*
w
, where
est
= norm(
v
)/norm(
w
) (
w
is not returned).
iv
,
jv
(global) The row and column indices in the global matrix
V
indicating the first row and the first column of the submatrix
V
, respectively.
descv
(global and local) array of size
dlen_
. The array descriptor for the distributed matrix V.
x
(local).
Pointer into the local memory to an array of size
LOCr
(
n
+mod(
ix
-1,
mb_x
)).
ix
,
jx
(global) The row and column indices in the global matrix
X
indicating the first row and the first column of the submatrix
X
, respectively.
descx
(global and local) array of size
dlen_
. The array descriptor for the distributed matrix X.
isgn
(local).
Array of size
LOCr
(
n
+mod(
ix
-1,
mb_x
)).
isgn
is aligned with
x
and
v
.
kase
(local).
On the initial call to
p?lacon
,
kase
should be 0.
Output Parameters
x
(local).
On an intermediate return, X should be overwritten by
A
*
X
, if
kase
=1,
A'
*
X
, if
kase
=2,
p?lacon
must be re-called with all the other parameters unchanged.
est
(global).
kase
(local)
On an intermediate return,
kase
is 1 or 2, indicating whether
X
should be overwritten by
A
*
X,
or
A'
*
X
. On the final return from
p?lacon
,
kase
is again 0.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804