DGET35(3)

📦 version 3.12.0, in opensuse-leap 16.0

💅 NAME 💅

So bestie, the page you just opened is literally /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/EIG/dget35.f — and this is the LAPACK dget35.f(3) manual page, no cap. It's a test routine file, and the whole point of it is to vibe-check another routine. 🧪✨

🦋 SYNOPSIS 🦋

Functions/Subroutines

  • subroutine DGET35 (rmax, lmax, ninfo, knt) — that's the one and only, the main character right here 💫 — DGET35

👑 Function/Subroutine Documentation 👑

subroutine DGET35 (double precision rmax, integer lmax, integer ninfo, integer knt)

DGET35 — yes queen, that's the name, she's iconic, she's lowercase in the filesystem and uppercase in the code 💅

🌸 Purpose:

!>
!> DGET35 tests DTRSYL, a routine for solving the Sylvester matrix
!> equation
!>
!>    op(A)*X + ISGN*X*op(B) = scale*C,
!>
!> A and B are assumed to be in Schur canonical form, op() represents an
!> optional transpose, and ISGN can be -1 or +1.  Scale is an output
!> less than or equal to 1, chosen to avoid overflow in X.
!>
!> The test code verifies that the following residual is order 1:
!>
!>    norm(op(A)*X + ISGN*X*op(B) - scale*C) /
!>        (EPS*max(norm(A),norm(B))*norm(X))
!>

Okay so lowkey what this is saying: DGET35 looks at DTRSYL, which is the girlboss that actually solves the Sylvester matrix equation above. A and B are assumed to be sitting in Schur canonical form, op() is an optional transpose (she can flip it if she wants), and ISGN can be -1 or +1. scale is an output, and it's less than or equal to 1 — it's there to dodge overflow in X. 🫶

Then the test code checks that the residual below comes out order 1:

norm(op(A)*X + ISGN*X*op(B) - scale*C) /
    (EPS*max(norm(A),norm(B))*norm(X))

That's the vibe check fr fr — if it's order 1, we slay. 🔥

✨ Parameters ✨

  • RMAX — RMAX is DOUBLE PRECISION. Value of the largest test ratio. Like, the biggest ratio she saw all day 👑
  • LMAX — LMAX is INTEGER. Example number where largest test ratio achieved. So when RMAX popped off, this is the example that did it 🎀
  • NINFO — NINFO is INTEGER. Number of examples where INFO is nonzero. Bestie, we're counting the messy ones 💀
  • KNT — KNT is INTEGER. Total number of examples tested. The full headcount, periodt 🌈

🌟 Author 🌟

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

Definition at line 77 of file dget35.f.

💖 Author 💖

Generated automatically by Doxygen for LAPACK from the source code. Not me writing this by hand, the robots did it 🙈✨

💀 Quick heads up: everything above is generated documentation, so if something looks weird, blame Doxygen, not me.

Okay that's the whole page, bestie — LAPACK Version 3.12.0, brought to you from /home/abui...IG/dget35.f(3). Go forth and test those Sylvester equations, mwah 💋🎀🦋

📦 where this page comes from