Return to zlapll.f CVS log

Up to [local] / rpl / lapack / lapack

Annotation of rpl/lapack/lapack/zlapll.f, revision 1.6

1.1       bertrand    1:       SUBROUTINE ZLAPLL( N, X, INCX, Y, INCY, SSMIN )
                      2: *
                      3: *  -- LAPACK auxiliary routine (version 3.2) --
                      4: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
                      5: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
                      6: *     November 2006
                      7: *
                      8: *     .. Scalar Arguments ..
                      9:       INTEGER            INCX, INCY, N
                     10:       DOUBLE PRECISION   SSMIN
                     11: *     ..
                     12: *     .. Array Arguments ..
                     13:       COMPLEX*16         X( * ), Y( * )
                     14: *     ..
                     15: *
                     16: *  Purpose
                     17: *  =======
                     18: *
                     19: *  Given two column vectors X and Y, let
                     20: *
                     21: *                       A = ( X Y ).
                     22: *
                     23: *  The subroutine first computes the QR factorization of A = Q*R,
                     24: *  and then computes the SVD of the 2-by-2 upper triangular matrix R.
                     25: *  The smaller singular value of R is returned in SSMIN, which is used
                     26: *  as the measurement of the linear dependency of the vectors X and Y.
                     27: *
                     28: *  Arguments
                     29: *  =========
                     30: *
                     31: *  N       (input) INTEGER
                     32: *          The length of the vectors X and Y.
                     33: *
                     34: *  X       (input/output) COMPLEX*16 array, dimension (1+(N-1)*INCX)
                     35: *          On entry, X contains the N-vector X.
                     36: *          On exit, X is overwritten.
                     37: *
                     38: *  INCX    (input) INTEGER
                     39: *          The increment between successive elements of X. INCX > 0.
                     40: *
                     41: *  Y       (input/output) COMPLEX*16 array, dimension (1+(N-1)*INCY)
                     42: *          On entry, Y contains the N-vector Y.
                     43: *          On exit, Y is overwritten.
                     44: *
                     45: *  INCY    (input) INTEGER
                     46: *          The increment between successive elements of Y. INCY > 0.
                     47: *
                     48: *  SSMIN   (output) DOUBLE PRECISION
                     49: *          The smallest singular value of the N-by-2 matrix A = ( X Y ).
                     50: *
                     51: *  =====================================================================
                     52: *
                     53: *     .. Parameters ..
                     54:       DOUBLE PRECISION   ZERO
                     55:       PARAMETER          ( ZERO = 0.0D+0 )
                     56:       COMPLEX*16         CONE
                     57:       PARAMETER          ( CONE = ( 1.0D+0, 0.0D+0 ) )
                     58: *     ..
                     59: *     .. Local Scalars ..
                     60:       DOUBLE PRECISION   SSMAX
                     61:       COMPLEX*16         A11, A12, A22, C, TAU
                     62: *     ..
                     63: *     .. Intrinsic Functions ..
                     64:       INTRINSIC          ABS, DCONJG
                     65: *     ..
                     66: *     .. External Functions ..
                     67:       COMPLEX*16         ZDOTC
                     68:       EXTERNAL           ZDOTC
                     69: *     ..
                     70: *     .. External Subroutines ..
                     71:       EXTERNAL           DLAS2, ZAXPY, ZLARFG
                     72: *     ..
                     73: *     .. Executable Statements ..
                     74: *
                     75: *     Quick return if possible
                     76: *
                     77:       IF( N.LE.1 ) THEN
                     78:          SSMIN = ZERO
                     79:          RETURN
                     80:       END IF
                     81: *
                     82: *     Compute the QR factorization of the N-by-2 matrix ( X Y )
                     83: *
                     84:       CALL ZLARFG( N, X( 1 ), X( 1+INCX ), INCX, TAU )
                     85:       A11 = X( 1 )
                     86:       X( 1 ) = CONE
                     87: *
                     88:       C = -DCONJG( TAU )*ZDOTC( N, X, INCX, Y, INCY )
                     89:       CALL ZAXPY( N, C, X, INCX, Y, INCY )
                     90: *
                     91:       CALL ZLARFG( N-1, Y( 1+INCY ), Y( 1+2*INCY ), INCY, TAU )
                     92: *
                     93:       A12 = Y( 1 )
                     94:       A22 = Y( 1+INCY )
                     95: *
                     96: *     Compute the SVD of 2-by-2 Upper triangular matrix.
                     97: *
                     98:       CALL DLAS2( ABS( A11 ), ABS( A12 ), ABS( A22 ), SSMIN, SSMAX )
                     99: *
                    100:       RETURN
                    101: *
                    102: *     End of ZLAPLL
                    103: *
                    104:       END