PTTRF - 5.2 English - 68552

AOCL API Guide (68552)

Document ID
68552
Release Date
2025-12-29
Version
5.2 English
template<typename T>
void pttrf(integer *n, T *d, T *e, integer *info)#

PTTRF computes the L*D*L**T factorization of a real symmetric matrix.

Purpose:

  PTTRF computes the L*D*L**T factorization of a real symmetric
  positive definite tridiagonal matrix A.  The factorization may also
  be regarded as having the form A = U**T*D*U.
Parameters:
  • N[in]

    N is INTEGER

    The order of the matrix A. N >= 0.

  • D[inout]

    D is REAL array, dimension (N)

    On entry, the n diagonal elements of the tridiagonal matrix A. On exit, the n diagonal elements of the diagonal matrix D from the L*D*L**T factorization of A.

  • E[inout]

    E is REAL array, dimension (N-1)

    On entry, the (n-1) subdiagonal elements of the tridiagonal matrix A. On exit, the (n-1) subdiagonal elements of the unit bidiagonal factor L from the L*D*L**T factorization of A.

    E can also be regarded as the superdiagonal of the unit bidiagonal factor U from the U**T*D*U factorization of A.
  • INFO[out]

    INFO is INTEGER

    = 0: successful exit

    < 0: if INFO = -k, the k-th argument had an illegal value

    > 0: if INFO = k, the leading minor of order k is not positive definite; if k < N, the factorization could not be completed, while if k = N, the factorization was completed, but D(N) <= 0.

template<typename T, typename Ta>
void pttrf(integer *n, Ta *d, T *e, integer *info)#