TESTING/LIN/dchkql.f(3)

📦
version 3.12.1 · 2 versions
, in arch rolling

💅 TESTING/LIN/dchkql.f

okay bestie, so this is a page from the LAPACK manual — the TESTING/LIN corner of it, to be exact — and it's all about dchkql, which sounds like a Pokémon but is actually a test driver. stay with me, it's gonna slay. ✨

✨ SYNOPSIS ✨

🎀 Functions/Subroutines

subroutine dchkql (dotype, nm, mval, nn, nval, nnb, nbval, nxval, nrhs,
    thresh, tsterr, nmax, a, af, aq, al, ac, b, x, xact, tau, work,
    rwork, nout)

DCHKQL — like, that's the whole vibe. 💖

🦋 Function/Subroutine Documentation 🦋

subroutine dchkql (logical, dimension( * ) dotype, integer nm, integer,
    dimension( * ) mval, integer nn, integer, dimension( * ) nval, integer
    nnb, integer, dimension( * ) nbval, integer, dimension( * ) nxval,
    integer nrhs, double precision thresh, logical tsterr, integer nmax,
    double precision, dimension( * ) a, double precision, dimension( * ) af,
    double precision, dimension( * ) aq, double precision, dimension( * )
    al, double precision, dimension( * ) ac, double precision, dimension( *
    ) b, double precision, dimension( * ) x, double precision, dimension( *
    ) xact, double precision, dimension( * ) tau, double precision,
    dimension( * ) work, double precision, dimension( * ) rwork, integer
    nout)

DCHKQL 🌈

🌸 Purpose: 🌸

!> !> DCHKQL tests DGEQLF, DORGQL and DORMQL. !>

fr fr, that's the entire mission statement. it's the vibe check for DGEQLF, DORGQL and DORMQL — those three icons get put through their paces and this subroutine is the one holding the clipboard. 👑

💜 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. !>

so this is your guest list 🎟️ — a LOGICAL array, dimension (NTYPES). it says which matrix types get to come to the party. 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.

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

an INTEGER, and it's literally just the count — how many values of M are sitting in the vector MVAL. 🍓

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

INTEGER array, dimension (NM), holding all the values of the matrix row dimension M. the row-count mood board. 📏

  • NN
!> NN is INTEGER !> The number of values of N contained in the vector NVAL. !>

INTEGER — the number of values of N chilling inside the vector NVAL. twin of NM, different letter. 💫

  • NVAL
!> NVAL is INTEGER array, dimension (NN) !> The values of the matrix column dimension N. !>

INTEGER array, dimension (NN), with the values of the matrix column dimension N. columns, but make it fashion. 🎀

  • NNB
!> NNB is INTEGER !> The number of values of NB and NX contained in the !> vectors NBVAL and NXVAL. The blocking parameters are used !> in pairs (NB,NX). !>

INTEGER, and it counts the values of NB and NX contained in the vectors NBVAL and NXVAL. important detail: the blocking parameters are used in pairs — (NB,NX). they're a package deal, iykyk. 👯‍♀️

  • NBVAL
!> NBVAL is INTEGER array, dimension (NNB) !> The values of the blocksize NB. !>

INTEGER array, dimension (NNB), carrying the values of the blocksize NB. 🧱

  • NXVAL
!> NXVAL is INTEGER array, dimension (NNB) !> The values of the crossover point NX. !>

INTEGER array, dimension (NNB), holding the values of the crossover point NX. the other half of the pair, never forget. ✨

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

INTEGER — how many right hand side vectors get generated for each linear system. one for every system, no crumbs. 🍰

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

DOUBLE PRECISION, the threshold value for the test ratios. a result makes it into the output file if RESULT >= THRESH. and if you're nosy and want every test ratio printed? use THRESH = 0. 💅

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

LOGICAL flag — tells you whether error exits are to be tested or not. yes-errors or no-errors, that's the whole question. 🙈

  • NMAX
!> NMAX is INTEGER !> The maximum value permitted for M or N, used in dimensioning !> the work arrays. !>

INTEGER, the maximum value permitted for M or N, and it's the one doing the dimensioning of the work arrays. it sets the ceiling, bestie. 🔥

  • A
!> A is DOUBLE PRECISION array, dimension (NMAX*NMAX) !>

DOUBLE PRECISION array, dimension (NMAX*NMAX). yes queen, that big. 👑

  • AF
!> AF is DOUBLE PRECISION array, dimension (NMAX*NMAX) !>

DOUBLE PRECISION array, dimension (NMAX*NMAX). same energy, different name. 🦋

  • AQ
!> AQ is DOUBLE PRECISION array, dimension (NMAX*NMAX) !>

DOUBLE PRECISION array, dimension (NMAX*NMAX). the Q really stands for queen honestly. 💅

  • AL
!> AL is DOUBLE PRECISION array, dimension (NMAX*NMAX) !>

DOUBLE PRECISION array, dimension (NMAX*NMAX). that's it, that's the entry. 🌸

  • AC
!> AC is DOUBLE PRECISION array, dimension (NMAX*NMAX) !>

DOUBLE PRECISION array, dimension (NMAX*NMAX). (the A-squad is huge and we respect them all.) 💖

  • B
!> B is DOUBLE PRECISION array, dimension (NMAX*NRHS) !>

DOUBLE PRECISION array, dimension (NMAX*NRHS) — different dimension than the A-squad, don't get it twisted. ⭐

  • X
!> X is DOUBLE PRECISION array, dimension (NMAX*NRHS) !>

DOUBLE PRECISION array, dimension (NMAX*NRHS). 🧚

  • XACT
!> XACT is DOUBLE PRECISION array, dimension (NMAX*NRHS) !>

DOUBLE PRECISION array, dimension (NMAX*NRHS). the exact one — main character energy, obviously. 👑✨

  • TAU
!> TAU is DOUBLE PRECISION array, dimension (NMAX) !>

DOUBLE PRECISION array, dimension (NMAX). 🎀

  • WORK
!> WORK is DOUBLE PRECISION array, dimension (NMAX*NMAX) !>

DOUBLE PRECISION array, dimension (NMAX*NMAX). it's called WORK because it's booked and busy. 💀

  • RWORK
!> RWORK is DOUBLE PRECISION array, dimension (NMAX) !>

DOUBLE PRECISION array, dimension (NMAX). the real-type sibling of WORK, slay. 🌈

  • NOUT
!> NOUT is INTEGER !> The unit number for output. !>

INTEGER, the unit number for output. it's where the receipts get printed. 🧾

👑 Author 👑

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

the whole squad showed up. 🫶

⭐ Definition at line 193 of file dchkql.f. ⭐

(line 193, for the people who need exact coordinates)

🌸 Author 🌸

Generated automatically by Doxygen for LAPACK from the source code. 🤖✨

and that's the page, bestie — go test those factorizations, you're gonna ate 💅

signing off: LAPACK · Version 3.12.0 · TESTING/LIN/dchkql.f(3) — mwah, study hard, hydrate, and may all your ratios stay under THRESH 🫶💖

📦 where this page comes from