DLASCL(3)

okay so bestie 💖 welcome to DLASCL(3) from the Library Functions Manual. This page is lowkey iconic: it’s all about DLASCL multiplying a real rectangular matrix by a real scalar defined as cto/cfrom. Let’s go. 🫶

🌸 NAME 🌸

The NAME section here is literally just the source file path, no cap:

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/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

subroutine DLASCL (character type, integer kl, integer ku, double precision
    cfrom, double precision cto, integer m, integer n, double precision,
    dimension( lda, * ) a, integer lda, integer info)

DLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom. Yes bestie, same energy as the synopsis, but now with the full signature flex. ✨

🎯 Purpose

Okay so here’s the 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. It indexes the storage type of the input matrix. The values are:

• '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 only the lower half stored.
• 'Q': A is a symmetric band matrix with lower bandwidth KL and upper bandwidth KU and with 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. It’s the lower bandwidth of A. It’s referenced only if TYPE = 'B', 'Q' or 'Z'.

KU

KU is INTEGER. It’s the upper bandwidth of A. It’s 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. The conditions are:

• If TYPE = 'G', 'L', 'U', 'H', then LDA >= max(1,M);
• TYPE = 'B', then LDA >= KL+1;
• TYPE = 'Q', then LDA >= KU+1;
• TYPE = 'Z', then LDA >= 2*KL+KU+1.

INFO

INFO is INTEGER. Exit status tea:

• 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.

Definition at line 142 of file dlascl.f.

🌈 Author 🌈

Generated automatically by Doxygen for LAPACK from the source code.

---

xoxo, your Unix bestie 💖 — signing off with the footer deets: LAPACK Version 3.12.0, source /home/abui...RC/dlascl.f(3). Periodt. 🎀