clanv2.f File Reference

Go to the source code of this file.

Functions/Subroutines
subroutine	clanv2 (a, b, c, d, rt1, rt2, cs, sn)

Function/Subroutine Documentation

clanv2()

subroutine clanv2	(	complex	a,
		complex	b,
		complex	c,
		complex	d,
		complex	rt1,
		complex	rt2,
		real	cs,
		complex	sn )

Definition at line 1 of file clanv2.f.

*
*  -- ScaLAPACK routine (version 1.7) --
*     Univ. of Tennessee, Univ. of California Berkeley, NAG Ltd.,
*     Courant Institute, Argonne National Lab, and Rice University
*     May 28, 1999
*
*     .. Scalar Arguments ..
      REAL               CS
      COMPLEX            A, B, C, D, RT1, RT2, SN
*     ..
*
*  Purpose
*  =======
*
*  CLANV2 computes the Schur factorization of a complex 2-by-2
*  nonhermitian matrix in standard form:
*
*       [ A  B ] = [ CS -SN ] [ AA  BB ] [ CS  SN ]
*       [ C  D ]   [ SN  CS ] [  0  DD ] [-SN  CS ]
*
*  Arguments
*  =========
*
*  A       (input/output) COMPLEX
*  B       (input/output) COMPLEX
*  C       (input/output) COMPLEX
*  D       (input/output) COMPLEX
*          On entry, the elements of the input matrix.
*          On exit, they are overwritten by the elements of the
*          standardised Schur form.
*
*  RT1     (output) COMPLEX
*  RT2     (output) COMPLEX
*          The two eigenvalues.
*
*  CS      (output) REAL
*  SN      (output) COMPLEX
*          Parameters of the rotation matrix.
*
*  Further Details
*  ===============
*
*  Implemented by Mark R. Fahey, May 28, 1999
*
*  =====================================================================
*
*     .. Parameters ..
      REAL               RZERO, HALF, RONE
      parameter( rzero = 0.0e+0, half = 0.5e+0,
     $                   rone = 1.0e+0 )
      COMPLEX            ZERO, ONE
      parameter( zero = ( 0.0e+0, 0.0e+0 ),
     $                   one = ( 1.0e+0, 0.0e+0 ) )
*     ..
*     .. Local Scalars ..
      COMPLEX            AA, BB, DD, T, TEMP, TEMP2, U, X, Y
*     ..
*     .. External Functions ..
      COMPLEX            CLADIV
      EXTERNAL           cladiv
*     ..
*     .. External Subroutines ..
      EXTERNAL           clartg
*     ..
*     .. Intrinsic Functions ..
      INTRINSIC          real, cmplx, conjg, aimag, sqrt
*     ..
*     .. Executable Statements ..
*
*     Initialize CS and SN
*
      cs = rone
      sn = zero
*
      IF( c.EQ.zero ) THEN
         GO TO 10
*
      ELSE IF( b.EQ.zero ) THEN
*
*        Swap rows and columns
*
         cs = rzero
         sn = one
         temp = d
         d = a
         a = temp
         b = -c
         c = zero
         GO TO 10
      ELSE IF( ( a-d ).EQ.zero ) THEN
         temp = sqrt( b*c )
         a = a + temp
         d = d - temp
         IF( ( b+c ).EQ.zero ) THEN
            cs = sqrt( half )
            sn = cmplx( rzero, rone )*cs
         ELSE
            temp = sqrt( b+c )
            temp2 = cladiv( sqrt( b ), temp )
            cs = real( temp2 )
            sn = cladiv( sqrt( c ), temp )
         END IF
         b = b - c
         c = zero
         GO TO 10
      ELSE
*
*        Compute eigenvalue closest to D
*
         t = d
         u = b*c
         x = half*( a-t )
         y = sqrt( x*x+u )
         IF( real( x )*real( y )+aimag( x )*aimag( y ).LT.rzero )
     $      y = -y
         t = t - cladiv( u, ( x+y ) )
*
*        Do one QR step with exact shift T - resulting 2 x 2 in
*        triangular form.
*
         CALL clartg( a-t, c, cs, sn, aa )
*
         d = d - t
         bb = cs*b + sn*d
         dd = -conjg( sn )*b + cs*d
*
         a = aa*cs + bb*conjg( sn ) + t
         b = -aa*sn + bb*cs
         c = zero
         d = t
*
      END IF
*
   10 CONTINUE
*
*     Store eigenvalues in RT1 and RT2.
*
      rt1 = a
      rt2 = d
      RETURN
*
*     End of CLANV2
*