Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

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 )

The number of rows to be operated on, which is the number of rows of the distributed matrix sub( A ). m 0.

n

(global )

The number of columns to be operated on, which is the number of columns of the distributed matrix sub( A ). n 0.

a

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

The row index in the global matrix A indicating the first row of sub( A ).

ja

(global )

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 )

The row index in the global matrix B indicating the first row of sub( B ).

jb

(global )

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

(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

(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