ORG2L - 5.2 English - 68552

AOCL API Guide (68552)

Document ID
68552
Release Date
2025-12-29
Version
5.2 English
template<typename T>
void org2l(integer *m, integer *n, integer *k, T *a, integer *lda, T *tau, T *work, integer *info)#

ORG2L generates all or part of the orthogonal matrix Q from a QL factorization determined by sgeqlf.

Purpose:

   ORG2L generates an m by n real matrix Q with orthonormal columns,
   which is defined as the last n columns of a product of k elementary
   reflectors of order m

         Q  =  H(k) . . . H(2) H(1)

   as   returned by GEQLF.
Parameters:
  • M[in]

    M is INTEGER

    The number of rows of the matrix Q. M >= 0.

  • N[in]

    N is INTEGER

    The number of columns of the matrix Q. M >= N >= 0.

  • K[in]

    K is INTEGER

    The number of elementary reflectors whose product defines the matrix Q. N >= K >= 0.

  • A[inout]

    A is REAL array, dimension (LDA,N)

    On entry, the (n-k+i)-th column must contain the vector which defines the elementary reflector H(i), for i = 1,2,…,k, as returned by SGEQLF in the last k columns of its array argument A.

    On exit, the m by n matrix Q.
  • LDA[in]

    LDA is INTEGER

    The first dimension of the array A. LDA >= fla_max(1,M).

  • TAU[in]

    TAU is REAL array, dimension (K)

    TAU(i) must contain the scalar factor of the elementary reflector H(i), as returned by SGEQLF.

  • WORK[out] WORK is REAL array, dimension (N)

  • INFO[out]

    INFO is INTEGER

    = 0: successful exit

    < 0: if INFO = -i, the i-th argument has an illegal value
template<typename T>
void ung2l(integer *m, integer *n, integer *k, T *a, integer *lda, T *tau, T *work, integer *info)#