TESTING/LIN/zdrvgbx.f(3)

📦
version 3.12.1 · 3 versions
, in arch rolling

💖 TESTING/LIN/zdrvgbx.f — zdrvgbx.f(3) ✨

okay so bestie, you found the LAPACK testing page for TESTING/LIN/zdrvgbx.f, and honestly? It's giving "underappreciated icon of the test suite." Let's get into it 💅

✨ NAME ✨

TESTING/LIN/zdrvgbx.f — the file that holds the zdrvgb driver-test subroutine, no cap.

🌸 SYNOPSIS 🌸

Functions/Subroutines

  • subroutine zdrvgb (dotype, nn, nval, nrhs, thresh, tsterr, a, la, afb, lafb, asav, b, bsav, x, xact, s, work, rwork, iwork, nout) — this is the whole squad of arguments, and yes they all get their moment below 🫶
  • ZDRVGBX — the section label itself, slaying as always.

🦋 Function/Subroutine Documentation 🦋

subroutine zdrvgb — the full glow-up signature

Here it is, exactly, in its fully-typed form (do NOT come for me about the line wrapping, this is literally verbatim):

subroutine zdrvgb (logical, dimension( * ) dotype, integer nn, integer,
    dimension( * ) nval, integer nrhs, double precision thresh, logical
    tsterr, complex*16, dimension( * ) a, integer la, complex*16, dimension(
    * ) afb, integer lafb, complex*16, dimension( * ) asav, complex*16,
    dimension( * ) b, complex*16, dimension( * ) bsav, complex*16, dimension(
    * ) x, complex*16, dimension( * ) xact, double precision, dimension( * )
    s, complex*16, dimension( * ) work, double precision, dimension( * )
    rwork, integer, dimension( * ) iwork, integer nout)

ZDRVGBX — that's the header for this subroutine's docs, periodt.

💜 Purpose

ZDRVGB tests the driver routines ZGBSV, -SVX, and -SVXX.

Bestie, listen — there's a whole note attached and it's important:

Note that this file is used only when the XBLAS are available, otherwise zdrvgb.f defines this subroutine.

So like, if you don't have XBLAS, you're in the wrong file, iykyk 🙈

🌈 Parameters

Every single one of them. Present and accounted for. Let's go 💅

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.

So it's basically a little guest list for matrix types — .TRUE. means you're on the list, .FALSE. means better luck next time 🎀

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.

Highkey the lore of your matrix sizes lives here ✨

NRHS

NRHS is INTEGER
The number of right hand side vectors to be generated for each linear system.

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.

👑 Main character energy: if you want the full gossip (all the results), set THRESH = 0. Say less.

TSTERR

TSTERR is LOGICAL
Flag that indicates whether error exits are to be tested.

A

A is COMPLEX*16 array, dimension (LA)

LA

LA is INTEGER
The length of the array A. LA >= (2*NMAX-1)*NMAX where NMAX is the largest entry in NVAL.

Not me doing the math for you — that bound is literally in there, use it 🙏

AFB

AFB is COMPLEX*16 array, dimension (LAFB)

LAFB

LAFB is INTEGER
The length of the array AFB. LAFB >= (3*NMAX-2)*NMAX where NMAX is the largest entry in NVAL.

Different array, different bound, don't mix them up bestie 💀

ASAV

ASAV is COMPLEX*16 array, dimension (LA)

(same length as A, she's the backup copy 🫶)

B

B is COMPLEX*16 array, dimension (NMAX*NRHS)

BSAV

BSAV is COMPLEX*16 array, dimension (NMAX*NRHS)

X

X is COMPLEX*16 array, dimension (NMAX*NRHS)

XACT

XACT is COMPLEX*16 array, dimension (NMAX*NRHS)

(the exact one — she's the reference solution, iconic)

S

S is DOUBLE PRECISION array, dimension (2*NMAX)

WORK

WORK is COMPLEX*16 array, dimension (NMAX*max(3,NRHS,NMAX))

RWORK

RWORK is DOUBLE PRECISION array, dimension (max(2*NMAX,NMAX+2*NRHS))

IWORK

IWORK is INTEGER array, dimension (NMAX)

NOUT

NOUT is INTEGER
The unit number for output.

That's where all the test results get written, so like, keep an eye on it 🌸

🎀 Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

⭐ Definition

Definition at line 172 of file zdrvgbx.f.

💖 Author (again, yes really)

Generated automatically by Doxygen for LAPACK from the source code. Not a human, just vibes and automation 🤖✨

ngl bestie, this page is short but it ate. Every array dimension, every bound, every logical flag — all accounted for, no details left behind 💅

okay that's the whole page!! This diva is from LAPACK, Version 3.12.0, and her home address is TESTING/LIN/zdrvgbx.f(3) — come visit, she's literally always there 🦋💜

📦 where this page comes from