TESTING/MATGEN/clagge.f(3)

📦
version 3.12.1 · 3 versions
, in arch rolling

💖 NAME 💖

TESTING/MATGEN/clagge.f — okay bestie, this whole page is about the TESTING/MATGEN/clagge.f file from the LAPACK manual. It's giving clagge subroutine energy, and we're about to get into every single detail together. No cap. 💅

🌸 SYNOPSIS 🌸

✨ Functions/Subroutines ✨

  • subroutine clagge (m, n, kl, ku, d, a, lda, iseed, work, info) — the CLAGGE subroutine, front and center. 👑

🫶 Function/Subroutine Documentation 🫶

subroutine clagge (integer m, integer n, integer kl, integer ku, real,
     dimension( * ) d, complex, dimension( lda, * ) a, integer lda, integer,
     dimension( 4 ) iseed, complex, dimension( * ) work, integer info)

CLAGGE — yes, that's the name of the game, and she's iconic. 👑

🎀 Purpose 🎀

Okay so listen: CLAGGE generates a complex general m by n matrix A, by pre- and post-multiplying a real diagonal matrix D with random unitary matrices:

A = U*D*V

The lower and upper bandwidths may then be reduced to kl and ku by additional unitary transformations. That's the whole glow-up. ✨

💅 Parameters 💅

M

  • M — M is INTEGER. The number of rows of the matrix A. M >= 0.

N

  • N — N is INTEGER. The number of columns of the matrix A. N >= 0.

KL

  • KL — KL is INTEGER. The number of nonzero subdiagonals within the band of A. 0 <= KL <= M-1.

KU

  • KU — KU is INTEGER. The number of nonzero superdiagonals within the band of A. 0 <= KU <= N-1.

D

  • D — D is REAL array, dimension (min(M,N)). The diagonal elements of the diagonal matrix D.

A

  • A — A is COMPLEX array, dimension (LDA,N). The generated m by n matrix A.

LDA

  • LDA — LDA is INTEGER. The leading dimension of the array A. LDA >= M.

ISEED

  • 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. 🎲

WORK

  • WORK — WORK is COMPLEX array, dimension (M+N).

INFO

  • 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 113 of file clagge.f.

🌈 Author 🌈

Generated automatically by Doxygen for LAPACK from the source code.

okay bestie, that's the whole page — source/version check: LAPACK Version 3.12.0, page: TESTING/MATGEN/clagge.f(3). Stay iconic, and may your matrices be perfectly, randomly, unitarily slay 💜✨

📦 where this page comes from