/home/abui.../ssyconv.f(3)

🦋 ssyconv.f — the LAPACK girlies' guide to SSYCONV 🦋

okay bestie so this page is from LAPACK, the Library Functions Manual, and the file it's documenting lives at /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/ssyconv.f. yes that's a whole path, no I'm not typing it twice 💅

---

✨ NAME ✨

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/ssyconv.f — that's the file, that's the name, she's long but she's iconic 🎀

---

🌸 SYNOPSIS 🌸

Functions/Subroutines:

subroutine SSYCONV (uplo, way, n, a, lda, ipiv, e, info)

SSYCONV (yes bestie that's her name, that's literally what she does)

---

👑 Function/Subroutine Documentation 👑

subroutine SSYCONV (character uplo, character way, integer n, real,
    dimension( lda, * ) a, integer lda, integer, dimension( * ) ipiv, real,
    dimension( * ) e, integer info)

SSYCONV 💖

🧚 Purpose

!> !> SSYCONV convert A given by TRF into L and D and vice-versa. !> Get Non-diag elements of D (returned in workspace) and !> apply or reverse permutation done in TRF. !>

okay so literally what that says is: SSYCONV takes the A that TRF handed you and converts it into L and D, or goes the other way around. it grabs the non-diagonal elements of D (those come back in workspace, cute) and it either applies or reverses the permutation that TRF already did. she's giving translator-at-a-group-project energy, honestly 🫶

---

💜 Parameters 💜

• UPLO

!>          UPLO is CHARACTER*1
!>          Specifies whether the details of the factorization are stored
!>          as an upper or lower triangular matrix.
!>          = 'U':  Upper triangular, form is A = U*D*U**T;
!>          = 'L':  Lower triangular, form is A = L*D*L**T.

bestie this is the vibe check ✨ UPLO is a CHARACTER*1 and it tells you whether the factorization details are stored as an upper or lower triangular matrix. 'U' = upper triangular, so the form is A = U*D*U**T. 'L' = lower triangular, so the form is A = L*D*L**T. pick one, no cap 😌

• WAY

!>          WAY is CHARACTER*1
!>          = 'C': Convert
!>          = 'R': Revert

WAY is a CHARACTER*1 and she decides the direction of travel 🛼 'C' = Convert. 'R' = Revert. that's it, that's the whole personality.

• N

!>          N is INTEGER
!>          The order of the matrix A.  N >= 0.

N is an INTEGER and it's the order of the matrix A. literally N >= 0, so no negatives okay? 🙈

• A

!>          A is REAL array, dimension (LDA,N)
!>          The block diagonal matrix D and the multipliers used to
!>          obtain the factor U or L as computed by SSYTRF.

A is a REAL array with dimension (LDA,N) 🍓 she holds the block diagonal matrix D plus the multipliers used to obtain the factor U or L, exactly as computed by SSYTRF. she's carrying a lot, honestly, main character energy.

• LDA

!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= max(1,N).

LDA is an INTEGER, the leading dimension of the array A. and it has to satisfy LDA >= max(1,N) — not optional, that's the rule 💀

• IPIV

!>          IPIV is INTEGER array, dimension (N)
!>          Details of the interchanges and the block structure of D
!>          as determined by SSYTRF.

IPIV is an INTEGER array with dimension (N) 🌈 she's got the details of the interchanges plus the block structure of D, all as determined by SSYTRF. receipts, basically 🧾

• E

!>          E is REAL array, dimension (N)
!>          E stores the supdiagonal/subdiagonal of the symmetric 1-by-1
!>          or 2-by-2 block diagonal matrix D in LDLT.

E is a REAL array with dimension (N) ⭐ and she stores the supdiagonal/subdiagonal of the symmetric 1-by-1 or 2-by-2 block diagonal matrix D in LDLT. yes "supdiagonal" — that's the word, that's what the original says, we respect her 🎀

• INFO

!>          INFO is INTEGER
!>          = 0:  successful exit
!>          < 0:  if INFO = -i, the i-th argument had an illegal value

INFO is an INTEGER and she's your little status bestie 🔥 = 0 means successful exit, we love that for us. < 0 means if INFO = -i, the i-th argument had an illegal value — so go check argument number i, she's the problem 😭

---

🌺 Author 🌺

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

(genuinely a whole friend group of institutions, they ate 💅)

---

🦋 Definition at line 113 of file ssyconv.f. 🦋

Definition at line 113 of file ssyconv.f. — that's where she lives, go look 👀

---

🌈 Author (again) 🌈

Generated automatically by Doxygen for LAPACK from the source code. — yes she was auto-generated by Doxygen for LAPACK straight from the source code, she's a bot but she's a slay bot 🤖✨

---

okay that's the whole page bestie, go forth and factorize responsibly 🫶💖

LAPACK — Version 3.12.0 🌸 /home/abui.../ssyconv.f(3) — mwah, see you in the next man page 💋🍓