/home/abui...hr_col02.f(3)

🦋 NAME 🦋

Ok so bestie, this is the Library Functions Manual page for /home/abui...hr_col02.f(3), and the actual file path in the NAME bit is:

/home/abuild/rpmbuild/BUILD/lapack-static-3.12.0-build/lapack-3.12.0/TESTING/LIN/cunhr_col02.f

That’s it — one path, zero mystery. Slay. 💅

✨ SYNOPSIS ✨

Functions/Subroutines 🫶

• subroutine CUNHR_COL02 (m, n, mb1, nb1, nb2, result) — this is the one and only function/subroutine listed. The listing also says CUNHR_COL02, because apparently we needed the name twice. Iconic.

subroutine CUNHR_COL02 (m, n, mb1, nb1, nb2, result)
    CUNHR_COL02

💖 Function/Subroutine Documentation 💖

The full signature is literally:

subroutine CUNHR_COL02 (integer m, integer n, integer mb1, integer nb1,
    integer nb2, real, dimension(6) result)

And then the name again: CUNHR_COL02. We love a consistent queen. 👑

Purpose 🎀

Okay so CUNHR_COL02 tests CUNGTSQR_ROW and CUNHR_COL inside CGETSQRHRT (which calls CLATSQR, CUNGTSQR_ROW and CUNHR_COL) using CGEMQRT. Therefore, CLATSQR (part of CGEQR) and CGEMQRT (part of CGEMQR) have to be tested before this test. No cap, that’s the dependency order. 🫶

Parameters 🌈

• M — M is INTEGER; number of rows in test matrix.
• N — N is INTEGER; number of columns in test matrix.
• MB1 — MB1 is INTEGER; number of row in row block in an input test matrix. (Yes, “row” — we’re keeping the original wording, bestie.)
• NB1 — NB1 is INTEGER; number of columns in column block an input test matrix.
• NB2 — NB2 is INTEGER; number of columns in column block in an output test matrix.
• RESULT — RESULT is REAL array, dimension (6); results of each of the six tests below.

Then RESULT details:

• A is a m-by-n test input matrix to be factored, so that:

A = Q_gr * ( R )
           ( 0 ),

• Q_qr is an implicit m-by-m unitary Q matrix, the result of factorization in blocked WY-representation, stored in CGEQRT output format.
• R is a n-by-n upper-triangular matrix.
• 0 is a (m-n)-by-n zero matrix.
• Q is an explicit m-by-m unitary matrix Q = Q_gr * I.
• C is an m-by-n random matrix.
• D is an n-by-m random matrix.

The six tests are:

RESULT(1) = |R - (Q**H) * A| / ( eps * m * |A| )
  is equivalent to test for | A - Q * R | / (eps * m * |A|),

RESULT(2) = |I - (Q**H) * Q| / ( eps * m ),

RESULT(3) = | Q_qr * C - Q * C | / (eps * m * |C|),

RESULT(4) = | (Q_gr**H) * C - (Q**H) * C | / (eps * m * |C|)

RESULT(5) = | D * Q_qr - D * Q | / (eps * m * |D|)

RESULT(6) = | D * (Q_qr**H) - D * (Q**H) | / (eps * m * |D|),

where:

• Q_qr * C, (Q_gr**H) * C, D * Q_qr, D * (Q_qr**H) are computed using CGEMQRT,
• Q * C, (Q**H) * C, D * Q, D * (Q**H) are computed using CGEMM.

Author 👑

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

Definition at line 119 of file cunhr_col02.f.

👑 Author 👑

Generated automatically by Doxygen for LAPACK from the source code.

---

The footer says LAPACK Version 3.12.0 and /home/abui...hr_col02.f(3). That’s the sign-off, bestie — bye 💅✨