SRC/dorgr2.f(3)

πŸ’– NAME πŸ’–

welcome to SRC/dorgr2.f(3), straight out of the Library Functions Manual. bestie, the name is literally SRC/dorgr2.f β€” no cap, that's the whole thing, and this page is here to explain the dorgr2 subroutine.


✨ SYNOPSIS ✨

🧚 Functions/Subroutines 🧚

subroutine dorgr2 (m, n, k, a, lda, tau, work, info)

DORGR2 generates all or part of the orthogonal matrix Q from an RQ factorization determined by sgerqf (unblocked algorithm). okay periodt, that's the official one-liner.


πŸ¦‹ Function/Subroutine Documentation πŸ¦‹

🌸 subroutine dorgr2 🌸

full signature with the types, bestie β€” copy it exactly:

subroutine dorgr2 (integer m, integer n, integer k, double precision,
     dimension( lda, * ) a, integer lda, double precision, dimension( * )
     tau, double precision, dimension( * ) work, integer info)

DORGR2 generates all or part of the orthogonal matrix Q from an RQ factorization determined by sgerqf (unblocked algorithm).

πŸ’… Purpose πŸ’…

the source says it like this, verbatim:

!>
!> DORGR2 generates an m by n real matrix Q with orthonormal rows,
!> which is defined as the last m rows of a product of k elementary
!> reflectors of order n
!>
!>       Q  =  H(1) H(2) . . . H(k)
!>
!> as returned by DGERQF.
!>

so yes: Q is an m by n real matrix, it has orthonormal rows, and it's the last m rows of a product of k elementary reflectors of order n, as returned by DGERQF. iconic behavior, honestly.

πŸŽ€ Parameters πŸŽ€

  • M β€” M is INTEGER. it's the number of rows of the matrix Q, and M >= 0. no cap.
  • N β€” N is INTEGER. it's the number of columns of the matrix Q, and N >= M.
  • K β€” K is INTEGER. it's the number of elementary reflectors whose product defines the matrix Q, and M >= K >= 0.
  • A β€” A is DOUBLE PRECISION array, dimension (LDA,N). on entry, the (m-k+i)-th row must contain the vector which defines the elementary reflector H(i), for i = 1,2,...,k, as returned by DGERQF in the last k rows of its array argument A. on exit, the m by n matrix Q. she's doing a whole transformation, bestie.
  • LDA β€” LDA is INTEGER. it's the first dimension of the array A, and LDA >= max(1,M).
  • TAU β€” TAU is DOUBLE PRECISION array, dimension (K). TAU(i) must contain the scalar factor of the elementary reflector H(i), as returned by DGERQF.
  • WORK β€” WORK is DOUBLE PRECISION array, dimension (M). that's the spec: DOUBLE PRECISION array, dimension (M).
  • INFO β€” INFO is INTEGER. = 0: successful exit. < 0: if INFO = -i, the i-th argument has an illegal value. so if it's negative, check your arguments, bestie.

πŸ‘‘ Author πŸ‘‘

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

πŸ“ Definition at line 113 of file dorgr2.f.


πŸŽ€ Author πŸŽ€

Generated automatically by Doxygen for LAPACK from the source code.


k bye bestie β€” this page is from LAPACK Version 3.12.0 and lives at SRC/dorgr2.f(3). πŸ’…βœ¨

πŸ“¦ where this page comes from