TESTING/LIN/dchkps.f(3)

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

πŸ’– TESTING/LIN/dchkps.f πŸ’–

okay so this one is from the Library Functions Manual bestie, and it's literally the docs for DCHKPS β€” the ✨vibe check✨ subroutine that puts DPSTRF through its paces. no cap, it's a testing routine and it's giving "quality assurance queen" 🌈


🌸 SYNOPSIS 🌸

Functions/Subroutines

subroutine dchkps (dotype, nn, nval, nnb, nbval, nrank, rankval, thresh,
    tsterr, nmax, a, afac, perm, piv, work, rwork, nout)
DCHKPS

✨ Function/Subroutine Documentation ✨

πŸŽ€ the signature, in full πŸŽ€

subroutine dchkps (logical, dimension( * ) dotype, integer nn, integer,
    dimension( * ) nval, integer nnb, integer, dimension( * ) nbval, integer
    nrank, integer, dimension( * ) rankval, double precision thresh, logical
    tsterr, integer nmax, double precision, dimension( * ) a, double
    precision, dimension( * ) afac, double precision, dimension( * ) perm,
    integer, dimension( * ) piv, double precision, dimension( * ) work,
    double precision, dimension( * ) rwork, integer nout)
DCHKPS

πŸ’« Purpose πŸ’«

DCHKPS tests DPSTRF.

that's it. that's the whole purpose. short, sweet, iconic πŸ‘‘


πŸ¦‹ Parameters πŸ¦‹

  • DOTYPE β€” a LOGICAL array, dimension (NTYPES). it's the ✨which matrices do we test✨ list: matrices of type j (for 1 <= j <= NTYPES) get tested when DOTYPE(j) = .TRUE.; and if DOTYPE(j) = .FALSE. then type j is literally not used, periodt.
  • NN β€” INTEGER, the number of values of N chillin' inside the vector NVAL.
  • NVAL β€” INTEGER array, dimension (NN). these are the values of the matrix dimension N. πŸ’…
  • NNB β€” INTEGER, the number of values of NB contained in the vector NBVAL.
  • NBVAL β€” INTEGER array, dimension (NNB). the values of the block size NB.
  • NRANK β€” INTEGER, the number of values of RANK contained in the vector RANKVAL.
  • RANKVAL β€” INTEGER array, dimension (NBVAL). and the doc says "The values of the block size NB." β€” yes bestie, dimension (NBVAL) and talking about NB, that's exactly what it says, we're not fixing it, we're just reporting it πŸ™ˆ
  • THRESH β€” DOUBLE PRECISION, the threshold value for the test ratios. a result makes it into the output file if RESULT >= THRESH. wanna see every single test ratio printed? then set THRESH = 0 and go off πŸ”₯
  • TSTERR β€” LOGICAL, the flag that says whether error exits should be tested.
  • NMAX β€” INTEGER, the maximum value allowed for N. it's used for dimensioning the work arrays, so it's doing the heavy lifting fr fr.
  • A β€” DOUBLE PRECISION array, dimension (NMAX*NMAX).
  • AFAC β€” DOUBLE PRECISION array, dimension (NMAX*NMAX).
  • PERM β€” DOUBLE PRECISION array, dimension (NMAX*NMAX).
  • PIV β€” INTEGER array, dimension (NMAX).
  • WORK β€” DOUBLE PRECISION array, dimension (NMAX*3).
  • RWORK β€” DOUBLE PRECISION array, dimension (NMAX).
  • NOUT β€” INTEGER, the unit number for output. that's where all the receipts go 🧾

πŸ‘‘ Author πŸ‘‘

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

πŸ“Œ Definition at line 151 of file dchkps.f.


lowkey a whole squad of universities and NAG Ltd. wrote this, and the page itself was generated automatically by Doxygen for LAPACK from the source code β€” so don't come for the formatting, it's just the pipeline doing its thing 🫢

and that's the whole page bestie!! LAPACK, Version 3.12.0 β€” TESTING/LIN/dchkps.f, that's the source and the version, mwah πŸ’‹βœ¨ go test those routines, you're gonna slay πŸŽ€

πŸ“¦ where this page comes from