?lascl

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 12/16/2022

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-4E4F2F4E-7152-4BC5-9BC5-ADA7EB9FBBA2

View Details

?lascl

Multiplies a general rectangular matrix by a real scalar defined as c_to/c_from.

Syntax

call slascl( type, kl, ku, cfrom, cto, m, n, a, lda, info )

call dlascl( type, kl, ku, cfrom, cto, m, n, a, lda, info )

call clascl( type, kl, ku, cfrom, cto, m, n, a, lda, info )

call zlascl( type, kl, ku, cfrom, cto, m, n, a, lda, info )

Include Files

mkl.fi

Description

The routine ?lascl multiplies the m-by-n real/complex matrix A by the real scalar c_to/c_from. The operation is performed without over/underflow as long as the final result c_to*A(i,j)/c_from does not over/underflow.

type specifies that A may be full, upper triangular, lower triangular, upper Hessenberg, or banded.

Input Parameters

type

CHARACTER*1. This parameter specifies the storage type of the input matrix.

= 'G': A is a full matrix.

= 'L': A is a lower triangular matrix.

= 'U': A is an upper triangular matrix.

= 'H': A is an upper Hessenberg matrix.

= 'B': A is a symmetric band matrix with lower bandwidth kl and upper bandwidth ku and with the only the lower half stored

= 'Q': A is a symmetric band matrix with lower bandwidth kl and upper bandwidth ku and with the only the upper half stored.

= 'Z': A is a band matrix with lower bandwidth kl and upper bandwidth ku. See description of the ?gbtrf function for storage details.

kl

INTEGER. The lower bandwidth of A. Referenced only if type = 'B', 'Q' or 'Z'.

ku

INTEGER. The upper bandwidth of A. Referenced only if type = 'B', 'Q' or 'Z'.

cfrom, cto

REAL for slascl/clascl

DOUBLE PRECISION for dlascl/zlascl

The matrix 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

INTEGER. The number of rows of the matrix A. m≥ 0.

n

INTEGER. The number of columns of the matrix A. n≥ 0.

a

REAL for slascl

DOUBLE PRECISION for dlascl

COMPLEX for clascl

DOUBLE COMPLEX for zlascl

Array, size (lda, n). The matrix to be multiplied by cto/cfrom. See type for the storage type.

lda

INTEGER. The leading dimension of the array a.

lda≥ max(1,m).

Output Parameters

a

The multiplied matrix A.

info

INTEGER.

If info = 0 - successful exit

If info = -i < 0, the i-th argument had an illegal value.

Parent topic: LAPACK 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

?lascl

See Also