SRC/claqge.f(3)

📦
version 3.12.1 · 4 versions
, in arch rolling

🌸 SRC/claqge.f 🌸

okay bestie, welcome to the SRC/claqge.f(3) page from the Library Functions Manual — yes, the manual name is folded in right here so you don't have to hunt for it. 💖 This one is all about a Fortran subroutine named claqge, and it's giving very specific linear algebra energy. ✨

✨ NAME ✨

SRC/claqge.f — literally the file, bestie. That's the name. 💅

🦋 SYNOPSIS 🦋

🎀 Functions/Subroutines 🎀

  • subroutine claqge (m, n, a, lda, r, c, rowcnd, colcnd, amax, equed) — CLAQGE scales a general rectangular matrix using row and column scaling factors computed by sgeequ. Slay. 🔥

💅 Function/Subroutine Documentation 💅

The full signature tea is:

subroutine claqge (integer m, integer n, complex, dimension( lda, * ) a,
    integer lda, real, dimension( * ) r, real, dimension( * ) c, real
    rowcnd, real colcnd, real amax, character equed)

CLAQGE scales a general rectangular matrix using row and column scaling factors computed by sgeequ. No cap. 🫶

🎀 Purpose 🎀

CLAQGE equilibrates a general M by N matrix A using the row and column scaling factors that live in the vectors R and C. That's the whole assignment, periodt. 💖

🌸 Parameters 🌸

  • M — type tea: M is INTEGER. It's the number of rows of the matrix A. Constraint: M >= 0. 👑
  • N — type tea: N is INTEGER. It's the number of columns of the matrix A. Constraint: N >= 0. 🌈
  • A — type tea: A is COMPLEX array, dimension (LDA,N). On entry, it's the M by N matrix A. On exit, it's the equilibrated matrix — see EQUED for the form of the equilibrated matrix. Main character array energy. 💅
  • LDA — type tea: LDA is INTEGER. It's the leading dimension of the array A. Constraint: LDA >= max(M,1). Respect the dimension, bestie. 📏
  • R — type tea: R is REAL array, dimension (M). These are the row scale factors for A. 🍓
  • C — type tea: C is REAL array, dimension (N). These are the column scale factors for A. 🦋
  • ROWCND — type tea: ROWCND is REAL. It's the ratio of the smallest R(i) to the largest R(i). Math girlie behavior. ✨
  • COLCND — type tea: COLCND is REAL. It's the ratio of the smallest C(i) to the largest C(i). Also math girlie behavior. 💜
  • AMAX — type tea: AMAX is REAL. It's the absolute value of the largest matrix entry. Big number energy. 🔥
  • EQUED — type tea: EQUED is CHARACTER*1. It specifies the form of equilibration that was done:
    • = 'N': No equilibration.
    • = 'R': Row equilibration, i.e., A has been premultiplied by diag(R).
    • = 'C': Column equilibration, i.e., A has been postmultiplied by diag(C).
    • = 'B': Both row and column equilibration, i.e., A has been replaced by diag(R) * A * diag(C).

🔥 Internal Parameters 🔥

  • THRESH — a threshold value used to decide if row or column scaling should be done based on the ratio of the row or column scaling factors. If ROWCND < THRESH, row scaling is done, and if COLCND < THRESH, column scaling is done. 🎀
  • LARGE and SMALL — threshold values used to decide if row scaling should be done based on the absolute size of the largest matrix element. If AMAX > LARGE or AMAX < SMALL, row scaling is done. 🧚

👑 Author 👑

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.

Definition at line 141 of file claqge.f. 📌

🫶 Author 🫶

Generated automatically by Doxygen for LAPACK from the source code. It's giving auto-generated but still iconic. 💖

And that's the tea, bestie: this page is from LAPACK, Version 3.12.0, and its page tag is SRC/claqge.f(3). Stay equilibrated and slay. ✨💅🦋

📦 where this page comes from