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

🌸 /home/abui...drvhe_aa.f(3) — from the LAPACK Library Functions Manual, bestie 💅

Okay so grab a strawberry drink 🍓 and sit down, because this one's a deep cut. This is a page in the Library Functions Manual, and it's all about one teeny-tiny-but-iconic test driver. Yes, it's giving "why is there a whole manpage for one subroutine" and yes, we're reading it anyway. Main character energy only. ✨

---

✨ NAME ✨

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

That's it. That's the name. It's a whole absolute path, no cap — that's literally the file this page documents, straight out of the LAPACK 3.12.0 build tree under TESTING/LIN. Path girlies rise 🫶

---

🦋 SYNOPSIS 🦋

Functions/Subroutines

Uh, there's exactly one, and she's the star of the show:

subroutine CDRVHE_AA (dotype, nn, nval, nrhs, thresh, tsterr, nmax, a,
    afac, ainv, b, x, xact, work, rwork, iwork, nout)

CDRVHE_AA

Like. That's the whole synopsis. She's a fortran subroutine, she takes seventeen arguments, and she's not sorry about it. 💀

---

👑 Function/Subroutine Documentation 👑

subroutine CDRVHE_AA

Here's the full signature with every single type and dimension, exactly as written — do not come for me, I'm not shortening anything:

subroutine CDRVHE_AA (logical, dimension( * ) dotype, integer nn, integer,
    dimension( * ) nval, integer nrhs, real thresh, logical tsterr, integer
    nmax, complex, dimension( * ) a, complex, dimension( * ) afac, complex,
    dimension( * ) ainv, complex, dimension( * ) b, complex, dimension( * )
    x, complex, dimension( * ) xact, complex, dimension( * ) work, real,
    dimension( * ) rwork, integer, dimension( * ) iwork, integer nout)

CDRVHE_AA

💖 Purpose: 💖

!>
!> CDRVHE_AA tests the driver routine CHESV_AA.
!>

That's the whole purpose, periodt. She exists to test the driver routine CHESV_AA. One job. Iconic behavior honestly.

🎀 Parameters 🎀

Bestie, there are seventeen of these, so buckle up. Every single one, coming right up 👇

• DOTYPE — !> DOTYPE is LOGICAL array, dimension (NTYPES) — and the tea is: the matrix types to be used for testing. Matrices of type j (for 1 <= j <= NTYPES) get tested if DOTYPE(j) = .TRUE.; if DOTYPE(j) = .FALSE., then type j is not used. So basically it's the guest list and you decide who gets in 💅
• NN — !> NN is INTEGER — the number of values of N contained in the vector NVAL. It's the count of how many N's we're doing.
• NVAL — !> NVAL is INTEGER array, dimension (NN) — the actual values of the matrix dimension N. The whole lineup. 🌈
• NRHS — !> NRHS is INTEGER — the number of right hand side vectors to be generated for each linear system. Multiple RHS, because why have one when you can have many. 🔥
• THRESH — !> THRESH is REAL — the threshold value for the test ratios. A result gets included in the output file if RESULT >= THRESH. And listen: to have every test ratio printed, use THRESH = 0. Zero is your friend here.
• TSTERR — !> TSTERR is LOGICAL — flag that indicates whether error exits are to be tested. Yes: error exits have their own little test suite. She's thorough. 🧚
• NMAX — !> NMAX is INTEGER — the maximum value permitted for N, used in dimensioning the work arrays. The ceiling, the limit, the "don't go past this" gate.
• A — !> A is COMPLEX array, dimension (NMAX*NMAX) — the matrix herself. 💜
• AFAC — !> AFAC is COMPLEX array, dimension (NMAX*NMAX) — the factored version. Same size, different era.
• AINV — !> AINV is COMPLEX array, dimension (NMAX*NMAX) — the inverse. Also NMAX*NMAX. Consistency slay.
• B — !> B is COMPLEX array, dimension (NMAX*NRHS) — oh look, NRHS finally shows up in a dimension. Hi bestie 🫶
• X — !> X is COMPLEX array, dimension (NMAX*NRHS) — the solution array, same shape as B. Twins!
• XACT — !> XACT is COMPLEX array, dimension (NMAX*NRHS) — the exact solution, so we can compare. The gold standard, the blueprint, the reference. 👑
• WORK — !> WORK is COMPLEX array, dimension (NMAX*max(2,NRHS)) — workspace! Note the max(2,NRHS) because even at minimum she needs two. Never less than 2. Respect.
• RWORK — !> RWORK is REAL array, dimension (NMAX+2*NRHS) — the real-valued workspace, note it's NMAX+2*NRHS and not a product this time. Different formula, different vibe.
• IWORK — !> IWORK is INTEGER array, dimension (NMAX) — integer workspace, single NMAX, plain and simple.
• NOUT — !> NOUT is INTEGER — the unit number for output. Where all the results go to be seen. 📤

Every one of those descriptions came wrapped in !> comment markers in the Fortran source — that's just how Doxygen ate them. The text is the text.

🦋 Author 🦋

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

A whole squad. Four institutions carrying this file on their backs. Teamwork makes the dream work fr fr. 💖

Definition at line 150 of file cdrvhe_aa.f.

---

🎀 Author 🎀

Generated automatically by Doxygen for LAPACK from the source code. So nobody wrote this page, a robot did, and honestly she ate. 🤖✨

---

One last thing bestie: nothing here is dangerous or deprecated, it's just a test driver being a test driver. But note that THRESH = 0 prints everything, so maybe don't be surprised by a very chatty output file. 🙈

---

✿ LAPACK — Version 3.12.0 ✿

And that's the page! Last line energy: it's the LAPACK Version 3.12.0 footer, dated with the /home/abui...drvhe_aa.f(3) title, all cute and tucked away at the bottom. Bye bestie, go test something 💅🎀🦋