dlascl.f man page

dlascl.f —

Synopsis

Functions/Subroutines

subroutine dlascl (TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO)
DLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.

Function/Subroutine Documentation

subroutine dlascl (characterTYPE, integerKL, integerKU, double precisionCFROM, double precisionCTO, integerM, integerN, double precision, dimension( lda, * )A, integerLDA, integerINFO)

DLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.

Purpose:

DLASCL multiplies the M by N real matrix A by the real 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
A may be full, upper triangular, lower triangular, upper Hessenberg,
or banded.

Parameters:

TYPE

TYPE is CHARACTER*1
TYPE indices 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 DGBTRF for storage details.

KL

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

KU

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

CFROM

CFROM is DOUBLE PRECISION

CTO

CTO is DOUBLE PRECISION

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

M is INTEGER
The number of rows of the matrix A.  M >= 0.

N

N is INTEGER
The number of columns of the matrix A.  N >= 0.

A

A is DOUBLE PRECISION array, dimension (LDA,N)
The matrix to be multiplied by CTO/CFROM.  See TYPE for the
storage type.

LDA

LDA is INTEGER
The leading dimension of the array A.  LDA >= max(1,M).

INFO

INFO is INTEGER
0  - successful exit
<0 - if INFO = -i, the i-th argument had an illegal value.

Author:

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Date:

September 2012

Definition at line 140 of file dlascl.f.

Author

Generated automatically by Doxygen for LAPACK from the source code.

Referenced By

dlascl(3) is an alias of dlascl.f(3).

Sat Nov 16 2013 Version 3.4.2 LAPACK