LAPACK 3.3.0

zgeqr2.f

Go to the documentation of this file.
00001       SUBROUTINE ZGEQR2( M, N, A, LDA, TAU, WORK, INFO )
00002 *
00003 *  -- LAPACK routine (version 3.2.2) --
00004 *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
00005 *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
00006 *     June 2010
00007 *
00008 *     .. Scalar Arguments ..
00009       INTEGER            INFO, LDA, M, N
00010 *     ..
00011 *     .. Array Arguments ..
00012       COMPLEX*16         A( LDA, * ), TAU( * ), WORK( * )
00013 *     ..
00014 *
00015 *  Purpose
00016 *  =======
00017 *
00018 *  ZGEQR2 computes a QR factorization of a complex m by n matrix A:
00019 *  A = Q * R.
00020 *
00021 *  Arguments
00022 *  =========
00023 *
00024 *  M       (input) INTEGER
00025 *          The number of rows of the matrix A.  M >= 0.
00026 *
00027 *  N       (input) INTEGER
00028 *          The number of columns of the matrix A.  N >= 0.
00029 *
00030 *  A       (input/output) COMPLEX*16 array, dimension (LDA,N)
00031 *          On entry, the m by n matrix A.
00032 *          On exit, the elements on and above the diagonal of the array
00033 *          contain the min(m,n) by n upper trapezoidal matrix R (R is
00034 *          upper triangular if m >= n); the elements below the diagonal,
00035 *          with the array TAU, represent the unitary matrix Q as a
00036 *          product of elementary reflectors (see Further Details).
00037 *
00038 *  LDA     (input) INTEGER
00039 *          The leading dimension of the array A.  LDA >= max(1,M).
00040 *
00041 *  TAU     (output) COMPLEX*16 array, dimension (min(M,N))
00042 *          The scalar factors of the elementary reflectors (see Further
00043 *          Details).
00044 *
00045 *  WORK    (workspace) COMPLEX*16 array, dimension (N)
00046 *
00047 *  INFO    (output) INTEGER
00048 *          = 0: successful exit
00049 *          < 0: if INFO = -i, the i-th argument had an illegal value
00050 *
00051 *  Further Details
00052 *  ===============
00053 *
00054 *  The matrix Q is represented as a product of elementary reflectors
00055 *
00056 *     Q = H(1) H(2) . . . H(k), where k = min(m,n).
00057 *
00058 *  Each H(i) has the form
00059 *
00060 *     H(i) = I - tau * v * v'
00061 *
00062 *  where tau is a complex scalar, and v is a complex vector with
00063 *  v(1:i-1) = 0 and v(i) = 1; v(i+1:m) is stored on exit in A(i+1:m,i),
00064 *  and tau in TAU(i).
00065 *
00066 *  =====================================================================
00067 *
00068 *     .. Parameters ..
00069       COMPLEX*16         ONE
00070       PARAMETER          ( ONE = ( 1.0D+0, 0.0D+0 ) )
00071 *     ..
00072 *     .. Local Scalars ..
00073       INTEGER            I, K
00074       COMPLEX*16         ALPHA
00075 *     ..
00076 *     .. External Subroutines ..
00077       EXTERNAL           XERBLA, ZLARF, ZLARFG
00078 *     ..
00079 *     .. Intrinsic Functions ..
00080       INTRINSIC          DCONJG, MAX, MIN
00081 *     ..
00082 *     .. Executable Statements ..
00083 *
00084 *     Test the input arguments
00085 *
00086       INFO = 0
00087       IF( M.LT.0 ) THEN
00088          INFO = -1
00089       ELSE IF( N.LT.0 ) THEN
00090          INFO = -2
00091       ELSE IF( LDA.LT.MAX( 1, M ) ) THEN
00092          INFO = -4
00093       END IF
00094       IF( INFO.NE.0 ) THEN
00095          CALL XERBLA( 'ZGEQR2', -INFO )
00096          RETURN
00097       END IF
00098 *
00099       K = MIN( M, N )
00100 *
00101       DO 10 I = 1, K
00102 *
00103 *        Generate elementary reflector H(i) to annihilate A(i+1:m,i)
00104 *
00105          CALL ZLARFG( M-I+1, A( I, I ), A( MIN( I+1, M ), I ), 1,
00106      $                TAU( I ) )
00107          IF( I.LT.N ) THEN
00108 *
00109 *           Apply H(i)' to A(i:m,i+1:n) from the left
00110 *
00111             ALPHA = A( I, I )
00112             A( I, I ) = ONE
00113             CALL ZLARF( 'Left', M-I+1, N-I, A( I, I ), 1,
00114      $                  DCONJG( TAU( I ) ), A( I, I+1 ), LDA, WORK )
00115             A( I, I ) = ALPHA
00116          END IF
00117    10 CONTINUE
00118       RETURN
00119 *
00120 *     End of ZGEQR2
00121 *
00122       END
 All Files Functions