CLASET(3)

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

🌸 CLASET(3) β€” NAME 🌸

Okay bestie, welcome to CLASET(3) from the Library Functions Manual β€” she’s a LAPACK function and she’s about to make your matrix look exactly how you want πŸ’…βœ¨

The official file path for this page is /home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/SRC/claset.f.

✨ SYNOPSIS ✨

This one lives under Functions/Subroutines, and the call looks like this:

subroutine CLASET (uplo, m, n, alpha, beta, a, lda)

And what does she do? CLASET initializes the off-diagonal elements and the diagonal elements of a matrix to given values. Periodt. πŸ’–

πŸ’« Function/Subroutine Documentation πŸ’«

Here’s the full signature, bestie β€” every type and dimension exactly where it belongs:

subroutine CLASET (character uplo, integer m, integer n, complex alpha,
       complex beta, complex, dimension( lda, * ) a, integer lda)

Again, the vibe: CLASET initializes the off-diagonal elements and the diagonal elements of a matrix to given values. 🫢

πŸŽ€ Purpose πŸŽ€

The source says it like this, and I’m keeping it verbatim because she’s iconic:

!>
!> CLASET initializes a 2-D array A to BETA on the diagonal and
!> ALPHA on the offdiagonals.
!>

So yes: diagonal gets BETA, off-diagonals get ALPHA. It’s giving β€œcontrolled chaos, but make it linear algebra.” 😭πŸ”₯

🧚 Parameters 🧚

  • UPLO β€” CHARACTER*1. This tells her which part of matrix A to set. = 'U': the upper triangular part is set, and the lower triangle is unchanged. = 'L': the lower triangular part is set, and the upper triangle is unchanged. Otherwise: all of matrix A is set. Slay, flexible queen. πŸ‘‘
  • M β€” INTEGER. On entry, M specifies the number of rows of A.
  • N β€” INTEGER. On entry, N specifies the number of columns of A.
  • ALPHA β€” COMPLEX. All the offdiagonal array elements are set to ALPHA.
  • BETA β€” COMPLEX. All the diagonal array elements are set to BETA.
  • A β€” COMPLEX array, dimension (LDA,N). On entry, the m by n matrix A. On exit, the exact formula is:
On exit, A(i,j) = ALPHA, 1 <= i <= m, 1 <= j <= n, i.ne.j;
         A(i,i) = BETA , 1 <= i <= min(m,n)

That means off-diagonals become ALPHA, and diagonals become BETA up to min(m,n). No cap, that’s just the math. πŸ¦‹

  • LDA β€” INTEGER. The leading dimension of the array A. LDA >= max(1,M).
bestie, LDA >= max(1,M) is not a suggestion, it’s the rule. πŸ’€

πŸ‘‘ Author πŸ‘‘

This subroutine is brought to you by:

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

She’s defined at line 105 of file claset.f. πŸ“

🌈 Author 🌈

This page was generated automatically by Doxygen for LAPACK from the source code. πŸ€–πŸ’–


Okay bestie, that’s the whole page. Signing off with LAPACK Version 3.12.0 and the footer path /home/abui...RC/claset.f(3) β€” mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from