DLARSCL2(3)

πŸ“¦ version 3.12.0, in opensuse-leap 16.0

πŸ’… DLARSCL2(3) β€” Library Functions Manual ✨

okay bestie, we're in the Library Functions Manual and this page is all about DLARSCL2(3). It's giving "tiny but mighty linear algebra helper" energy, fr fr. No cap, every detail is below β€” path, signature, parameters, author squad, the whole thing. πŸ’–

πŸŽ€ NAME πŸŽ€

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/dlarscl2.f

Lowkey the NAME section is just that path, periodt. Don't come for me β€” that's literally what the page says. 🫢

✨ SYNOPSIS ✨

Functions/Subroutines

subroutine DLARSCL2 (m, n, d, x, ldx)
    DLARSCL2 performs reciprocal diagonal scaling on a matrix.

That one-liner is the vibe check: DLARSCL2 performs reciprocal diagonal scaling on a matrix. Slay.

πŸ¦‹ Function/Subroutine Documentation πŸ¦‹

subroutine DLARSCL2 (integer m, integer n, double precision, dimension( * ) d, double precision, dimension( ldx, * ) x, integer ldx)
    DLARSCL2 performs reciprocal diagonal scaling on a matrix.

Yep, same function, full signature mode. Keep those types and dimensions exactly as they are, iykyk. πŸ’œ

πŸ’– Purpose πŸ’–

Okay so the purpose block is literally this β€” not paraphrasing, just showing the source comment in all its glory:

!>
!> DLARSCL2 performs a reciprocal diagonal scaling on a matrix:
!>   x <-- inv(D) * x
!> where the diagonal matrix D is stored as a vector.
!>
!> Eventually to be replaced by BLAS_dge_diag_scale in the new BLAS
!> standard.
!>

So it's doing x <-- inv(D) * x, with the diagonal matrix D stored as a vector. And yes, it says "Eventually to be replaced by BLAS_dge_diag_scale in the new BLAS standard." That's the tea. β˜•

🌸 Parameters 🌸

  • M β€” M is INTEGER; the number of rows of D and X. Constraint: M >= 0. Bestie, no negative row counts, okay? πŸ’…
  • N β€” N is INTEGER; the number of columns of X. Constraint: N >= 0. Keep it nonnegative, periodt.
  • D β€” D is DOUBLE PRECISION array, dimension (M); the diagonal matrix D, stored as a vector of length M. Iconic vector representation, no notes.
  • X β€” X is DOUBLE PRECISION array, dimension (LDX,N); on entry, the matrix X to be scaled by D; on exit, the scaled matrix. So it goes in as X and comes out scaled β€” glow-up situation. ✨
  • LDX β€” LDX is INTEGER; the leading dimension of the matrix X. Constraint: LDX >= M. Respect the leading dimension, fr fr.

πŸ‘‘ Author πŸ‘‘

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

Periodt. The whole author squad is credited.

Definition at line 89 of file dlarscl2.f.

Also: this page was generated automatically by Doxygen for LAPACK from the source code. So if the formatting is a little manpage-y, that's why, bestie. 🧚

Cute sign-off time: this footer energy is LAPACK, Version 3.12.0, with the path /home/abui.../dlarscl2.f(3). That's the whole thing β€” slay, no cap, and may all your reciprocal diagonal scalings be valid. πŸ’–πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from