SGET31(3)

๐Ÿ“ฆ version 3.12.0, in opensuse-leap 16.0

๐Ÿ’– NAME ๐Ÿ’–

Okay bestie, welcome to the Library Functions Manual ๐Ÿ’… โ€” this is the page for SGET31(3), and the file itโ€™s about is literally:

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

No cap, thatโ€™s lowkey the whole NAME section: ngl, the routine lives in that file. fr fr. ๐Ÿซถ


โœจ SYNOPSIS โœจ

๐Ÿฆ‹ Functions/Subroutines ๐Ÿฆ‹

subroutine SGET31 (rmax, lmax, ninfo, knt)
    SGET31

โœจ Itโ€™s giving โ€œsubroutine with a little entourage of arguments.โ€ โœจ


๐Ÿงš Function/Subroutine Documentation ๐Ÿงš

Hereโ€™s the full documented signature, exactly:

subroutine SGET31 (real rmax, integer lmax, integer, dimension( 2 ) ninfo,
    integer knt)
    SGET31

๐ŸŽ€ Purpose: ๐ŸŽ€

SGET31 tests SLALN2, a routine for solving:

(ca A - w D)X = sB

where A is an NA by NA matrix (NA=1 or 2 only), w is a real (NW=1) or complex (NW=2) constant, ca is a real constant, D is an NA by NA real diagonal matrix, and B is an NA by NW matrix (when NW=2, the second column of B contains the imaginary part of the solution). The code returns X and s, where s is a scale factor, less than or equal to 1, chosen to avoid overflow in X. ๐Ÿ˜ญโœ‹ no overflow allowed.

If any singular values of ca A-w D are less than another input parameter SMIN, they are perturbed up to SMIN. ๐ŸŒ€

The test condition is that the scaled residual:

    norm( (ca A-w D)*X - s*B ) /
          ( max( ulp*norm(ca A-w D), SMIN )*norm(X) )

should be on the order of 1. Here, ulp is the machine precision. Also, it is verified that SCALE is less than or equal to 1, and that XNORM = infinity-norm(X). ๐Ÿ‘‘

๐ŸŒธ Parameters ๐ŸŒธ

  • RMAX โ€” is REAL; value of the largest test ratio. ๐Ÿ”ฅ
  • LMAX โ€” is INTEGER; example number where largest test ratio achieved. ๐ŸŽฏ
  • NINFO โ€” is INTEGER array, dimension (2); NINFO(1) = number of examples with INFO less than 0; NINFO(2) = number of examples with INFO greater than 0. ๐ŸŒˆ
  • KNT โ€” is INTEGER; total number of examples tested. ๐Ÿงฎ

๐Ÿ‘‘ Author ๐Ÿ‘‘

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

Definition at line 90 of file sget31.f. ๐Ÿ“


๐Ÿ’œ Author ๐Ÿ’œ

Generated automatically by Doxygen for LAPACK from the source code. ๐Ÿค–๐Ÿ’–


Okay thatโ€™s the whole page, bestie. Cute sign-off: this is LAPACK Version 3.12.0, and the footer path is /home/abui...IG/sget31.f(3) โ€” slay, you made it to the end! periodt. ๐Ÿ’…โœจ

๐Ÿ“ฆ where this page comes from