SRC/dlaed9.f(3)

SRC/dlaed9.f(3) is the page title, bestie, and it's living in the Library Functions Manual. It's giving dense-matrix secular-equation energy, and we're gonna read every single parameter like the main characters they are. ๐Ÿ’…

โœจ NAME โœจ

SRC/dlaed9.f โ€” that's the name. Iconic, short, to the point. ๐ŸŽ€

๐ŸŒŸ SYNOPSIS ๐ŸŒŸ

๐Ÿงš Functions/Subroutines ๐Ÿงš

Here's the signature, copied exactly because we do not mess with code in this group chat:

   subroutine dlaed9 (k, kstart, kstop, n, d, q, ldq, rho, dlambda, w, s,
       lds, info)

DLAED9 is used by DSTEDC. It finds the roots of the secular equation and updates the eigenvectors. It's used when the original matrix is dense. No cap, that's the whole synopsis vibe. ๐Ÿ’–

๐Ÿ’– Function/Subroutine Documentation ๐Ÿ’–

Here's the full typed-out version, again exactly:

   subroutine dlaed9 (integer k, integer kstart, integer kstop, integer n,
       double precision, dimension( * ) d, double precision, dimension( ldq, *
       ) q, integer ldq, double precision rho, double precision, dimension( * )
       dlambda, double precision, dimension( * ) w, double precision,
       dimension( lds, * ) s, integer lds, integer info)

DLAED9 is used by DSTEDC. It finds the roots of the secular equation and updates the eigenvectors. Used when the original matrix is dense. ๐Ÿ’–

๐Ÿ’ซ Purpose ๐Ÿ’ซ

Okay so DLAED9 finds the roots of the secular equation โ€” the one defined by the values in D, Z, and RHO โ€” between KSTART and KSTOP. It makes the appropriate calls to DLAED4, then stores the new matrix of eigenvectors for use in calculating the next level of Z vectors. Literally the glow-up pipeline. โœจ

๐ŸŽ€ Parameters ๐ŸŽ€

  • K โ€” K is INTEGER; the number of terms in the rational function to be solved by DLAED4. K >= 0. ๐Ÿงฎ
  • KSTART โ€” KSTART is INTEGER.
  • KSTOP โ€” KSTOP is INTEGER; the updated eigenvalues Lambda(I), KSTART <= I <= KSTOP, are to be computed. 1 <= KSTART <= KSTOP <= K.
  • N โ€” N is INTEGER; the number of rows and columns in the Q matrix. N >= K (delation may result in N > K). ๐Ÿซถ
  • D โ€” D is DOUBLE PRECISION array, dimension (N); D(I) contains the updated eigenvalues for KSTART <= I <= KSTOP.
  • Q โ€” Q is DOUBLE PRECISION array, dimension (LDQ,N).
  • LDQ โ€” LDQ is INTEGER; the leading dimension of the array Q. LDQ >= max( 1, N ).
  • RHO โ€” RHO is DOUBLE PRECISION; the value of the parameter in the rank one update equation. RHO >= 0 required. ๐Ÿ’…
  • DLAMBDA โ€” DLAMBDA is DOUBLE PRECISION array, dimension (K); the first K elements of this array contain the old roots of the deflated updating problem. These are the poles of the secular equation. ๐ŸŒ€
  • W โ€” W is DOUBLE PRECISION array, dimension (K); the first K elements of this array contain the components of the deflation-adjusted updating vector.
  • S โ€” S is DOUBLE PRECISION array, dimension (LDS, K); will contain the eigenvectors of the repaired matrix which will be stored for subsequent Z vector calculation and multiplied by the previously accumulated eigenvectors to update the system. โœจ
  • LDS โ€” LDS is INTEGER; the leading dimension of S. LDS >= max( 1, K ).
  • INFO โ€” INFO is INTEGER; = 0: successful exit. < 0: if INFO = -i, the i-th argument had an illegal value. > 0: if INFO = 1, an eigenvalue did not converge. ๐Ÿ’€

๐Ÿ‘‘ Author ๐Ÿ‘‘

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

๐Ÿซถ Contributors: ๐Ÿซถ

Jeff Rutter, Computer Science Division, University of California at Berkeley, USA.

Definition at line 154 of file dlaed9.f.

๐ŸŒธ Author ๐ŸŒธ

Generated automatically by Doxygen for LAPACK from the source code.


Cute footer sign-off, bestie: LAPACK Version 3.12.0, source SRC/dlaed9.f(3), and the date slot is blank on this page โ€” no invented dates, just vibes. ๐Ÿ’–๐ŸŽ€

๐Ÿ“ฆ where this page comes from