p?lacpy

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 4/28/2026

Version

Public

p?lacpy

Copies all or part of one two-dimensional array to another.

Syntax

call pslacpy ( uplo , m , n , a , ia , ja , desca , b , ib , jb , descb )

call pdlacpy ( uplo , m , n , a , ia , ja , desca , b , ib , jb , descb )

call pclacpy ( uplo , m , n , a , ia , ja , desca , b , ib , jb , descb )

call pzlacpy ( uplo , m , n , a , ia , ja , desca , b , ib , jb , descb )

Include Files

mkl_scalapack.h

Description

pslacpy pdlacpy pclacpy pzlacpy The p?lacpy routine function copies all or part of a distributed matrix A to another distributed matrix B . No communication is performed, p?lacpy performs a local copy sub( B ):= sub( A ), where sub( A ) denotes A(ia:ia+m-1,ja:ja+n-1) and sub( B ) denotes B(ib:ib+m-1,jb:jb+n-1) .

Input Parameters

uplo

(global) CHARACTER . Specifies the part of the distributed matrix sub( A ) to be copied:

= ‘U’ : Upper triangular part; the strictly lower triangular part of sub( A ) is not referenced; = ‘L’ : Lower triangular part; 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 in the distributed matrix sub( A ). (m≥0) .

n

(global) INTEGER .

The number of columns in the distributed matrix sub( A ). (n≥0) .

a

(local). REAL for pslacpy DOUBLE PRECISION for pdlacpy COMPLEX for pclacpy COMPLEX*16 for pzlacpy .

Pointer into the local memory to an array of size (lld_a, LOCc(ja+n-1)) .

On entry, this array contains the local pieces of the distributed matrix sub( A ).

ia , ja

(global) INTEGER . The row and column indices in the global matrix A indicating the first row and the first column of the matrix sub( A ), respectively.

desca

(global and local) INTEGER array of size dlen_ . The array descriptor for the distributed matrix A.

ib , jb

(global) INTEGER . The row and column indices in the global matrix B indicating the first row and the first column of sub( B ) respectively.

descb

(global and local) INTEGER array of size dlen_ . The array descriptor for the distributed matrix A.

Output Parameters

b

(local). REAL for pslacpy DOUBLE PRECISION for pdlacpy COMPLEX for pclacpy COMPLEX*16 for pzlacpy .

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) set as follows:

if uplo = 'U' , B ( ib + i -1, jb + j -1) = A ( ia + i -1, ja + j -1), 1≤ i ≤ j , 1≤ j ≤ n ; if uplo = 'L' , B ( ib + i -1, jb + j -1) = A ( ia + i -1, ja + j -1), j ≤ i ≤ m , 1≤ j ≤ n ; otherwise, B ( ib + i -1, jb + j -1) = A ( ia + i -1, ja + j -1), 1≤ i ≤ m , 1≤ j ≤ n .

NOTE:

Overview

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

p?lacpy

Syntax

Include Files

Description

Input Parameters

Output Parameters