TESTING/MATGEN/zlagge.f(3)

📦
version 3.12.1 · 3 versions
, in arch rolling

💖 TESTING/MATGEN/zlagge.f(3) 💖

okay so this page is from the Library Functions Manual, bestie — and it's all about one iconic Fortran subroutine. buckle up. 🦋

💖 NAME 💖

TESTING/MATGEN/zlagge.f — that's the name. periodt. 💅

✨ SYNOPSIS ✨

Functions/Subroutines

       subroutine zlagge (m, n, kl, ku, d, a, lda, iseed, work, info)
           ZLAGGE

🫶 Function/Subroutine Documentation 🫶

   subroutine zlagge (integer m, integer n, integer kl, integer ku, double
       precision, dimension( * ) d, complex*16, dimension( lda, * ) a, integer
       lda, integer, dimension( 4 ) iseed, complex*16, dimension( * ) work,
       integer info)
       ZLAGGE

🎀 Purpose 🎀

okay so ZLAGGE 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 plot. ✨

🌸 Parameters 🌸

  • M — M is INTEGER: the number of rows of matrix A. Constraint: M >= 0. 👑
  • N — N is INTEGER: the number of columns of matrix A. Constraint: N >= 0. 👑
  • KL — KL is INTEGER: the number of nonzero subdiagonals within the band of A. Constraint: 0 <= KL <= M-1. 🎀
  • KU — KU is INTEGER: the number of nonzero superdiagonals within the band of A. Constraint: 0 <= KU <= N-1. 🎀
  • D — D is DOUBLE PRECISION array, dimension (min(M,N)): the diagonal elements of the diagonal matrix D. 💖
  • A — A is COMPLEX*16 array, dimension (LDA,N): the generated m by n matrix A. ✨
  • LDA — LDA is INTEGER: the leading dimension of the array A. Constraint: LDA >= M. 🦋
  • 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 is COMPLEX*16 array, dimension (M+N). 🌈
  • 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 zlagge.f. 📍

🧚 Author 🧚

Generated automatically by Doxygen for LAPACK from the source code. no cap. 🫶

muah 💋 this whole page is brought to you by LAPACK, Version 3.12.0, and the title TESTING/MATGEN/zlagge.f(3). byeee bestie, go generate some iconic matrices. 🌈💜

📦 where this page comes from