Developer Reference for Intel® oneAPI Math Kernel Library for C
p?lamve
Copies all or part of one two-dimensional distributed array to another.
Syntax
void pslamve ( char*uplo , MKL_INT*m , MKL_INT*n , float*a , MKL_INT*ia , MKL_INT*ja , MKL_INT*desca , float*b , MKL_INT*ib , MKL_INT*jb , MKL_INT*descb , float*dwork );
void pdlamve ( char*uplo , MKL_INT*m , MKL_INT*n , double*a , MKL_INT*ia , MKL_INT*ja , MKL_INT*desca , double*b , MKL_INT*ib , MKL_INT*jb , MKL_INT*descb , double*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 )
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) 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) 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 ).