clascl (3) - Linux Manuals

clascl.f -

SYNOPSIS

Functions/Subroutines

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

Function/Subroutine Documentation

subroutine clascl (characterTYPE, integerKL, integerKU, realCFROM, realCTO, integerM, integerN, complex, dimension( lda, * )A, integerLDA, integerINFO)

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

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:

September 2012

Definition at line 140 of file clascl.f.

Author

Generated automatically by Doxygen for LAPACK from the source code.