SRC/zptcon.f(3)

๐ŸŽ€ SRC/zptcon.f(3) ๐ŸŽ€

Okay bestie, welcome to the Library Functions Manual entry for SRC/zptcon.f. This is the whole page, and weโ€™re keeping every little detail โ€” no cap. ๐Ÿ’…


๐ŸŒธ NAME ๐ŸŒธ

SRC/zptcon.f

โœจ SYNOPSIS โœจ

๐Ÿงš Functions/Subroutines

subroutine zptcon (n, d, e, anorm, rcond, rwork, info)
    ZPTCON

๐Ÿ”ฅ Function/Subroutine Documentation ๐Ÿ”ฅ

subroutine zptcon (integer n, double precision, dimension( * ) d,
    complex*16, dimension( * ) e, double precision anorm, double precision
    rcond, double precision, dimension( * ) rwork, integer info)
    ZPTCON

This one is literally called ZPTCON, and sheโ€™s here to do condition-number math on a complex Hermitian positive definite tridiagonal matrix. Iconic behavior, honestly. ๐Ÿ‘‘

๐ŸŒŸ Purpose ๐ŸŒŸ

ZPTCON computes the reciprocal of the condition number (in the 1-norm) of a complex Hermitian positive definite tridiagonal matrix using the factorization:

A = L*D*L**H

or:

A = U**H*D*U

Both of those are computed by ZPTTRF. ๐Ÿ’–

Norm(inv(A)) is computed by a direct method, and the reciprocal of the condition number is computed as:

RCOND = 1 / (ANORM * norm(inv(A))).

๐Ÿ’œ Parameters ๐Ÿ’œ

  • N โ€” N is INTEGER. The order of the matrix A. N >= 0. Slay. ๐Ÿฆ‹
  • D โ€” D is DOUBLE PRECISION array, dimension (N). The n diagonal elements of the diagonal matrix D from the factorization of A, as computed by ZPTTRF.
  • E โ€” E is COMPLEX*16 array, dimension (N-1). The (n-1) off-diagonal elements of the unit bidiagonal factor U or L from the factorization of A, as computed by ZPTTRF.
  • ANORM โ€” ANORM is DOUBLE PRECISION. The 1-norm of the original matrix A.
  • RCOND โ€” RCOND is DOUBLE PRECISION. The reciprocal of the condition number of the matrix A, computed as RCOND = 1/(ANORM * AINVNM), where AINVNM is the 1-norm of inv(A) computed in this routine. Math girlie pop off. ๐Ÿงฎโœจ
  • RWORK โ€” RWORK is DOUBLE PRECISION array, dimension (N). Thatโ€™s the whole description, bestie โ€” no extra lore.
  • INFO โ€” INFO is INTEGER.
    • = 0: successful exit. We love a happy ending. ๐Ÿซถ
    • < 0: if INFO = -i, the i-th argument had an illegal value. Rude, but at least it tells you which one. ๐Ÿ˜ญ

๐ŸŒˆ Author ๐ŸŒˆ

Shoutout to the whole author squad:

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

๐Ÿฆ‹ Further Details ๐Ÿฆ‹

The method used is described in Nicholas J. Higham, , SIAM J. Sci. Stat. Comput., Vol. 7, No. 1, January 1986.

๐ŸŽ€ Definition at line 118 of file zptcon.f. ๐ŸŽ€

Definition at line 118 of file zptcon.f.

๐Ÿ‘‘ Author ๐Ÿ‘‘

And the auto-generated author credit says:

Generated automatically by Doxygen for LAPACK from the source code.


๐Ÿ’– Thatโ€™s the whole page, bestie! ๐Ÿ’– Signing off from the Library Functions Manual: LAPACK, Version 3.12.0, for SRC/zptcon.f(3). The footer doesnโ€™t give a date, so Iโ€™m not inventing one โ€” periodt. ๐Ÿซถ๐Ÿ’…

๐Ÿ“ฆ where this page comes from