CCHKGB(3)

📦 version 3.12.0, in opensuse-leap 16.0

Hey bestie 💖 this is cchkgb.f(3) from the Library Functions Manual — and yes, we're getting into LAPACK testing energy. Buckle up, it's giving “I read the whole signature and lived.” ✨

🌸 NAME 🌸

The name is literally this path, no edits: /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/LIN/cchkgb.f.

✨ SYNOPSIS ✨

🛠️ Functions/Subroutines 🛠️

Okay so the synopsis drops this subroutine:

       subroutine CCHKGB (dotype, nm, mval, nn, nval, nnb, nbval, nns, nsval,
           thresh, tsterr, a, la, afac, lafac, b, x, xact, work, rwork, iwork,
           nout)
           CCHKGB

See? It hits you with CCHKGB again. Iconic. 💅

📚 Function/Subroutine Documentation 📚

Here's the fully typed-out version, exactly as the page has it:

   subroutine CCHKGB (logical, dimension( * ) dotype, integer nm, integer,
       dimension( * ) mval, integer nn, integer, dimension( * ) nval, integer
       nnb, integer, dimension( * ) nbval, integer nns, integer, dimension( * )
       nsval, real thresh, logical tsterr, complex, dimension( * ) a, integer
       la, complex, dimension( * ) afac, integer lafac, complex, dimension( * )
       b, complex, dimension( * ) x, complex, dimension( * ) xact, complex,
       dimension( * ) work, real, dimension( * ) rwork, integer, dimension( * )
       iwork, integer nout)
       CCHKGB

Yep, CCHKGB again at the end. Main character behavior, no cap. 🫶

🎯 Purpose 🎯

The purpose, fr fr:

!>
!> CCHKGB tests CGBTRF, -TRS, -RFS, and -CON
!>

Translation: it's the vibe-check for CGBTRF, -TRS, -RFS, and -CON. Slay. 🔥

🧸 Parameters 🧸

Every parameter, every detail, no skipping. Periodt.

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.

NM

NM is INTEGER. The number of values of M contained in the vector MVAL.

MVAL

MVAL is INTEGER array, dimension (NM). The values of the matrix row dimension M.

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 column 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 REAL. 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.

A

A is COMPLEX array, dimension (LA).

LA

LA is INTEGER. The length of the array A. LA >= (KLMAX+KUMAX+1)*NMAX where KLMAX is the largest entry in the local array KLVAL, KUMAX is the largest entry in the local array KUVAL and NMAX is the largest entry in the input array NVAL.

AFAC

AFAC is COMPLEX array, dimension (LAFAC).

LAFAC

LAFAC is INTEGER. The length of the array AFAC. LAFAC >= (2*KLMAX+KUMAX+1)*NMAX where KLMAX is the largest entry in the local array KLVAL, KUMAX is the largest entry in the local array KUVAL and NMAX is the largest entry in the input array NVAL.

B

B is COMPLEX array, dimension (NMAX*NSMAX).

X

X is COMPLEX array, dimension (NMAX*NSMAX).

XACT

XACT is COMPLEX array, dimension (NMAX*NSMAX).

WORK

WORK is COMPLEX array, dimension (NMAX*max(3,NSMAX,NMAX)).

RWORK

RWORK is REAL array, dimension (NMAX+2*NSMAX).

IWORK

IWORK is INTEGER array, dimension (NMAX).

NOUT

NOUT is INTEGER. The unit number for output.

📜 Author 📜

Respect where it's due:

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

Definition at line 188 of file cchkgb.f.

🖋️ Author 🖋️

This second Author section is literally just this line:

Generated automatically by Doxygen for LAPACK from the source code.

Sign-off: LAPACK, Version 3.12.0, page path /home/abui...IN/cchkgb.f(3). No date listed on this footer, so we're not inventing one — periodt. 💅✨

📦 where this page comes from