tpttr(3)

📦
version 3.12.1 · 9 versions
, in arch rolling

✨ tpttr — triangular matrix glow-up: packed (tp) ➡️ full (tr) ✨

okay bestie, so this is tpttr(3) from the Library Functions Manual, and it's literally the makeover page for triangular matrices 💅 like, we're taking a matrix that's been living its compact packed life and giving it the full, roomy, main-character layout. same numbers, way more space. no cap.

🎀 SYNOPSIS 🎀

🌸 Functions 🌸

  • subroutine ctpttr (uplo, n, ap, a, lda, info) — CTPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).
  • subroutine dtpttr (uplo, n, ap, a, lda, info) — DTPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).
  • subroutine stpttr (uplo, n, ap, a, lda, info) — STPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).
  • subroutine ztpttr (uplo, n, ap, a, lda, info) — ZTPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).

💖 Detailed Description 💖

so yeah, this whole page is about Function Documentation — four subroutines, four precision flavours, one job: unpack a triangular matrix into its full form. it's giving "same girl, new outfit" 🦋

🌈 Function Documentation 🌈

💜 subroutine ctpttr (character uplo, integer n, complex, dimension( * ) ap, complex, dimension( lda, * ) a, integer lda, integer info)

CTPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).

⭐ Purpose:

!>
!> CTPTTR copies a triangular matrix A from standard packed format (TP)
!> to standard full format (TR).
!>

🌸 Parameters 🌸

  • UPLO
!>          UPLO is CHARACTER*1
!>          = 'U':  A is upper triangular.
!>          = 'L':  A is lower triangular.
!>
  • N
!>          N is INTEGER
!>          The order of the matrix A. N >= 0.
!>
  • AP
!>          AP is COMPLEX array, dimension ( N*(N+1)/2 ),
!>          On entry, the upper or lower triangular matrix A, packed
!>          columnwise in a linear array. The j-th column of A is stored
!>          in the array AP as follows:
!>          if UPLO = 'U', AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
!>          if UPLO = 'L', AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
!>
  • A
!>          A is COMPLEX array, dimension ( LDA, N )
!>          On exit, the triangular matrix A.  If UPLO = 'U', the leading
!>          N-by-N upper triangular part of A contains the upper
!>          triangular part of the matrix A, and the strictly lower
!>          triangular part of A is not referenced.  If UPLO = 'L', the
!>          leading N-by-N lower triangular part of A contains the lower
!>          triangular part of the matrix A, and the strictly upper
!>          triangular part of A is not referenced.
!>
  • LDA
!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,N).
!>
  • INFO
!>          INFO is INTEGER
!>          = 0:  successful exit
!>          < 0:  if INFO = -i, the i-th argument had an illegal value
!>

👑 Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 103 of file ctpttr.f.

💙 subroutine dtpttr (character uplo, integer n, double precision, dimension( * ) ap, double precision, dimension( lda, * ) a, integer lda, integer info)

DTPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).

⭐ Purpose:

!>
!> DTPTTR copies a triangular matrix A from standard packed format (TP)
!> to standard full format (TR).
!>

🌸 Parameters 🌸

  • UPLO
!>          UPLO is CHARACTER*1
!>          = 'U':  A is upper triangular.
!>          = 'L':  A is lower triangular.
!>
  • N
!>          N is INTEGER
!>          The order of the matrix A. N >= 0.
!>
  • AP
!>          AP is DOUBLE PRECISION array, dimension ( N*(N+1)/2 ),
!>          On entry, the upper or lower triangular matrix A, packed
!>          columnwise in a linear array. The j-th column of A is stored
!>          in the array AP as follows:
!>          if UPLO = 'U', AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
!>          if UPLO = 'L', AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
!>
  • A
!>          A is DOUBLE PRECISION array, dimension ( LDA, N )
!>          On exit, the triangular matrix A.  If UPLO = 'U', the leading
!>          N-by-N upper triangular part of A contains the upper
!>          triangular part of the matrix A, and the strictly lower
!>          triangular part of A is not referenced.  If UPLO = 'L', the
!>          leading N-by-N lower triangular part of A contains the lower
!>          triangular part of the matrix A, and the strictly upper
!>          triangular part of A is not referenced.
!>
  • LDA
