DERRED(3)

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

πŸ’… NAME

okay so first thing β€” the NAME section on this one is a whole mood, because it's literally just a path:

/home/abuild/rpmbuild/BUILD/lapack-
static-3.12.0-build/lapack-3.12.0/TESTING/EIG/derred.f

that's derred.f, bestie β€” this page is the manual for derred.f(3), and yes it's a whole Scenarioβ„’ of a path and we're gonna respect it. 🫢


✨ SYNOPSIS ✨

πŸ¦‹ Functions/Subroutines

subroutine DERRED (path, nunit)

DERRED β€” that's the whole vibe, no cap.


πŸŽ€ Function/Subroutine Documentation πŸŽ€

subroutine DERRED (character*3 path, integer nunit)

literally DERRED. iconic. moving on πŸ’…

🌸 Purpose

the !> block straight from the source, bestie, copied exactly so you don't have to squint at it:

!>
!> DERRED tests the error exits for the eigenvalue driver routines for
!> DOUBLE PRECISION matrices:
!>
!> PATH  driver   description
!> ----  ------   -----------
!> SEV   DGEEV    find eigenvalues/eigenvectors for nonsymmetric A
!> SES   DGEES    find eigenvalues/Schur form for nonsymmetric A
!> SVX   DGEEVX   SGEEV + balancing and condition estimation
!> SSX   DGEESX   SGEES + balancing and condition estimation
!> DBD   DGESVD   compute SVD of an M-by-N matrix A
!>       DGESDD   compute SVD of an M-by-N matrix A (by divide and
!>                conquer)
!>       DGEJSV   compute SVD of an M-by-N matrix A where M >= N
!>       DGESVDX  compute SVD of an M-by-N matrix A(by bisection
!>                and inverse iteration)
!>       DGESVDQ  compute SVD of an M-by-N matrix A(with a
!>                QR-Preconditioned )
!>

so what's the tea β˜•: DERRED tests the error exits for the eigenvalue driver routines that work on DOUBLE PRECISION matrices. it's the vibe-checker for the error-handling, not the math itself β€” it's poking the routines to make sure they scream correctly. 🫢

and the PATH / driver / description situation, spelled out so you can match them up:

  • SEV β†’ DGEEV β†’ find eigenvalues/eigenvectors for nonsymmetric A
  • SES β†’ DGEES β†’ find eigenvalues/Schur form for nonsymmetric A
  • SVX β†’ DGEEVX β†’ SGEEV + balancing and condition estimation
  • SSX β†’ DGEESX β†’ SGEES + balancing and condition estimation
  • DBD β†’ DGESVD β†’ compute SVD of an M-by-N matrix A
  • DBD β†’ DGESDD β†’ compute SVD of an M-by-N matrix A (by divide and conquer)
  • DBD β†’ DGEJSV β†’ compute SVD of an M-by-N matrix A where M >= N
  • DBD β†’ DGESVDX β†’ compute SVD of an M-by-N matrix A(by bisection and inverse iteration)
  • DBD β†’ DGESVDQ β†’ compute SVD of an M-by-N matrix A(with a QR-Preconditioned )

(no i did not "fix" the SGEEV / SGEES bits in those descriptions β€” that's exactly what the source says, character for character, and we do NOT editorialize the sacred text πŸ’€)

🧚 Parameters

  • PATH β€” PATH is CHARACTER*3, and it's the LAPACK path name for the routines to be tested. that's literally it, that's the whole job. πŸ‘‘
  • NUNIT β€” NUNIT is INTEGER, and it's the unit number for output. i.e. where all the test output goes to gossip. πŸ“

both of those are straight from the !> comments, bestie:

!>          PATH is CHARACTER*3
!>          The LAPACK path name for the routines to be tested.
!>
!>          NUNIT is INTEGER
!>          The unit number for output.
!>

πŸ‘‘ Author

shoutout to the whole committee, fr fr:

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

Definition at line 69 of file derred.f. β€” line 69, iconic, no notes. ✨


🌈 Author (yes, again)

Generated automatically by Doxygen for LAPACK from the source code. so nobody hand-wrote this bad boy, a robot did, and honestly? it ate. πŸ€–πŸ’…


that's the page, bestie!! this whole thing is from LAPACK, Version 3.12.0, and the footer path reads /home/abui...IG/derred.f(3) β€” abbreviated and gorgeous, just like the original. go forth and test those error exits. πŸ¦‹πŸ’œπŸŽ€

πŸ“¦ where this page comes from