TESTING/LIN/dchkpb.f(3)

📦
version 3.12.1 · 3 versions
, in arch rolling

🎀 TESTING/LIN/dchkpb.f(3) 🎀

okay bestie, so this is a page from the LAPACK manual — yeah, that LAPACK, the linear algebra icon herself 💅 — and today's main character is TESTING/LIN/dchkpb.f, a file living down in TESTING/LIN/. Buckle up, we're doing Fortran testing energy today ✨

✨ SYNOPSIS ✨

Functions/Subroutines

  • subroutine dchkpb (dotype, nn, nval, nnb, nbval, nns, nsval, thresh, tsterr, nmax, a, afac, ainv, b, x, xact, work, rwork, iwork, nout) — that's the whole squad of arguments, and yes there are literally twenty of them, no cap 😭

Also: DCHKPB — the name itself, serving as the subtitle situation 🫶

💜 Function/Subroutine Documentation 💜

🌸 subroutine dchkpb

here's the full signature, written out exactly the way the source has it, because we do not mess with code around here 🧚

subroutine dchkpb (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, double precision, dimension( * ) a, double
    precision, dimension( * ) afac, double precision, dimension( * ) ainv,
    double precision, dimension( * ) b, double precision, dimension( * ) x,
    double precision, dimension( * ) xact, double precision, dimension( * )
    work, double precision, dimension( * ) rwork, integer, dimension( * )
    iwork, integer nout)

DCHKPB — again, iconic, we love a self-named subroutine 👑

🌟 Purpose:

DCHKPB tests DPBTRF, -TRS, -RFS, and -CON.

fr fr that's the entire purpose and it ate 💅

🦋 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. lowkey a little yes/no list for which matrix types get to show up 💖
  • NN — NN is INTEGER. The number of values of N contained in the vector NVAL. it's giving inventory count 🎀
  • NVAL — NVAL is INTEGER array, dimension (NN). The values of the matrix dimension N. so like, all the sizes we're gonna try 🌸
  • NNB — NNB is INTEGER. The number of values of NB contained in the vector NBVAL. blocksize headcount, periodt ✨
  • NBVAL — NBVAL is INTEGER array, dimension (NNB). The values of the blocksize NB. every block size that gets a turn 🧚
  • NNS — NNS is INTEGER. The number of values of NRHS contained in the vector NSVAL. right-hand-side counter energy 💫
  • NSVAL — NSVAL is INTEGER array, dimension (NNS). The values of the number of right hand sides NRHS. how many RHS we're testing, one by one 🫶
  • 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. so like, 0 means print absolutely everything, no filter, main character behaviour 🔥
  • TSTERR — TSTERR is LOGICAL. Flag that indicates whether error exits are to be tested. a lil on/off switch for the error-path vibes 💀
  • NMAX — NMAX is INTEGER. The maximum value permitted for N, used in dimensioning the work arrays. the ceiling, the limit, the moment 😌
  • A — A is DOUBLE PRECISION array, dimension (NMAX*NMAX) 🎀
  • AFAC — AFAC is DOUBLE PRECISION array, dimension (NMAX*NMAX) 🦋
  • AINV — AINV is DOUBLE PRECISION array, dimension (NMAX*NMAX) 🌈
  • B — B is DOUBLE PRECISION array, dimension (NMAX*NSMAX) where NSMAX is the largest entry in NSVAL. okay so NSMAX is defined right here, noted, ty 💖
  • X — X is DOUBLE PRECISION array, dimension (NMAX*NSMAX) ✨
  • XACT — XACT is DOUBLE PRECISION array, dimension (NMAX*NSMAX) 🌸
  • WORK — WORK is DOUBLE PRECISION array, dimension (NMAX*max(3,NSMAX)). there's a max(3,NSMAX) in there, keep it exactly like that 🧚
  • RWORK — RWORK is DOUBLE PRECISION array, dimension (max(NMAX,2*NSMAX)). yes the 2*NSMAX is real, don't @ me 💅
  • IWORK — IWORK is INTEGER array, dimension (NMAX) ⭐
  • NOUT — NOUT is 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.

Definition at line 169 of file dchkpb.f.

🌈 Author

Generated automatically by Doxygen for LAPACK from the source code. (yes the robots wrote the docs, we just made them cute 🫶)

💖 that's the whole page bestie, every param, every dimension, every NMAX*NSMAX preserved with love. go forth and test those band matrices 💅

LAPACK · Version 3.12.0 · TESTING/LIN/dchkpb.f(3) — mwah, signed off with a kiss, no cap 😭💜🦋

📦 where this page comes from