ZCHKSY(3)

📦 version 3.12.0, in opensuse-leap 16.0

💅 ZCHKSY(3) — like, the manual page bestie

okay so first thing: this whole page lives under the manual name Library Functions Manual and the file path is giving very much "deep in the build tree" energy — it's literally /home/abui...IN/zchksy.f(3). slay. let's get into it ✨

🌸 NAME 🌸

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

like yes bestie that's the whole name, it's a whole path, we don't question it, we accept her 🫶

✨ SYNOPSIS ✨

Functions/Subroutines

  • subroutine ZCHKSY (dotype, nn, nval, nnb, nbval, nns, nsval, thresh, tsterr, nmax, a, afac, ainv, b, x, xact, work, rwork, iwork, nout) — this is the one, the main character 👑

ZCHKSY

🦋 Function/Subroutine Documentation 🦋

subroutine ZCHKSY (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)

ZCHKSY

💖 Purpose:

!>
!> ZCHKSY tests ZSYTRF, -TRI2, -TRS, -TRS2,  -RFS, and -CON.
!>

so basically she's the vibe-check queen for a whole little friend group of routines: ZSYTRF, -TRI2, -TRS, -TRS2, -RFS, and -CON. she tests them. all of them. no cap 🔥

🎀 Parameters 🎀

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.
!>

which matrix types are we even testing, bestie? type j (for 1 <= j <= NTYPES) gets tested when DOTYPE(j) = .TRUE. — and if DOTYPE(j) = .FALSE. then type j is literally not invited to the party 🙈

NN

!>          NN is INTEGER
!>          The number of values of N contained in the vector NVAL.
!>

how many values of N are chilling in the vector NVAL 💅

NVAL

!>          NVAL is INTEGER array, dimension (NN)
!>          The values of the matrix dimension N.
!>

the actual matrix dimension N values, living their best life in an array of dimension (NN)

NNB

!>          NNB is INTEGER
!>          The number of values of NB contained in the vector NBVAL.
!>

same energy as NN but for blocksize NB — this is the count 🧚

NBVAL

!>          NBVAL is INTEGER array, dimension (NNB)
!>          The values of the blocksize NB.
!>

the blocksize NB values themselves, dimension (NNB), iconic

NNS

!>          NNS is INTEGER
!>          The number of values of NRHS contained in the vector NSVAL.
!>

count of NRHS values in NSVAL — we love a consistent naming scheme 🎀

NSVAL

!>          NSVAL is INTEGER array, dimension (NNS)
!>          The values of the number of right hand sides NRHS.
!>

the values of the number of right hand sides, NRHS. dimension (NNS). periodt.

THRESH

!>          THRESH is 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.
!>

DOUBLE PRECISION, the threshold for the test ratios. a result makes it into the output file only if RESULT >= THRESH. and if you want literally every test ratio printed? set THRESH = 0. no filter, full chaos, we respect it 💀

TSTERR

!>          TSTERR is LOGICAL
!>          Flag that indicates whether error exits are to be tested.
!>

logical flag: are we testing error exits or not, bestie, decide 😭

NMAX

!>          NMAX is INTEGER
!>          The maximum value permitted for N, used in dimensioning the
!>          work arrays.
!>

the biggest N allowed — she's the reason the work arrays get their dimensions, lowkey carrying the whole operation 🫶

A

!>          A is COMPLEX*16 array, dimension (NMAX*NMAX)
!>

COMPLEX*16 array, dimension (NMAX*NMAX). that's it. that's the whole description. slay ✨

AFAC

!>          AFAC is COMPLEX*16 array, dimension (NMAX*NMAX)
!>

COMPLEX*16, dimension (NMAX*NMAX) — the factored one, the glow-up version 💅

AINV

!>          AINV is COMPLEX*16 array, dimension (NMAX*NMAX)
!>

COMPLEX*16, dimension (NMAX*NMAX) — yes the inverse, she has her own whole array, main character energy 👑

B

!>          B is COMPLEX*16 array, dimension (NMAX*NSMAX)
!>          where NSMAX is the largest entry in NSVAL.
!>

COMPLEX*16, dimension (NMAX*NSMAX) — and important detail bestie: NSMAX is the largest entry in NSVAL 🍓

X

!>          X is COMPLEX*16 array, dimension (NMAX*NSMAX)
!>

COMPLEX*16, dimension (NMAX*NSMAX). same NSMAX deal as above, iykyk

XACT

!>          XACT is COMPLEX*16 array, dimension (NMAX*NSMAX)
!>

COMPLEX*16, dimension (NMAX*NSMAX) — the exact one, the reference, the "this is what it should be" icon 🌈

WORK

!>          WORK is COMPLEX*16 array, dimension (NMAX*max(2,NSMAX))
!>

COMPLEX*16, dimension (NMAX*max(2,NSMAX)) — note the max(2,NSMAX), she's not just NSMAX, don't get it twisted 🧚

RWORK

!>          RWORK is DOUBLE PRECISION array, dimension (NMAX+2*NSMAX)
!>

DOUBLE PRECISION, dimension (NMAX+2*NSMAX) — real ones only 💜

IWORK

!>          IWORK is INTEGER array, dimension (NMAX)
!>

INTEGER array, dimension (NMAX). short. sweet. iconic.

NOUT

!>          NOUT is INTEGER
!>          The unit number for output.
!>

the unit number where all the output goes. that's the spot 💖

👑 Author 👑

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

four whole institutions, a whole collaborative moment, we love to see it 🫶

Definition at line 168 of file zchksy.f. ⭐

💫 Author (the meta one) 💫

Generated automatically by Doxygen for LAPACK from the source code.

like, she wasn't even written by a person, she was generated, and honestly? still ate 💅

ok that's the whole page bestie, every single parameter accounted for, nothing skipped, no cap, fr fr 🌸

LAPACK · Version 3.12.0 · /home/abui...IN/zchksy.f(3) — mwah, go test those routines, ily, bye 🎀💖✨

📦 where this page comes from