STRTRI(3)

πŸ“¦ version 3.12.0, in opensuse-leap 16.0

πŸ’… STRTRI(3) β€” the one where we invert a triangular matrix, bestie

okay so before we even get into it, hi, welcome, this page lives at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/strtri.f and it's part of the LAPACK Library Functions Manual and honestly? she's iconic. Let's go. πŸŽ€


✨ SYNOPSIS ✨

Functions/Subroutines

subroutine STRTRI (uplo, diag, n, a, lda, info)

STRTRI β€” that's the whole vibe, that's the name, no notes. πŸ’œ


🌸 Function/Subroutine Documentation 🌸

subroutine STRTRI (character uplo, character diag, integer n, real,
    dimension( lda, * ) a, integer lda, integer info)

STRTRI (yes, again, she contains multitudes πŸ’…)

πŸ¦‹ Purpose

okay so literally what she does:

!>
!> STRTRI computes the inverse of a real upper or lower triangular
!> matrix A.
!>
!> This is the Level 3 BLAS version of the algorithm.
!>

so yeah β€” inverse of a real upper-or-lower triangular matrix A, and she's the Level 3 BLAS version of the algorithm. no cap. ✨

πŸŽ€ Parameters

UPLO

!>          UPLO is CHARACTER*1
!>          = 'U':  A is upper triangular;
!>          = 'L':  A is lower triangular.
!>
  • UPLO is CHARACTER*1 β€” which triangle are we even talking about, bestie:
    • 'U' β€” A is upper triangular πŸ’–
    • 'L' β€” A is lower triangular 🫢

DIAG

!>          DIAG is CHARACTER*1
!>          = 'N':  A is non-unit triangular;
!>          = 'U':  A is unit triangular.
!>
  • DIAG is CHARACTER*1 β€” is the diagonal doing the most or not:
    • 'N' β€” A is non-unit triangular, the diagonal is real and it's doing its job 😀
    • 'U' β€” A is unit triangular, diagonal is assumed to be 1, main character energy 🌟

N

!>          N is INTEGER
!>          The order of the matrix A.  N >= 0.
!>
  • N is INTEGER β€” the order of the matrix A. and like, N >= 0, please. no negative-matrix nonsense here πŸ™ˆ

A

!>          A is REAL array, dimension (LDA,N)
!>          On entry, the triangular matrix A.  If UPLO = 'U', the
!>          leading N-by-N upper triangular part of the array A contains
!>          the upper triangular matrix, and the strictly lower
!>          triangular part of A is not referenced.  If UPLO = 'L', the
!>          leading N-by-N lower triangular part of the array A contains
!>          the lower triangular matrix, and the strictly upper
!>          triangular part of A is not referenced.  If DIAG = 'U', the
!>          diagonal elements of A are also not referenced and are
!>          assumed to be 1.
!>          On exit, the (triangular) inverse of the original matrix, in
!>          the same storage format.
!>
  • A is a REAL array, dimension (LDA,N). On entry it's the triangular matrix A, and the storage rules are giving very specific:
    • if UPLO = 'U' β€” the leading N-by-N upper triangular part of the array A holds the upper triangular matrix, and the strictly lower triangular part of A is not referenced, she's simply ignored πŸ’€
    • if UPLO = 'L' β€” the leading N-by-N lower triangular part of the array A holds the lower triangular matrix, and the strictly upper triangular part of A is not referenced πŸ™ˆ
    • if DIAG = 'U' β€” the diagonal elements of A are also not referenced and are assumed to be 1 ✨
  • On exit β€” the array holds the (triangular) inverse of the original matrix, in the same storage format. slay. πŸ’…

LDA

!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,N).
!>
  • LDA is INTEGER β€” the leading dimension of the array A, and the rule is LDA >= max(1,N). respect the constraint, bestie 🫢

INFO

!>          INFO is INTEGER
!>          = 0: successful exit
!>          < 0: if INFO = -i, the i-th argument had an illegal value
!>          > 0: if INFO = i, A(i,i) is exactly zero.  The triangular
!>               matrix is singular and its inverse can not be computed.
!>
  • INFO is INTEGER β€” the vibe check at the end:
    • = 0 β€” successful exit, we ate, no crumbs 🌈
    • < 0 β€” if INFO = -i, the i-th argument had an illegal value 😭
    • > 0 β€” if INFO = i, A(i,i) is exactly zero. the triangular matrix is singular and its inverse can not be computed. that's it, that's the end, do not pass go 🚨

πŸ‘‘ Author

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

fr fr, STRTRI is defined at line 108 of file strtri.f. you're welcome, iykyk 🧚

🌟 Author

Generated automatically by Doxygen for LAPACK from the source code. she was literally built by a robot and still turned out this cute, obsessed πŸ’–


and that's the page!! this little cutie is from LAPACK, Version 3.12.0, dated /home/abui...RC/strtri.f(3). mwah, bye bestie πŸ’‹βœ¨πŸŒΈ

πŸ“¦ where this page comes from