Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
p?lamve
Copies all or part of one two-dimensional distributed array to another.
Syntax
call pslamve(uplo, m, n, a, ia, ja, desca, b, ib, jb, descb, dwork)
call pdlamve(uplo, m, n, a, ia, ja, desca, b, ib, jb, descb, dwork)
Include Files
mkl_scalapack.h
Description
p?lamve copies all or part of a distributed matrix A to another distributed matrix B . There is no alignment assumptions at all except that A and B are of the same size.
Product and Performance Information Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex . Notice revision #20201201
Input Parameters
uplo
(global ) CHARACTER *1
Specifies the part of the distributed matrix sub( A ) to be copied: = ‘U’: Upper triangular part is copied; the strictly lower triangular part of sub( A ) is not referenced; = ‘L’: Lower triangular part is copied; the strictly upper triangular part of sub( A ) is not referenced; Otherwise: All of the matrix sub( A ) is copied.
- m
-
(global ) INTEGER The number of rows to be operated on, which is the number of rows of the distributed matrix sub( A ). m ≥ 0.
- n
-
(global ) INTEGER The number of columns to be operated on, which is the number of columns of the distributed matrix sub( A ). n ≥ 0.
- a
-
REAL for pslamve DOUBLE PRECISION for pdlamve
(local ) pointer into the local memory to an array of size ( lld_a , LOCc ( ja + n -1) ) . This array contains the local pieces of the distributed matrix sub( A ) to be copied from.
- ia
-
(global ) INTEGER The row index in the global matrix A indicating the first row of sub( A ).
- ja
-
(global ) INTEGER The column index in the global matrix A indicating the first column of sub( A ).
desca
(global and local) INTEGER array of size dlen_ .
The array descriptor for the distributed matrix A .
- ib
-
(global ) INTEGER The row index in the global matrix B indicating the first row of sub( B ).
- jb
-
(global ) INTEGER The column index in the global matrix B indicating the first column of sub( B ).
descb
(global and local) INTEGER array of size dlen_ .
The array descriptor for the distributed matrix B .
- dwork
-
REAL for pslamve DOUBLE PRECISION for pdlamve (local workspace) array If uplo = ‘U’ or uplo = ‘L’ and number of processors > 1, the length of dwork is at least as large as the length of b . Otherwise, dwork is not referenced.
OUTPUT Parameters
- b
-
REAL for pslamve DOUBLE PRECISION for pdlamve
(local ) pointer into the local memory to an array of size ( lld_b , LOCc ( jb + n -1) ) . This array contains on exit the local pieces of the distributed matrix sub( B ).