gelqt3#

Functions

void sgelqt3(
    const INT           m,
    const INT           n,
          f32* restrict A,
    const INT           lda,
          f32* restrict T,
    const INT           ldt,
          INT*          info
);
void sgelqt3(const INT m, const INT n, f32 *restrict A, const INT lda, f32 *restrict T, const INT ldt, INT *info)#

SGELQT3 recursively computes a LQ factorization of a real M-by-N matrix A, using the compact WY representation of Q.

Based on the algorithm of Elmroth and Gustavson, IBM J. Res. Develop. Vol 44 No. 4 July 2000.

The matrix V stores the elementary reflectors H(i) in the i-th row above the diagonal. For example, if M=5 and N=3, the matrix V is 

         V = (  1  v1 v1 v1 v1 )
             (     1  v2 v2 v2 )
             (     1  v3 v3 v3 )
where the vi’s represent the vectors which define H(i), which are returned in the matrix A. The 1’s along the diagonal of V are not stored in A. The block reflector H is then given by 
         H = I - V * T * V**T
where V**T is the transpose of V.

Parameters

in
m

The number of rows of the matrix A. m <= n.

in
n

The number of columns of the matrix A. n >= 0.

inout
A

Double precision array, dimension (lda, n). On entry, the real M-by-N matrix A. On exit, the elements on and below the diagonal contain the M-by-M lower triangular matrix L; the elements above the diagonal are the rows of V.

in
lda

The leading dimension of the array A. lda >= max(1, m).

out
T

Double precision array, dimension (ldt, m). The M-by-M upper triangular factor of the block reflector. The elements on and above the diagonal contain the block reflector T; the elements below the diagonal are not used.

in
ldt

The leading dimension of the array T. ldt >= max(1, m).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value.

Functions

void dgelqt3(
    const INT           m,
    const INT           n,
          f64* restrict A,
    const INT           lda,
          f64* restrict T,
    const INT           ldt,
          INT*          info
);
void dgelqt3(const INT m, const INT n, f64 *restrict A, const INT lda, f64 *restrict T, const INT ldt, INT *info)#

DGELQT3 recursively computes a LQ factorization of a real M-by-N matrix A, using the compact WY representation of Q.

Based on the algorithm of Elmroth and Gustavson, IBM J. Res. Develop. Vol 44 No. 4 July 2000.

The matrix V stores the elementary reflectors H(i) in the i-th row above the diagonal. For example, if M=5 and N=3, the matrix V is 

         V = (  1  v1 v1 v1 v1 )
             (     1  v2 v2 v2 )
             (     1  v3 v3 v3 )
where the vi’s represent the vectors which define H(i), which are returned in the matrix A. The 1’s along the diagonal of V are not stored in A. The block reflector H is then given by 
         H = I - V * T * V**T
where V**T is the transpose of V.

Parameters

in
m

The number of rows of the matrix A. m <= n.

in
n

The number of columns of the matrix A. n >= 0.

inout
A

Double precision array, dimension (lda, n). On entry, the real M-by-N matrix A. On exit, the elements on and below the diagonal contain the M-by-M lower triangular matrix L; the elements above the diagonal are the rows of V.

in
lda

The leading dimension of the array A. lda >= max(1, m).

out
T

Double precision array, dimension (ldt, m). The M-by-M upper triangular factor of the block reflector. The elements on and above the diagonal contain the block reflector T; the elements below the diagonal are not used.

in
ldt

The leading dimension of the array T. ldt >= max(1, m).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value.

Functions

void cgelqt3(
    const INT           m,
    const INT           n,
          c64* restrict A,
    const INT           lda,
          c64* restrict T,
    const INT           ldt,
          INT*          info
);
void cgelqt3(const INT m, const INT n, c64 *restrict A, const INT lda, c64 *restrict T, const INT ldt, INT *info)#

CGELQT3 recursively computes a LQ factorization of a complex M-by-N matrix A, using the compact WY representation of Q.

Based on the algorithm of Elmroth and Gustavson, IBM J. Res. Develop. Vol 44 No. 4 July 2000.

The matrix V stores the elementary reflectors H(i) in the i-th row above the diagonal. For example, if M=5 and N=3, the matrix V is 

         V = (  1  v1 v1 v1 v1 )
             (     1  v2 v2 v2 )
             (     1  v3 v3 v3 )
where the vi’s represent the vectors which define H(i), which are returned in the matrix A. The 1’s along the diagonal of V are not stored in A. The block reflector H is then given by 
         H = I - V * T * V**H
where V**H is the conjugate transpose of V.

Parameters

in
m

The number of rows of the matrix A. m <= n.

in
n

The number of columns of the matrix A. n >= 0.

inout
A

Complex*16 array, dimension (lda, n). On entry, the complex M-by-N matrix A. On exit, the elements on and below the diagonal contain the M-by-M lower triangular matrix L; the elements above the diagonal are the rows of V.

in
lda

The leading dimension of the array A. lda >= max(1, m).

out
T

Complex*16 array, dimension (ldt, m). The M-by-M upper triangular factor of the block reflector. The elements on and above the diagonal contain the block reflector T; the elements below the diagonal are not used.

in
ldt

The leading dimension of the array T. ldt >= max(1, m).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value.

Functions

void zgelqt3(
    const INT            m,
    const INT            n,
          c128* restrict A,
    const INT            lda,
          c128* restrict T,
    const INT            ldt,
          INT*           info
);
void zgelqt3(const INT m, const INT n, c128 *restrict A, const INT lda, c128 *restrict T, const INT ldt, INT *info)#

ZGELQT3 recursively computes a LQ factorization of a complex M-by-N matrix A, using the compact WY representation of Q.

Based on the algorithm of Elmroth and Gustavson, IBM J. Res. Develop. Vol 44 No. 4 July 2000.

The matrix V stores the elementary reflectors H(i) in the i-th row above the diagonal. For example, if M=5 and N=3, the matrix V is 

         V = (  1  v1 v1 v1 v1 )
             (     1  v2 v2 v2 )
             (     1  v3 v3 v3 )
where the vi’s represent the vectors which define H(i), which are returned in the matrix A. The 1’s along the diagonal of V are not stored in A. The block reflector H is then given by 
         H = I - V * T * V**H
where V**H is the conjugate transpose of V.

Parameters

in
m

The number of rows of the matrix A. m <= n.

in
n

The number of columns of the matrix A. n >= 0.

inout
A

Complex*16 array, dimension (lda, n). On entry, the complex M-by-N matrix A. On exit, the elements on and below the diagonal contain the M-by-M lower triangular matrix L; the elements above the diagonal are the rows of V.

in
lda

The leading dimension of the array A. lda >= max(1, m).

out
T

Complex*16 array, dimension (ldt, m). The M-by-M upper triangular factor of the block reflector. The elements on and above the diagonal contain the block reflector T; the elements below the diagonal are not used.

in
ldt

The leading dimension of the array T. ldt >= max(1, m).

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value.