CQRT15(3)

🎀 CQRT15 💅

okay so this is a page from the Library Functions Manual (yes, that's the manual name, we're not doing the whole /home/abui...IN/cqrt15.f(3) header line thing, it's giving "path soup" and we have taste). It lives at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/LIN/cqrt15.f — that's the NAME, bestie, the whole entire path is the name, don't ask, it's a Fortran thing 🫶

---

✨ SYNOPSIS ✨

Functions/Subroutines, babes. We're in the subroutine era:

subroutine CQRT15 (scale, rksel, m, n, nrhs, a, lda, b, ldb, s, rank,
    norma, normb, iseed, work, lwork)
        CQRT15

---

💖 Function/Subroutine Documentation 💖

🌸 The actual signature 🌸

subroutine CQRT15 (integer scale, integer rksel, integer m, integer n,
    integer nrhs, complex, dimension( lda, * ) a, integer lda, complex,
    dimension( ldb, * ) b, integer ldb, real, dimension( * ) s, integer
    rank, real norma, real normb, integer, dimension( 4 ) iseed, complex,
    dimension( lwork ) work, integer lwork)

CQRT15

🦋 Purpose 🦋

CQRT15 generates a matrix with full or deficient rank and of various norms.

that's it, that's the whole purpose. it makes you a matrix. with vibes. 🔥

---

🌈 Parameters (the whole cast, no one gets cut) 🌈

• SCALE — SCALE is INTEGER. and it's the vibe-scaler, lowkey:
  • SCALE = 1: normally scaled matrix
  • SCALE = 2: matrix scaled up
  • SCALE = 3: matrix scaled down
• RKSEL — RKSEL is INTEGER. this is the rank selector, the main character decision of the whole function:
  • RKSEL = 1: full rank matrix
  • RKSEL = 2: rank-deficient matrix
• M — M is INTEGER. The number of rows of the matrix A. iconic. rows girlie.
• N — N is INTEGER. The number of columns of A. columns queen. 💜
• NRHS — NRHS is INTEGER. The number of columns of B. yes B has a life too.
• A — A is COMPLEX array, dimension (LDA,N). it's The M-by-N matrix A. our star ⭐
• LDA — LDA is INTEGER. The leading dimension of the array A. (it's giving "the ~other~ dimension", respect it)
• B — B is COMPLEX array, dimension (LDB, NRHS). A matrix that is in the range space of matrix A. so B is literally living in A's range space, no cap, obsessed with that for them 🫶
• LDB — LDB is INTEGER. The leading dimension of the array B.
• S — S is REAL array, dimension MIN(M,N). Singular values of A. the singular values!! plural!! MIN(M,N) of them!!
• RANK — RANK is INTEGER. number of nonzero singular values of A. lowercase original, I don't make the rules 🎀
• NORMA — NORMA is REAL. one-norm norm of A. yes it's "norm of a norm", we don't question it.
• NORMB — NORMB is REAL. one-norm norm of B.
• ISEED — ISEED is integer array, dimension (4). seed for random number generator. 4 whole slots. the chaos budget 🌸
• WORK — WORK is COMPLEX array, dimension (LWORK). that's the whole description. work space, working hard, no notes 💅
• LWORK — LWORK is INTEGER. length of work space required. and here's the constraint, memorize it, it's on the exam:

LWORK >= MAX(M+MIN(M,N),NRHS*MIN(M,N),2*N+M)

⚠️ bestie please actually respect that LWORK inequality, it's marked as required and we do not mess with required things 🙈

---

👑 Author 👑

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

Definition at line 147 of file cqrt15.f.

---

🌟 Author 🌟

Generated automatically by Doxygen for LAPACK from the source code.

like... the docs wrote themselves. we love an independent queen ✨

---

that's the whole page, you ate it, you understood it, periodt. this whole thing is LAPACK Version 3.12.0 and it came to you from /home/abui...IN/cqrt15.f(3) — mwah, love u, go generate some matrices 💖🎀🦋