p?lascl

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 11/07/2023

Version

Public

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

Visible to Intel only — GUID: GUID-560EEBEE-F17F-4887-B9E0-77653D60B351

View Details

p?lascl

Multiplies a general rectangular matrix by a real scalar defined as C_to/C_from.

Syntax

call pslascl(type, cfrom, cto, m, n, a, ia, ja, desca, info)

call pdlascl(type, cfrom, cto, m, n, a, ia, ja, desca, info)

call pclascl(type, cfrom, cto, m, n, a, ia, ja, desca, info)

call pzlascl(type, cfrom, cto, m, n, a, ia, ja, desca, info)

Description

The p?lasclroutine multiplies the m-by-n real/complex distributed matrix sub(A) denoting A(ia:ia+m-1, ja:ja+n-1) by the real/complex scalar cto/cfrom. This is done without over/underflow as long as the final result cto*A(i,j)/cfrom does not over/underflow. type specifies that sub(A) may be full, upper triangular, lower triangular or upper Hessenberg.

Input Parameters

type

(global) CHARACTER.

type indicates the storage type of the input distributed matrix.

if type = 'G': sub(A) is a full matrix,

if type = 'L': sub(A) is a lower triangular matrix,

if type = 'U': sub(A) is an upper triangular matrix,

if type = 'H': sub(A) is an upper Hessenberg matrix.

cfrom, cto

(global)

REAL for pslascl/pclascl

DOUBLE PRECISION for pdlascl/pzlascl.

The distributed matrix sub(A) is multiplied by cto/cfrom. A(i,j) is computed without over/underflow if the final result cto*A(i,j)/cfrom can be represented without over/underflow. cfrom must be nonzero.

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 input/local output)

REAL for pslascl

DOUBLE PRECISION for pdlascl

COMPLEX for pclascl

COMPLEX*16 for pzlascl.

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

ia, ja

(global) INTEGER.

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

desca

(global and local) INTEGER.

Array of size dlen_.The array descriptor for the distributed matrix A.

Output Parameters

a

(local).

On exit, this array contains the local pieces of the distributed matrix multiplied by cto/cfrom.

info

(local)

INTEGER.

if info = 0: the execution is successful.

if info < 0: If the i-th argument is an array and the j-th entry had an illegal value, then info = -(i*100+j),

if the i-th argument is a scalar and had an illegal value, then info = -i.

Parent topic: ScaLAPACK Auxiliary Routines

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?lascl

Syntax

Description

Input Parameters

Output Parameters

See Also