TESTING/LIN/cchksy.f(3)

πŸ“¦
version 3.12.1 Β· 3 versions
, in arch rolling

πŸ’… TESTING/LIN/cchksy.f β€” like, the whole entire vibe

okay so bestie, buckle up πŸŽ€ this is the manual page for TESTING/LIN/cchksy.f, from the LAPACK library functions manual. it's a Fortran file, it tests things, and it's genuinely iconic. let's get into it ✨


✨ SYNOPSIS β€” Functions/Subroutines ✨

there's exactly one function here, and she's the main character πŸ‘‘:

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

and yeah β€” CCHKSY. that's her name. that's the whole listing. πŸ’œ


πŸ¦‹ Function/Subroutine Documentation πŸ¦‹

the full signature, in all her glory 🌸

subroutine cchksy (logical, dimension( * ) dotype, integer nn, integer,
    dimension( * ) nval, integer nnb, integer, dimension( * ) nbval, integer
    nns, integer, dimension( * ) nsval, 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)

CCHKSY

🎯 Purpose

CCHKSY tests CSYTRF, -TRI2, -TRS, -TRS2, -RFS, and -CON.

that's it. that's the mission statement. she runs the whole gauntlet on those routines, no cap πŸ”₯


🌈 Parameters 🌈

lowkey the longest part but literally every single one matters, so here we go, one by one, no skipping 🫢

  • DOTYPE β€” DOTYPE is LOGICAL array, dimension (NTYPES). it's the matrix types to be used for testing, fr fr. matrices of type j (for 1 <= j <= NTYPES) get used for testing if DOTYPE(j) = .TRUE.; if DOTYPE(j) = .FALSE., then type j is just not used. that's the whole system πŸ’…
  • NN β€” NN is INTEGER. it's the number of values of N contained in the vector NVAL. so like, how many sizes we're testing ✨
  • NVAL β€” NVAL is INTEGER array, dimension (NN). these are the values of the matrix dimension N. the actual sizes, bestie πŸ“
  • NNB β€” NNB is INTEGER. the number of values of NB contained in the vector NBVAL.
  • NBVAL β€” NBVAL is INTEGER array, dimension (NNB). the values of the blocksize NB. block sizes matter, iykyk 🧱
  • NNS β€” NNS is INTEGER. the number of values of NRHS contained in the vector NSVAL.
  • NSVAL β€” NSVAL is INTEGER array, dimension (NNS). the values of the number of right hand sides NRHS. it's giving "how many RHS are we throwing at this" energy πŸ’€
  • THRESH β€” THRESH is REAL. the threshold value for the test ratios. here's the tea: a result is included in the output file if RESULT >= THRESH. and if you want every single test ratio printed? use THRESH = 0. periodt πŸ‘‘
  • TSTERR β€” TSTERR is LOGICAL. flag that indicates whether error exits are to be tested. yeet the errors at it or don't, your call 🚩
  • NMAX β€” NMAX is INTEGER. the maximum value permitted for N, used in dimensioning the work arrays. she's the ceiling, the limit, the whole vibe check for array sizing πŸŽ€
  • A β€” A is COMPLEX array, dimension (NMAX*NMAX). the matrix herself πŸ’–
  • AFAC β€” AFAC is COMPLEX array, dimension (NMAX*NMAX). the factored version, obsessed πŸ”₯
  • AINV β€” AINV is COMPLEX array, dimension (NMAX*NMAX). the inverse. iconic behavior 🌟
  • B β€” B is COMPLEX array, dimension (NMAX*NSMAX), where NSMAX is the largest entry in NSVAL. right hand side bestie 🫢
  • X β€” X is COMPLEX array, dimension (NMAX*NSMAX). the solution zone ✨
  • XACT β€” XACT is COMPLEX array, dimension (NMAX*NSMAX). the exact solution, for comparison purposes, natch πŸ’…
  • WORK β€” WORK is COMPLEX array, dimension (NMAX*max(2,NSMAX)). scratch space, she works hard so the others don't have to 🧚
  • RWORK β€” RWORK is REAL array, dimension (NMAX+2*NSMAX). real-valued scratch space, keeping it grounded 🌸
  • IWORK β€” IWORK is INTEGER array, dimension (NMAX). integer scratch space, tiny but mighty 🌈
  • NOUT β€” NOUT is INTEGER. the unit number for output. that's where all the results go, so like, the printer but make it Fortran πŸ–¨οΈ

πŸ‘‘ Author πŸ‘‘

the legends behind this:

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

absolute icons, every one of them πŸ«‘πŸ’œ

quick note bestie: Definition at line 168 of file cchksy.f. β€” that's where she lives in the source. πŸ“

πŸŽ€ Author (yes, again, but different) πŸŽ€

this bit says: generated automatically by Doxygen for LAPACK from the source code. so like, nobody hand-wrote this page, the machine did it. still slay though πŸ€–βœ¨


πŸ’– cute lil sign-off πŸ’–

and that's the whole page! this beauty is LAPACK, Version 3.12.0, and she's chillin' at TESTING/LIN/cchksy.f(3). go forth and test those complex symmetric matrices, bestie β€” you got this πŸ¦‹πŸŒŸπŸ’œ

πŸ“¦ where this page comes from