!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,N).
!>
  • INFO
!>          INFO is INTEGER
!>          = 0:  successful exit
!>          < 0:  if INFO = -i, the i-th argument had an illegal value
!>

👑 Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 103 of file dtpttr.f.

💚 subroutine stpttr (character uplo, integer n, real, dimension( * ) ap, real, dimension( lda, * ) a, integer lda, integer info)

STPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).

⭐ Purpose:

!>
!> STPTTR copies a triangular matrix A from standard packed format (TP)
!> to standard full format (TR).
!>

🌸 Parameters 🌸

  • UPLO
!>          UPLO is CHARACTER*1
!>          = 'U':  A is upper triangular.
!>          = 'L':  A is lower triangular.
!>
  • N
!>          N is INTEGER
!>          The order of the matrix A. N >= 0.
!>
  • AP
!>          AP is REAL array, dimension ( N*(N+1)/2 ),
!>          On entry, the upper or lower triangular matrix A, packed
!>          columnwise in a linear array. The j-th column of A is stored
!>          in the array AP as follows:
!>          if UPLO = 'U', AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
!>          if UPLO = 'L', AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
!>
  • A
!>          A is REAL array, dimension ( LDA, N )
!>          On exit, the triangular matrix A.  If UPLO = 'U', the leading
!>          N-by-N upper triangular part of A contains the upper
!>          triangular part of the matrix A, and the strictly lower
!>          triangular part of A is not referenced.  If UPLO = 'L', the
!>          leading N-by-N lower triangular part of A contains the lower
!>          triangular part of the matrix A, and the strictly upper
!>          triangular part of A is not referenced.
!>
  • LDA
!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,N).
!>
  • INFO
!>          INFO is INTEGER
!>          = 0:  successful exit
!>          < 0:  if INFO = -i, the i-th argument had an illegal value
!>

👑 Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 103 of file stpttr.f.

💛 subroutine ztpttr (character uplo, integer n, complex*16, dimension( * ) ap, complex*16, dimension( lda, * ) a, integer lda, integer info)

ZTPTTR copies a triangular matrix from the standard packed format (TP) to the standard full format (TR).

⭐ Purpose:

!>
!> ZTPTTR copies a triangular matrix A from standard packed format (TP)
!> to standard full format (TR).
!>

🌸 Parameters 🌸

  • UPLO
!>          UPLO is CHARACTER*1
!>          = 'U':  A is upper triangular.
!>          = 'L':  A is lower triangular.
!>
  • N
!>          N is INTEGER
!>          The order of the matrix A. N >= 0.
!>
  • AP
!>          AP is COMPLEX*16 array, dimension ( N*(N+1)/2 ),
!>          On entry, the upper or lower triangular matrix A, packed
!>          columnwise in a linear array. The j-th column of A is stored
!>          in the array AP as follows:
!>          if UPLO = 'U', AP(i + (j-1)*j/2) = A(i,j) for 1<=i<=j;
!>          if UPLO = 'L', AP(i + (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
!>
  • A
!>          A is COMPLEX*16 array, dimension ( LDA, N )
!>          On exit, the triangular matrix A.  If UPLO = 'U', the leading
!>          N-by-N upper triangular part of A contains the upper
!>          triangular part of the matrix A, and the strictly lower
!>          triangular part of A is not referenced.  If UPLO = 'L', the
!>          leading N-by-N lower triangular part of A contains the lower
!>          triangular part of the matrix A, and the strictly upper
!>          triangular part of A is not referenced.
!>
  • LDA
!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,N).
!>
  • INFO
!>          INFO is INTEGER
!>          = 0:  successful exit
!>          < 0:  if INFO = -i, the i-th argument had an illegal value
!>

👑 Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 103 of file ztpttr.f.

🫶 Author 🫶

Generated automatically by Doxygen for LAPACK from the source code. (yes bestie, the docs wrote themselves — iconic behaviour honestly 💅✨)

and that's the whole page, fr fr 🎀 one last thing — this gem is from LAPACK, Version 3.12.0, under the tpttr(3) entry. go unpack those triangles, you absolute star 🌟👑

📦 where this page comes from