SQRT13(3)

🎀 SQRT13(3) 🎀

ok so bestie, this one's from the Library Functions Manual — yes that's a whole manual dedicated to library functions, iconic behavior honestly. The page is literally named after a path so let's just get into it 👑

---

✨ NAME ✨

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/LIN/sqrt13.f

like... that's the name. that's the whole name. it's giving "my mom named me after the street we lived on" 😭 but slay, it is what it is, and that's the file we're talking about 💖

---

🌸 SYNOPSIS 🌸

💫 Functions/Subroutines

subroutine SQRT13 (scale, m, n, a, lda, norma, iseed)

SQRT13 ✨ (yeah the synopsis just says the name again, she's lowkey mysterious)

---

🦋 Function/Subroutine Documentation 🦋

subroutine SQRT13 (integer scale, integer m, integer n, real, dimension(
    lda, * ) a, integer lda, real norma, integer, dimension( 4 ) iseed)

SQRT13 💅

🔥 Purpose:

!>
!> SQRT13 generates a full-rank matrix that may be scaled to have large
!> or small norm.
!>

translation bestie: it makes you a full-rank matrix — no weak rows here, she's independent, she's serving linearly independent realness 👑 — and then you can scale her so her norm is either huge or tiny. main character matrix energy fr fr.

---

🍓 Parameters 🍓

• SCALE — this one's an INTEGER and she's got moods:

!>          SCALE is INTEGER
!>          SCALE = 1: normally scaled matrix
!>          SCALE = 2: matrix scaled up
!>          SCALE = 3: matrix scaled down
!>

so like — 1 = the matrix is just being herself (normally scaled), 2 = she ate and got bigger (scaled up), 3 = she's on a cleanse (scaled down). pick your vibe 💅

• M — an INTEGER, and it's the number of rows of the matrix A 🫶

!>          M is INTEGER
!>          The number of rows of the matrix A.
!>

• N — also an INTEGER, and this one's the number of columns of A ✨

!>          N is INTEGER
!>          The number of columns of A.
!>

• A — it's a REAL array, dimension (LDA,N), and it's literally the M-by-N matrix A 👑 the star of the show, the one we're generating, periodt.

!>          A is REAL array, dimension (LDA,N)
!>          The M-by-N matrix A.
!>

• LDA — an INTEGER, and it's the leading dimension of the array A. important structural queen, don't skip her 🎀

!>          LDA is INTEGER
!>          The leading dimension of the array A.
!>

• NORMA — she's a REAL and she holds the one-norm of A 🌈 (yes, one-norm, not "normal", don't come for me)

!>          NORMA is REAL
!>          The one-norm of A.
!>

• ISEED — an integer array, dimension (4), and it's the seed for the random number generator 🎲 four whole slots of pure chaos, iykyk

!>          ISEED is integer array, dimension (4)
!>          Seed for random number generator
!>

---

👑 Author 👑

the geniuses behind this, in order:

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

absolute legends, all four, no cap 🙌

---

📌 quick note bestie: this bad girl is defined at line 90 of file sqrt13.f — so if you ever need to find her in the wild, that's where she lives 💜

---

💖 cute lil sign-off 💖

and that's the page!! this whole thing was generated automatically by Doxygen for LAPACK from the source code (so nobody hand-typed this, the robot did it, and honestly? she ate 🤖✨), running under LAPACK, Version 3.12.0 — and the source path at the bottom is that same .../sqrt13.f(3) we met at the top. full circle, we love a callback 🦋💫

mwah, go forth and generate full-rank matrices responsibly 🫶💅