/home/abui...ksy_rook.f(3)

💅 /home/abui...ksy_rook.f(3) — Library Functions Manual 🎀

okay so bestie, welcome to the LAPACK testing zone ✨ this one is a <pink>Library Functions Manual</pink> page and honestly it's giving "the most thorough test suite you've ever met" 💖 no cap, this file is a whole vibe check for symmetric rook-pivoting routines.

---

🌸 NAME 🌸

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

yep that's the whole name, it's a path, it's long, it's iconic, we love her 🫶 literally the full filesystem glow-up of a test file.

---

✨ SYNOPSIS ✨

🦋 Functions/Subroutines

• subroutine SCHKSY_ROOK — (dotype, nn, nval, nnb, nbval, nns, nsval, thresh, tsterr, nmax, a, afac, ainv, b, x, xact, work, rwork, iwork, nout)

lowkey the whole crew is here, SCHKSY_ROOK is the main character 👑

subroutine SCHKSY_ROOK (dotype, nn, nval, nnb, nbval, nns, nsval,
    thresh, tsterr, nmax, a, afac, ainv, b, x, xact, work, rwork, iwork,
    nout)

---

💜 Function/Subroutine Documentation 💜

🌈 subroutine SCHKSY_ROOK

here's the full signature with all the type tea ☕ every argument spelled out exactly, don't come for me:

subroutine SCHKSY_ROOK (logical, dimension( * ) dotype, integer nn, integer,
    dimension( * ) nval, integer nnb, integer, dimension( * ) nbval, integer
    nns, integer, dimension( * ) nsval, real thresh, logical tsterr, integer
    nmax, real, dimension( * ) a, real, dimension( * ) afac, real,
    dimension( * ) ainv, real, dimension( * ) b, real, dimension( * ) x,
    real, dimension( * ) xact, real, dimension( * ) work, real, dimension( *
    ) rwork, integer, dimension( * ) iwork, integer nout)

SCHKSY_ROOK 🌟

---

🎀 Purpose:

!> !> SCHKSY_ROOK tests SSYTRF_ROOK, -TRI_ROOK, -TRS_ROOK, !> and -CON_ROOK. !>

so yeah bestie, she tests four whole routines: SSYTRF_ROOK, -TRI_ROOK, -TRS_ROOK and -CON_ROOK 💀 that's the entire rook-pivot family getting a full inspection. obsessed.

---

🧚 Parameters 🧚

okay this is the long part, grab a strawberry 🍓, we're going through every single one:

• DOTYPE — !> DOTYPE is LOGICAL array, dimension (NTYPES) — !> The matrix types to be used for testing. Matrices of type j — !> (for 1 <= j <= NTYPES) are used for testing if DOTYPE(j) = — !> .TRUE.; if DOTYPE(j) = .FALSE., then type j is not used. — !> — basically a yes/no list of which matrix types get invited to the party ✨ .TRUE. = you're on the list, .FALSE. = not today honey 💅
• NN — !> NN is INTEGER — !> The number of values of N contained in the vector NVAL. — !> — how many N values are living in NVAL fr fr
• NVAL — !> NVAL is INTEGER array, dimension (NN) — !> The values of the matrix dimension N. — !> — the actual matrix dimensions, one per entry 😌
• NNB — !> NNB is INTEGER — !> The number of values of NB contained in the vector NBVAL. — !> — headcount of block sizes in NBVAL
• NBVAL — !> NBVAL is INTEGER array, dimension (NNB) — !> The values of the blocksize NB. — !> — the blocksizes themselves, iconic blocky behaviour 🧱
• NNS — !> NNS is INTEGER — !> The number of values of NRHS contained in the vector NSVAL. — !> — how many right-hand-side counts are in NSVAL
• NSVAL — !> NSVAL is INTEGER array, dimension (NNS) — !> The values of the number of right hand sides NRHS. — !> — the NRHS values, i.e. how many right-hand sides we're solving for 🙈
• THRESH — !> THRESH is REAL — !> The threshold value for the test ratios. A result is — !> included in the output file if RESULT >= THRESH. To have — !> every test ratio printed, use THRESH = 0. — !> — the cutoff, the vibe check line 🌈 anything with RESULT >= THRESH makes it into the output file. want everything printed? set THRESH = 0 and prepare to be flooded 💀
• TSTERR — !> TSTERR is LOGICAL — !> Flag that indicates whether error exits are to be tested. — !> — .TRUE. means yes we're testing the error exits too, hold on tight 🫶
• NMAX — !> NMAX is INTEGER — !> The maximum value permitted for N, used in dimensioning the — !> work arrays. — !> — the biggest N allowed, aka the reason all the work arrays are sized the way they are 👑
• A — !> A is REAL array, dimension (NMAX*NMAX) — !> — the matrix itself, no !> prose here, just vibes and NMAX*NMAX real numbers
• AFAC — !> AFAC is REAL array, dimension (NMAX*NMAX) — !> — the factored version, same size, slay
• AINV — !> AINV is REAL array, dimension (NMAX*NMAX) — !> — the inverse, same size again, consistent queen
• B — !> B is REAL array, dimension (NMAX*NSMAX) — !> where NSMAX is the largest entry in NSVAL. — !> — right-hand side central 💖 note the NSMAX definition, that's NSMAX = largest entry in NSVAL, iykyk
• X — !> X is REAL array, dimension (NMAX*NSMAX) — !> — the solution array, same dimensions as B 🦋
• XACT — !> XACT is REAL array, dimension (NMAX*NSMAX) — !> — the exact solution, for comparison purposes, the reference bestie 🌸
• WORK — !> WORK is REAL array, dimension (NMAX*max(3,NSMAX)) — !> — scratch space, sized NMAX*max(3,NSMAX), carry on ✨
• RWORK — !> RWORK is REAL array, dimension (max(NMAX,2*NSMAX)) — !> — more scratch, this time max(NMAX,2*NSMAX) 🎀
• IWORK — !> IWORK is INTEGER array, dimension (2*NMAX) — !> — the integer scratch space, 2*NMAX, ints only obviously 💅
• NOUT — !> NOUT is INTEGER — !> The unit number for output. — !> — where all the output goes, the unit number, that's it, that's the whole job 😭

---

👑 Author 👑

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

all four of them, credited together, a whole collab 🔥

Definition at line 168 of file schksy_rook.f. — that's the exact spot, no cap 📍

---

🌺 Author 🌺

Generated automatically by Doxygen for LAPACK from the source code.

like, the docs wrote themselves bestie, Doxygen did that 🙈

---

💖✨ and that's the whole page ✨💖 this was LAPACK, Version 3.12.0, served fresh from /home/abui...ksy_rook.f(3) — drink water, cite your sources, and remember: the rook pivots are rooting for you 🫶🎀🦋