CDRVGB(3)

📦 version 3.12.0, in opensuse-leap 16.0

🌸 CDRVGB(3) 🌸

ok so bestie, this is a page from the LAPACK library functions manual (that's the cdrvgb.f(3) situation), and it lives wayyy down in the dungeon at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/LIN/cdrvgb.f. Yes that's the whole path. No I'm not shortening it, it's part of the vibe. 💅

It's from the testing folder btw, which is exactly what it sounds like — this is the girl whose whole job is testing other girls. 🔥

✨ SYNOPSIS ✨

Functions/Subroutines

subroutine CDRVGB (dotype, nn, nval, nrhs, thresh, tsterr, a, la, afb,
    lafb, asav, b, bsav, x, xact, s, work, rwork, iwork, nout)
    CDRVGB

💖 Function/Subroutine Documentation 💖

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

🎀 Purpose 🎀

!> !> CDRVGB tests the driver routines CGBSV and -SVX. !>

no cap, that's literally her entire purpose in life and honestly? main character energy. she tests CGBSV and -SVX and she does it well. 💅

🦋 Parameters 🦋

ok buckle up bestie, there are a LOT of these, but every single one matters so we're doing all of them. 🫶

  • DOTYPE — DOTYPE is LOGICAL array, dimension (NTYPES). it's the guest list basically: it says which matrix types get to be tested. 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. no invite, no entry, periodt. 🙈
  • NN — NN is INTEGER. it's the number of values of N contained in the vector NVAL. lowkey the headcount of the N squad. 💜
  • NVAL — NVAL is INTEGER array, dimension (NN). The values of the matrix column dimension N. so like, all the sizes we're gonna try. ✨
  • NRHS — NRHS is INTEGER. The number of right hand side vectors to be generated for each linear system. that's a lot of right hand sides, slay. 😭
  • 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. ok so if you want everything printed, set it to 0 — she will not hold back, she will show you everything. 💀
  • TSTERR — TSTERR is LOGICAL. Flag that indicates whether error exits are to be tested. are we vibe-checking the error handling? this flag decides. ⭐
  • A — A is COMPLEX array, dimension (LA). she's just out here existing, respect. 🎀
  • LA — LA is INTEGER. The length of the array A. LA >= (2*NMAX-1)*NMAX where NMAX is the largest entry in NVAL. do NOT skimp on this. 🫶
  • AFB — AFB is COMPLEX array, dimension (LAFB). the factored version, she's the glow-up. ✨
  • LAFB — LAFB is INTEGER. The length of the array AFB. LAFB >= (3*NMAX-2)*NMAX where NMAX is the largest entry in NVAL. note that this is a different formula than LA, don't get it twisted bestie. 🙈
  • ASAV — ASAV is COMPLEX array, dimension (LA). the save file, so we can restore her later. 💾 (mentally. it's a save copy.)
  • B — B is COMPLEX array, dimension (NMAX*NRHS). the right hand side crew. 💜
  • BSAV — BSAV is COMPLEX array, dimension (NMAX*NRHS). backup of B, because we don't destroy originals in this house. 🎀
  • X — X is COMPLEX array, dimension (NMAX*NRHS). the solution, she's the answer to everything, literally. 👑
  • XACT — XACT is COMPLEX array, dimension (NMAX*NRHS). the exact solution, the blueprint, the standard. ⭐
  • S — S is REAL array, dimension (2*NMAX). just S. real one. 🌸
  • WORK — WORK is COMPLEX array, dimension (NMAX*max(3,NRHS,NMAX)). she works hard and she does NOT want to hear about it. note the max(3,NRHS,NMAX) — that max is doing actual work, keep it exactly as is. 💅
  • RWORK — RWORK is REAL array, dimension (NMAX+2*NRHS). the real-typed work array, the supportive best friend. 🫶
  • IWORK — IWORK is INTEGER array, dimension (NMAX). integer work array, she's tiny but essential. 🧚
  • NOUT — NOUT is INTEGER. The unit number for output. that's where the receipts get printed. 💖

👑 Author 👑

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

(all icons, all credited, no plagiarism in this group chat) 🌈

📌 Definition at line 169 of file cdrvgb.f. 📌

like, exactly line 169. not 168, not 170. precise queen behavior. 💅

Author (the sequel) 🦋

Generated automatically by Doxygen for LAPACK from the source code. so nobody hand-wrote this, the robot did it, and it ate. 💀

and that's the whole page bestie!! 💖✨

signed off with love from LAPACK, Version 3.12.0, dated /home/abui...IN/cdrvgb.f(3) — mwah, go test some CGBSV and -SVX systems, ily, bye!! 🎀🦋💅

📦 where this page comes from