SRC/cgeqrf.f(3)
β¨ NAME β¨
okay bestie, this is the SRC/cgeqrf.f(3) page from the Library Functions Manual, and itβs all about one iconic subroutine: cgeqrf. QR factorization but make it complex, periodt. π
π¦ SYNOPSIS π¦
π§ Functions/Subroutines π§
subroutine cgeqrf (m, n, a, lda, tau, work, lwork, info)β the whole call, exactly like that, no cap.CGEQRFβ the label chilling with it.
π Function/Subroutine Documentation π
subroutine cgeqrf (integer m, integer n, complex, dimension( lda, * ) a,
integer lda, complex, dimension( * ) tau, complex, dimension( * ) work,
integer lwork, integer info)
Also labeled CGEQRF. main character subroutine energy. π
π― Purpose π―
CGEQRF computes a QR factorization of a complex M-by-N matrix A:
A = Q * ( R ),
( 0 )
where:
Qis a M-by-M orthogonal matrix;Ris an upper-triangular N-by-N matrix;0is a (M-N)-by-N zero matrix, ifM > N.
πΈ Parameters πΈ
MβMis INTEGER. The number of rows of the matrixA.M >= 0.NβNis INTEGER. The number of columns of the matrixA.N >= 0.AβAis COMPLEX array, dimension(LDA,N). On entry, the M-by-N matrixA. On exit, the elements on and above the diagonal of the array contain themin(M,N)-by-N upper trapezoidal matrixR(Ris upper triangular ifm >= n); the elements below the diagonal, with the arrayTAU, represent the unitary matrixQas a product ofmin(m,n)elementary reflectors (see Further Details).LDAβLDAis INTEGER. The leading dimension of the arrayA.LDA >= max(1,M).TAUβTAUis COMPLEX array, dimension(min(M,N)). The scalar factors of the elementary reflectors (see Further Details).WORKβWORKis COMPLEX array, dimension(MAX(1,LWORK)). On exit, ifINFO = 0,WORK(1)returns the optimalLWORK.LWORKβLWORKis INTEGER. The dimension of the arrayWORK.LWORK >= 1, if MIN(M,N) = 0, and LWORK >= N, otherwise.For optimum performanceLWORK >= N*NB, whereNBis the optimal blocksize. IfLWORK = -1, then a workspace query is assumed; the routine only calculates the optimal size of theWORKarray, returns this value as the first entry of theWORKarray, and no error message related toLWORKis issued byXERBLA.INFOβINFOis INTEGER.= 0: successful exit.< 0: ifINFO = -i, the i-th argument had an illegal value.
π Author π
- Univ. of Tennessee
- Univ. of California Berkeley
- Univ. of Colorado Denver
- NAG Ltd.
π₯ Further Details π₯
The matrix Q is represented as a product of elementary reflectors:
Q = H(1) H(2) . . . H(k), where k = min(m,n).
Each H(i) has the form:
H(i) = I - tau * v * v**H
where tau is a complex scalar, and v is a complex vector with v(1:i-1) = 0 and v(i) = 1; v(i+1:m) is stored on exit in A(i+1:m,i), and tau in TAU(i).
Definition at line 145 of file cgeqrf.f.
π«Ά Author π«Ά
Generated automatically by Doxygen for LAPACK from the source code.
Thatβs the whole page, bestie β footer vibes are LAPACK, Version 3.12.0, and SRC/cgeqrf.f(3). No extra date line, just QR-flavored main character energy. πβ¨π
π¦ where this page comes from
- arch rolling: lapack-doc 3.12.1-2 Β· custom
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms