TESTING/MATGEN/clarge.f(3)

💜 TESTING/MATGEN/clarge.f 💜

okok so this is a page straight out of the Library Functions Manual (yes, the TESTING/MATGEN/clarge.f one, we love her) and it's literally just one function doing one extremely specific little task. bestie it's giving "tiny but mighty" ✨

---

✨ SYNOPSIS ✨

🎀 Functions/Subroutines

• subroutine clarge (n, a, lda, iseed, work, info) — the one and only, CLARGE herself 👑

---

🌸 Function/Subroutine Documentation 🌸

🦋 the signature, verbatim, no cap

subroutine clarge (integer n, complex, dimension( lda, * ) a, integer lda,
    integer, dimension( 4 ) iseed, complex, dimension( * ) work, integer
    info)

CLARGE 🫶

💫 Purpose:

!>
!> CLARGE pre- and post-multiplies a complex general n by n matrix A
!> with a random unitary matrix: A = U*D*U'.
!>

so basically it takes your matrix and sandwiches it between a random unitary matrix and its conjugate transpose. glow-up via randomization, honestly iconic 💅

🍓 Parameters

• N

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

• A

!>          A is COMPLEX array, dimension (LDA,N)
!>          On entry, the original n by n matrix A.
!>          On exit, A is overwritten by U*A*U' for some random
!>          unitary matrix U.
!>

⚠️ heads up bestie: A gets overwritten on exit. your original matrix is gone-gone, so save a copy if you're attached to her 😭

• LDA

!>          LDA is INTEGER
!>          The leading dimension of the array A.  LDA >= N.
!>

• ISEED

!>          ISEED is INTEGER array, dimension (4)
!>          On entry, the seed of the random number generator; the array
!>          elements must be between 0 and 4095, and ISEED(4) must be
!>          odd.
!>          On exit, the seed is updated.
!>

no fr, ISEED(4) must be odd — that's not a suggestion, that's the vibe check 🔥 and yeah, it gets updated on exit, so don't be surprised when she's different.

• WORK

!>          WORK is COMPLEX array, dimension (2*N)
!>

• INFO

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

INFO = 0 → slay, we're good 💖. INFO < 0 → the i-th argument was illegal, deal with it accordingly 🙈

👑 Author

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

Definition at line 86 of file clarge.f. 📍

---

⭐ Author

Generated automatically by Doxygen for LAPACK from the source code. so nobody hand-wrote this beauty, the machine did it 🧚

---

and that's the whole page, bestie! this was LAPACK, Version 3.12.0 — TESTING/MATGEN/clarge.f(3) — dropping the mic 💅🎀🦋💜