/home/abui...chkqp3rk.f(3)

πŸ“¦ version 3.12.0, in opensuse-leap 16.0

πŸ’… NAME

ok so bestie, this whole page is about one very long path and honestly it's giving "my filesystem went to therapy":

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

and it lives in the Library Functions Manual β€” which is just fancy speak for "the man pages for library functions", iykyk πŸŽ€βœ¨

Basically this is the man page for DCHKQP3RK, the test-driver subroutine that puts DGEQP3RK through its absolute paces. No cap, it's a whole vibe check for the algorithm.


✨ SYNOPSIS ✨

🌸 Functions/Subroutines

subroutine DCHKQP3RK (dotype, nm, mval, nn, nval, nns, nsval, nnb,
    nbval, nxval, thresh, a, copya, b, copyb, s, tau, work, iwork, nout)

DCHKQP3RK β€” that's her, that's the main character πŸ‘‘


πŸ¦‹ Function/Subroutine Documentation πŸ¦‹

subroutine DCHKQP3RK (logical, dimension( * ) dotype, integer nm, integer,
    dimension( * ) mval, integer nn, integer, dimension( * ) nval, integer
    nns, integer, dimension( * ) nsval, integer nnb, integer, dimension( * )
    nbval, integer, dimension( * ) nxval, double precision thresh, double
    precision, dimension( * ) a, double precision, dimension( * ) copya,
    double precision, dimension( * ) b, double precision, dimension( * )
    copyb, double precision, dimension( * ) s, double precision, dimension(
    * ) tau, double precision, dimension( * ) work, integer, dimension( * )
    iwork, integer nout)

DCHKQP3RK

🧚 Purpose:

!>
!> DCHKQP3RK tests DGEQP3RK.
!>

That's literally it, that's the whole purpose: DCHKQP3RK tests DGEQP3RK. Short. Iconic. Periodt. πŸ’…

πŸ‘‘ Parameters

  • DOTYPE β€” DOTYPE is LOGICAL array, dimension (NTYPES). These are the matrix types getting used for the testing, bestie. Matrices of type j (for 1 <= j <= NTYPES) get their moment if DOTYPE(j) = .TRUE.; if DOTYPE(j) = .FALSE., then type j is sitting this one out, respectfully. 🫢
  • NM β€” NM is INTEGER. It's how many values of M are chilling inside the vector MVAL.
  • MVAL β€” MVAL is INTEGER array, dimension (NM). These are the values of the matrix row dimension M. rows era 🌈
  • 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.
  • 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, a.k.a. NRHS. 😭 lowkey the most extra name for right hand sides but we love her
  • NNB β€” NNB is INTEGER. The number of values of NB and NX contained in the vectors NBVAL and NXVAL. Heads up: the blocking parameters are used in pairs (NB,NX) β€” they're a package deal, fr fr. πŸ’–
  • NBVAL β€” NBVAL is INTEGER array, dimension (NNB). The values of the blocksize NB.
  • NXVAL β€” NXVAL is INTEGER array, dimension (NNB). The values of the crossover point NX.
  • THRESH β€” THRESH is DOUBLE PRECISION. The threshold value for the test ratios, the whole gatekeeper situation ✨. A result makes it into the output file if RESULT >= THRESH. Want every single test ratio printed? Use THRESH = 0. No filter, no gatekeeping, all the tea πŸ“
  • A β€” A is DOUBLE PRECISION array, dimension (MMAX*NMAX), where MMAX is the maximum value of M in MVAL and NMAX is the maximum value of N in NVAL.
  • COPYA β€” COPYA is DOUBLE PRECISION array, dimension (MMAX*NMAX).
  • B β€” B is DOUBLE PRECISION array, dimension (MMAX*NSMAX), where MMAX is the maximum value of M in MVAL and NSMAX is the maximum value of NRHS in NSVAL.
  • COPYB β€” COPYB is DOUBLE PRECISION array, dimension (MMAX*NSMAX).
  • S β€” S is DOUBLE PRECISION array, dimension (min(MMAX,NMAX)). the smaller of the two, we don't need the whole squad πŸ’€
  • TAU β€” TAU is DOUBLE PRECISION array, dimension (MMAX).
  • WORK β€” WORK is DOUBLE PRECISION array, dimension (MMAX*NMAX + 4*NMAX + MMAX). yes that's the actual size, yes it's a lot, don't @ me πŸ”₯
  • IWORK β€” IWORK is INTEGER array, dimension (2*NMAX).
  • NOUT β€” NOUT is INTEGER. The unit number for output β€” where all the results go to be seen and adored. 🌟

πŸŽ€ Author

  • Univ. of Tennessee
  • Univ. of California Berkeley
  • Univ. of Colorado Denver
  • NAG Ltd.
ok the whole academic + NAG squad collaborated on this, that's a group project that actually ate πŸ‘‘

⭐ Definition at line 180 of file dchkqp3rk.f.


πŸ’œ Author

Generated automatically by Doxygen for LAPACK from the source code. not a human, just a little robot scribe doing its thing πŸ€–βœ¨


and that's the whole page, bestie β€” LAPACK Version 3.12.0, from /home/abui...chkqp3rk.f(3), mwah πŸ’‹πŸ«Ά

πŸ“¦ where this page comes from