Developer Reference

  • 2020.2
  • 07/15/2020
  • Public Content
Contents

p?lansy
,
p?lanhe

Returns the value of the 1-norm, Frobenius norm, infinity-norm, or the largest absolute value of any element, of a real symmetric or a complex Hermitian matrix.

Syntax

val
=
pslansy
(
norm
,
uplo
,
n
,
a
,
ia
,
ja
,
desca
,
work
)
val
=
pdlansy
(
norm
,
uplo
,
n
,
a
,
ia
,
ja
,
desca
,
work
)
val
=
pclansy
(
norm
,
uplo
,
n
,
a
,
ia
,
ja
,
desca
,
work
)
val
=
pzlansy
(
norm
,
uplo
,
n
,
a
,
ia
,
ja
,
desca
,
work
)
val
=
pclanhe
(
norm
,
uplo
,
n
,
a
,
ia
,
ja
,
desca
,
work
)
val
=
pzlanhe
(
norm
,
uplo
,
n
,
a
,
ia
,
ja
,
desca
,
work
)
Description
The
p?lansy
and
p?lanhe
routines
return 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
-1
,
ja
:
ja
+
n
-1)
.
Input Parameters
norm
(global)
CHARACTER
.
Specifies what value is returned by the
routine
:
=
'M'
or
'm':
val
=
max
(
abs
(
A
ij
))
, largest absolute value of the matrix
A
, it s not a matrix norm.
=
'1'
or
'O'
or
'o':
val
=
norm1
(
A
)
, 1-norm of the matrix
A
(maximum column sum),
=
'I'
or
'i':
val
=
normI
(
A
)
, infinity norm of the matrix
A
(maximum row sum),
=
'F'
,
'f'
,
'E'
or
'e':
val
=
normF
(
A
)
, Frobenius norm of the matrix
A
(square root of sum of squares).
uplo
(global)
CHARACTER
.
Specifies whether the upper or lower triangular part of the symmetric matrix sub(
A
) is to be referenced.
=
'U'
: Upper triangular part of sub(
A
) is referenced,
=
'L'
: Lower triangular part of sub(
A
) is referenced.
n
(global)
INTEGER
.
The number of columns in the distributed matrix sub(
A
). When
n
= 0
,
p?lansy
is set to zero.
n
0.
a
(local).
REAL
for
pslansy
DOUBLE PRECISION
for
pdlansy
COMPLEX
for
pclansy
,
pclanhe
COMPLEX*16
for
pzlansy
,
pzlanhe
.
Pointer into the local memory to an array of size
(
lld_a
,
LOCc
(
ja
+
n
-1))
containing the local pieces of the distributed matrix sub(
A
).
If
uplo
=
'U'
, the leading
n
-by-
n
upper triangular part of sub(