2. EL 7
  3. lapack
  4. dlascl.f(3)

Scroll to navigation

dlascl.f(3) LAPACK dlascl.f(3)

NAME

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.

Tue Sep 25 2012 Version 3.4.2