Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ dlascl(l) — Extended Math Library 3.4

Media Vault

Software Library

Restoration Projects

Artifacts Sought

DLASCL(l)  —  LAPACK auxiliary routine (version 2.0)

NAME

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

SYNOPSIS

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

CHARACTER TYPE

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

DOUBLE PRECISION CFROM, CTO

DOUBLE PRECISION A( LDA, ∗ )

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. 
 

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) DOUBLE PRECISION
CTO     (input) 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       (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) DOUBLE PRECISION 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 2.0  —  08 October 1994

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026