DGET01(3)

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

DGET01(3) πŸ’…βœ¨

okay so this page is from the dget01.f(3) manual β€” Library Functions Manual energy β€” and it's all about the DGET01 subroutine. bestie, it's giving linear algebra reconstruction realness, no cap. πŸ¦‹


πŸŽ€ NAME πŸŽ€

the NAME entry is literally this file path, and I'm obsessed:

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

periodt. that's the name. πŸ’–


✨ SYNOPSIS ✨

🧚 Functions/Subroutines

here's the synopsis, short and iconic:

subroutine DGET01 (m, n, a, lda, afac, ldafac, ipiv, rwork, resid)
    DGET01

no cap, that's the whole thing. πŸ’…


🫢 Function/Subroutine Documentation 🫢

this is the main character section, fr fr. the full subroutine signature is:

subroutine DGET01 (integer m, integer n, double precision, dimension( lda, * ) a, integer lda, double precision, dimension( ldafac, * ) afac, integer ldafac, integer, dimension( * ) ipiv, double precision, dimension( * ) rwork, double precision resid)
    DGET01

πŸ“ Purpose

the Doxygen source literally says:

!> DGET01 reconstructs a matrix A from its L*U factorization and
!> computes the residual
!>    norm(L*U - A) / ( N * norm(A) * EPS ),
!> where EPS is the machine epsilon.

so, translation: it reconstructs matrix A from its L*U factorization and computes that residual. where EPS is the machine epsilon. that's the tea. β˜•

πŸ’œ Parameters

all the params, in order, no skips, no summaries:

  • M β€” M is INTEGER; the number of rows of the matrix A. M >= 0. πŸ’–
  • N β€” N is INTEGER; the number of columns of the matrix A. N >= 0. ✨
  • A β€” A is DOUBLE PRECISION array, dimension (LDA,N); the original M x N matrix A. πŸŽ€
  • LDA β€” LDA is INTEGER; the leading dimension of the array A. LDA >= max(1,M). πŸ¦‹
  • AFAC β€” AFAC is DOUBLE PRECISION array, dimension (LDAFAC,N); the factored form of the matrix A. AFAC contains the factors L and U from the L*U factorization as computed by DGETRF. Overwritten with the reconstructed matrix, and then with the difference L*U - A. πŸ”₯
  • LDAFAC β€” LDAFAC is INTEGER; the leading dimension of the array AFAC. LDAFAC >= max(1,M). 🌸
  • IPIV β€” IPIV is INTEGER array, dimension (N); the pivot indices from DGETRF. πŸ‘‘
  • RWORK β€” RWORK is DOUBLE PRECISION array, dimension (M). that's the whole description. 🧚
  • RESID β€” RESID is DOUBLE PRECISION; norm(L*U - A) / ( N * norm(A) * EPS ). πŸŽ€

πŸ¦‹ Author

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

🌸 Definition at line 105 of file dget01.f

Definition at line 105 of file dget01.f. β€” that's the exact source location, bestie. πŸ’…


🌈 Author 🌈

Generated automatically by Doxygen for LAPACK from the source code.

not me being auto-generated by Doxygen for LAPACK from the source code πŸ’€ β€” anyway, it's iconic.


cute sign-off: this page is LAPACK Version 3.12.0, and the footer date/path situation is /home/abui...IN/dget01.f(3) β€” bye bestie, slay your L*U factorization πŸ«ΆπŸ’œ

πŸ“¦ where this page comes from