TESTING/LIN/zchkhe.f(3)

📦
version 3.12.1 · 2 versions
, in arch rolling

💅 TESTING/LIN/zchkhe.f — like, the whole vibe check on zchkhe

Okay bestie, so this is a page from the TESTING/LIN corner of the LAPACK manual — the file is zchkhe.f and honestly it's giving "backstage pass to the test suite" energy. It's not a function you'd call in your own code, it's the tester that puts the Hermitian routines through their paces. Slay.

✨ SYNOPSIS ✨

Functions/Subroutines

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

^^ that's ZCHKHE, the icon herself. 🎀

🦋 Function/Subroutine Documentation 🦋

subroutine zchkhe

Full signature, character for character, no cap:

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

ZCHKHE 💜

🌸 Purpose 🌸

ZCHKHE tests ZHETRF, -TRI2, -TRS, -TRS2, -RFS, and -CON.

That's the whole mission statement, and she ate. Specifically it's testing ZHETRF, -TRI2, -TRS, -TRS2, -RFS, and -CON — the Hermitian factorization / inverse / solve / refinement / condition-estimation squad. 👑

🎀 Parameters 🎀

Every single one, in order, because we do not skip.

  • DOTYPE — LOGICAL array, dimension (NTYPES). Which matrix types get used for testing, periodt. 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. Binary queen — you're either in or you're out. 💅
  • NN — INTEGER. The number of values of N contained in the vector NVAL.
  • NVAL — INTEGER array, dimension (NN). The values of the matrix dimension N. These are the sizes, bestie.
  • NNB — INTEGER. The number of values of NB contained in the vector NBVAL.
  • NBVAL — INTEGER array, dimension (NNB). The values of the blocksize NB. Blocked-and-booked. ✨
  • NNS — INTEGER. The number of values of NRHS contained in the vector NSVAL.
  • NSVAL — INTEGER array, dimension (NNS). The values of the number of right hand sides NRHS. So like, how many RHS you're serving. 🫶
  • THRESH — DOUBLE PRECISION. 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. Zero means show me everything, main character energy fr fr.
  • TSTERR — LOGICAL. Flag that indicates whether error exits are to be tested. Yes we're testing the error paths too, we're thorough like that. 😭
  • NMAX — INTEGER. The maximum value permitted for N, used in dimensioning the work arrays. It's the ceiling, the limit, the "know your bounds" moment.
  • A — COMPLEX*16 array, dimension (NMAX*NMAX).
  • AFAC — COMPLEX*16 array, dimension (NMAX*NMAX).
  • AINV — COMPLEX*16 array, dimension (NMAX*NMAX).
  • B — COMPLEX*16 array, dimension (NMAX*NSMAX) where NSMAX is the largest entry in NSVAL.
  • X — COMPLEX*16 array, dimension (NMAX*NSMAX).
  • XACT — COMPLEX*16 array, dimension (NMAX*NSMAX).
  • WORK — COMPLEX*16 array, dimension (NMAX*max(3,NSMAX)). Note the max(3,NSMAX), don't @ me, that's literally what it says. 🔥
  • RWORK — DOUBLE PRECISION array, dimension (max(NMAX,2*NSMAX)).
  • IWORK — INTEGER array, dimension (NMAX).
  • NOUT — INTEGER. The unit number for output. Where all the receipts get printed. 🧾

👑 Author 👑

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

And the iconic little detail: Definition at line 168 of file zchkhe.f. ⭐

🌈 Author (of this page) 🌈

Generated automatically by Doxygen for LAPACK from the source code. A robot wrote the original page, and honestly? She understood the assignment. 🤖💖

Fr fr, none of these parameters are optional reading — if you're digging into the LAPACK test suite you will be passing all twenty of them. No shortcuts, bestie. 🍓

That's the whole page! LAPACK, Version 3.12.0, and this little TESTING/LIN/zchkhe.f(3) beauty — mwah. Stay cunty, stay compiled. 💜✨

📦 where this page comes from