DCHKPB(3)

🌸 NAME 🌸

Okay bestie, this is the dchkpb.f(3) page from the Library Functions Manual, and the NAME line is literally this absolute path — no cap:

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

That’s the whole vibe.

---

✨ SYNOPSIS ✨

🧚 Functions/Subroutines 🧚

Here’s the short version of the subroutine — exact signature, not me editing it:

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

And yes, the function name is DCHKPB. Iconic.

---

🦋 Function/Subroutine Documentation 🦋

Full signature with all the types and dimensions, copied exactly so nobody comes for me:

   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

Yep, DCHKPB again. We love a consistent queen.

💖 Purpose 💖

The source comment spills the tea like this:

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

So it’s testing DPBTRF, -TRS, -RFS, and -CON. Periodt.

🎀 Parameters 🎀

Every parameter, every dimension, all right here. Don’t skip these — they’re doing main character work:

• 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.
• NN — NN is INTEGER. The number of values of N contained in the vector NVAL.
• NVAL — NVAL is INTEGER array, dimension (NN). The values of the matrix dimension N.
• 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.
• 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.
• 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.
• TSTERR — TSTERR is LOGICAL. Flag that indicates whether error exits are to be tested.
• NMAX — NMAX is INTEGER. The maximum value permitted for N, used in dimensioning the work arrays.
• 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.
• 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)).
• RWORK — RWORK is DOUBLE PRECISION array, dimension (max(NMAX,2*NSMAX)).
• IWORK — IWORK is INTEGER array, dimension (NMAX).
• NOUT — NOUT is INTEGER. The unit number for output.

👑 Author 👑

The author lineup is iconic:

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

---

💖 That’s the whole page, bestie — sourced from LAPACK Version 3.12.0, and the footer tag says /home/abui...IN/dchkpb.f(3). 🎀✨