Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 10/31/2024
Public
Document Table of Contents

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 )

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 ).

See Also