clascl(l) [redhat man page]

CLASCL(l)								 )								 CLASCL(l)

NAME

       CLASCL - multiplie the M by N complex matrix A by the real scalar CTO/CFROM

SYNOPSIS

       SUBROUTINE CLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO )

	   CHARACTER	  TYPE

	   INTEGER	  INFO, KL, KU, LDA, M, N

	   REAL 	  CFROM, CTO

	   COMPLEX	  A( LDA, * )

PURPOSE

       CLASCL multiplies the M by N complex 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.

ARGUMENTS

       TYPE    (input) 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.

       KL      (input) INTEGER
	       The lower bandwidth of A.  Referenced only if TYPE = 'B',

       KU      (input) INTEGER
	       The upper bandwidth of A.  Referenced only if TYPE = 'B',

       CFROM   (input) REAL
	       CTO	(input)  REAL  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       (input) INTEGER
	       The number of rows of the matrix A.  M >= 0.

       N       (input) INTEGER
	       The number of columns of the matrix A.  N >= 0.

       A       (input/output) COMPLEX array, dimension (LDA,M)
	       The matrix to be multiplied by CTO/CFROM.  See TYPE for the storage type.

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

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

LAPACK version 3.0						   15 June 2000 							 CLASCL(l)

clascl.f(3)							      LAPACK							       clascl.f(3)

NAME

       clascl.f -

SYNOPSIS

   Functions/Subroutines
       subroutine clascl (TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO)
	   CLASCL

Function/Subroutine Documentation
   subroutine clascl (characterTYPE, integerKL, integerKU, realCFROM, realCTO, integerM, integerN, complex, dimension( lda, * )A, integerLDA,
       integerINFO)
       CLASCL

       Purpose:

	    CLASCL multiplies the M by N complex 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 CGBTRF 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 REAL

	   CTO

		     CTO is REAL

		     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 COMPLEX 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:
	   November 2011

       Definition at line 140 of file clascl.f.

Author
       Generated automatically by Doxygen for LAPACK from the source code.

Version 3.4.1							  Sun May 26 2013						       clascl.f(3)