SCKGQR(3)

💅 SCKGQR(3) — like, the Library Functions Manual one, bestie ✨

Okay so real talk, this page lives at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/EIG/sckgqr.f and it's a Fortran thing from LAPACK, so buckle up 🎀

---

🌸 NAME 🌸

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/EIG/sckgqr.f

Yeah. That's the whole name. It's giving "my parents named me after the family law firm" 😭 but we move.

---

✨ SYNOPSIS ✨

Functions/Subroutines

subroutine SCKGQR (nm, mval, np, pval, nn, nval, nmats, iseed, thresh,
    nmax, a, af, aq, ar, taua, b, bf, bz, bt, bwk, taub, work, rwork,
    nin, nout, info)

SCKGQR. That's her. That's the whole subroutine 🫶

---

🦋 Function/Subroutine Documentation 🦋

subroutine SCKGQR (integer nm, integer, dimension( * ) mval, integer np,
    integer, dimension( * ) pval, integer nn, integer, dimension( * ) nval,
    integer nmats, integer, dimension( 4 ) iseed, real thresh, integer nmax,
    real, dimension( * ) a, real, dimension( * ) af, real, dimension( * )
    aq, real, dimension( * ) ar, real, dimension( * ) taua, real, dimension(
    * ) b, real, dimension( * ) bf, real, dimension( * ) bz, real,
    dimension( * ) bt, real, dimension( * ) bwk, real, dimension( * ) taub,
    real, dimension( * ) work, real, dimension( * ) rwork, integer nin,
    integer nout, integer info)

SCKGQR 👑

🎯 Purpose 🎯

No cap, SCKGQR tests two whole factorization situations:

• SGGQRF: the GQR factorization, for an N-by-M matrix A and an N-by-P matrix B.
• SGGRQF: the GRQ factorization, for an M-by-N matrix A and a P-by-N matrix B.

Like, it's the vibe-check machine for both of them 💅

---

🧚 Parameters 🧚

• NM — NM is INTEGER. It's how many values of M are chillin' inside the vector MVAL.
• MVAL — MVAL is INTEGER array, dimension (NM). These are the values of the matrix row(column) dimension M. Yes bestie, row or column, depending on which factorization is on stage that day.
• NP — NP is INTEGER. The number of values of P contained in the vector PVAL.
• PVAL — PVAL is INTEGER array, dimension (NP). The values of the matrix row(column) dimension P.
• NN — NN is INTEGER. The number of values of N contained in the vector NVAL.
• NVAL — NVAL is INTEGER array, dimension (NN). The values of the matrix column(row) dimension N. (Notice how it flips the other way, iykyk ✨)
• NMATS — NMATS is INTEGER. It's the number of matrix types to be tested for each combination of matrix dimensions. Plot twist time:
  • If NMATS >= NTYPES (where NTYPES is the maximum number of matrix types), then literally all the different types get generated for testing.
  • If NMATS < NTYPES, another input line gets read to grab the numbers of the matrix types to be used.

So like, sometimes she reads a whole extra line. Main character energy, honestly.

• ISEED — ISEED is INTEGER array, dimension (4). On entry, this is the seed of the random number generator. Here's the tea though 🔥:
  • The array elements should be between 0 and 4095, otherwise they get reduced mod 4096.
  • ISEED(4) must be odd. Non-negotiable.
  • On exit, it holds the next seed in the random number sequence after all the test matrices have been generated. Glow-up arc complete 💫
• THRESH — THRESH is REAL. The threshold value for the test ratios. A result gets included in the output file if RESULT >= THRESH. And if you're the kind of person who wants every single test ratio printed, use THRESH = 0. No filter, no gatekeeping 🙈
• NMAX — NMAX is INTEGER. The maximum value permitted for M or N, used in dimensioning the work arrays. She's the ceiling, fr.
• A — A is REAL array, dimension (NMAX*NMAX).
• AF — AF is REAL array, dimension (NMAX*NMAX).
• AQ — AQ is REAL array, dimension (NMAX*NMAX).
• AR — AR is REAL array, dimension (NMAX*NMAX).
• TAUA — TAUA is REAL array, dimension (NMAX).
• B — B is REAL array, dimension (NMAX*NMAX).
• BF — BF is REAL array, dimension (NMAX*NMAX).
• BZ — BZ is REAL array, dimension (NMAX*NMAX).
• BT — BT is REAL array, dimension (NMAX*NMAX).
• BWK — BWK is REAL array, dimension (NMAX*NMAX).
• TAUB — TAUB is REAL array, dimension (NMAX).
• WORK — WORK is REAL array, dimension (NMAX*NMAX).
• RWORK — RWORK is REAL array, dimension (NMAX).
• NIN — NIN is INTEGER. The unit number for input. Where the tea gets read from ☕
• NOUT — NOUT is INTEGER. The unit number for output. Where the tea gets spilled 📝
• INFO — INFO is INTEGER:
  • = 0 : successful exit. slay.
  • > 0 : if SLATMS returns an error code, the absolute value of it is returned. So like, a positive INFO means something went sideways and we're reporting it back with the sign stripped off 😭

---

👑 Author 👑

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

The whole squad showed up for this one 🫶

📌 Definition at line 207 of file sckgqr.f. 📌

---

🌈 Author 🌈

Generated automatically by Doxygen for LAPACK from the source code. Not a human, just ✨ automation doing its thing ✨

---

ngl bestie, if you got all the way down here you're officially a LAPACK girlie now. Wear it with pride 💅

---

kisses and compiler optimizations — this was LAPACK, Version 3.12.0, dated /home/abui...IG/sckgqr.f(3), from the Library Functions Manual (3) section 🎀🦋💖