261 lines
		
	
	
		
			7.1 KiB
		
	
	
	
		
			Fortran
		
	
	
	
			
		
		
	
	
			261 lines
		
	
	
		
			7.1 KiB
		
	
	
	
		
			Fortran
		
	
	
	
*> \brief \b ZPOCON
 | 
						|
*
 | 
						|
*  =========== DOCUMENTATION ===========
 | 
						|
*
 | 
						|
* Online html documentation available at 
 | 
						|
*            http://www.netlib.org/lapack/explore-html/ 
 | 
						|
*
 | 
						|
*> \htmlonly
 | 
						|
*> Download ZPOCON + dependencies 
 | 
						|
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/zpocon.f"> 
 | 
						|
*> [TGZ]</a> 
 | 
						|
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/zpocon.f"> 
 | 
						|
*> [ZIP]</a> 
 | 
						|
*> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/zpocon.f"> 
 | 
						|
*> [TXT]</a>
 | 
						|
*> \endhtmlonly 
 | 
						|
*
 | 
						|
*  Definition:
 | 
						|
*  ===========
 | 
						|
*
 | 
						|
*       SUBROUTINE ZPOCON( UPLO, N, A, LDA, ANORM, RCOND, WORK, RWORK,
 | 
						|
*                          INFO )
 | 
						|
* 
 | 
						|
*       .. Scalar Arguments ..
 | 
						|
*       CHARACTER          UPLO
 | 
						|
*       INTEGER            INFO, LDA, N
 | 
						|
*       DOUBLE PRECISION   ANORM, RCOND
 | 
						|
*       ..
 | 
						|
*       .. Array Arguments ..
 | 
						|
*       DOUBLE PRECISION   RWORK( * )
 | 
						|
*       COMPLEX*16         A( LDA, * ), WORK( * )
 | 
						|
*       ..
 | 
						|
*  
 | 
						|
*
 | 
						|
*> \par Purpose:
 | 
						|
*  =============
 | 
						|
*>
 | 
						|
*> \verbatim
 | 
						|
*>
 | 
						|
*> ZPOCON estimates the reciprocal of the condition number (in the
 | 
						|
*> 1-norm) of a complex Hermitian positive definite matrix using the
 | 
						|
*> Cholesky factorization A = U**H*U or A = L*L**H computed by ZPOTRF.
 | 
						|
*>
 | 
						|
*> An estimate is obtained for norm(inv(A)), and the reciprocal of the
 | 
						|
*> condition number is computed as RCOND = 1 / (ANORM * norm(inv(A))).
 | 
						|
*> \endverbatim
 | 
						|
*
 | 
						|
*  Arguments:
 | 
						|
*  ==========
 | 
						|
*
 | 
						|
*> \param[in] UPLO
 | 
						|
*> \verbatim
 | 
						|
*>          UPLO is CHARACTER*1
 | 
						|
*>          = 'U':  Upper triangle of A is stored;
 | 
						|
*>          = 'L':  Lower triangle of A is stored.
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[in] N
 | 
						|
*> \verbatim
 | 
						|
*>          N is INTEGER
 | 
						|
*>          The order of the matrix A.  N >= 0.
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[in] A
 | 
						|
*> \verbatim
 | 
						|
*>          A is COMPLEX*16 array, dimension (LDA,N)
 | 
						|
*>          The triangular factor U or L from the Cholesky factorization
 | 
						|
*>          A = U**H*U or A = L*L**H, as computed by ZPOTRF.
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[in] LDA
 | 
						|
*> \verbatim
 | 
						|
*>          LDA is INTEGER
 | 
						|
*>          The leading dimension of the array A.  LDA >= max(1,N).
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[in] ANORM
 | 
						|
*> \verbatim
 | 
						|
*>          ANORM is DOUBLE PRECISION
 | 
						|
*>          The 1-norm (or infinity-norm) of the Hermitian matrix A.
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[out] RCOND
 | 
						|
*> \verbatim
 | 
						|
*>          RCOND is DOUBLE PRECISION
 | 
						|
*>          The reciprocal of the condition number of the matrix A,
 | 
						|
*>          computed as RCOND = 1/(ANORM * AINVNM), where AINVNM is an
 | 
						|
*>          estimate of the 1-norm of inv(A) computed in this routine.
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[out] WORK
 | 
						|
*> \verbatim
 | 
						|
*>          WORK is COMPLEX*16 array, dimension (2*N)
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[out] RWORK
 | 
						|
*> \verbatim
 | 
						|
*>          RWORK is DOUBLE PRECISION array, dimension (N)
 | 
						|
*> \endverbatim
 | 
						|
*>
 | 
						|
*> \param[out] INFO
 | 
						|
*> \verbatim
 | 
						|
*>          INFO is INTEGER
 | 
						|
*>          = 0:  successful exit
 | 
						|
*>          < 0:  if INFO = -i, the i-th argument had an illegal value
 | 
						|
*> \endverbatim
 | 
						|
*
 | 
						|
*  Authors:
 | 
						|
*  ========
 | 
						|
*
 | 
						|
*> \author Univ. of Tennessee 
 | 
						|
*> \author Univ. of California Berkeley 
 | 
						|
*> \author Univ. of Colorado Denver 
 | 
						|
*> \author NAG Ltd. 
 | 
						|
*
 | 
						|
*> \date November 2011
 | 
						|
*
 | 
						|
*> \ingroup complex16POcomputational
 | 
						|
*
 | 
						|
*  =====================================================================
 | 
						|
      SUBROUTINE ZPOCON( UPLO, N, A, LDA, ANORM, RCOND, WORK, RWORK,
 | 
						|
     $                   INFO )
 | 
						|
*
 | 
						|
*  -- LAPACK computational routine (version 3.4.0) --
 | 
						|
*  -- LAPACK is a software package provided by Univ. of Tennessee,    --
 | 
						|
*  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
 | 
						|
*     November 2011
 | 
						|
*
 | 
						|
*     .. Scalar Arguments ..
 | 
						|
      CHARACTER          UPLO
 | 
						|
      INTEGER            INFO, LDA, N
 | 
						|
      DOUBLE PRECISION   ANORM, RCOND
 | 
						|
*     ..
 | 
						|
*     .. Array Arguments ..
 | 
						|
      DOUBLE PRECISION   RWORK( * )
 | 
						|
      COMPLEX*16         A( LDA, * ), WORK( * )
 | 
						|
*     ..
 | 
						|
*
 | 
						|
*  =====================================================================
 | 
						|
*
 | 
						|
*     .. Parameters ..
 | 
						|
      DOUBLE PRECISION   ONE, ZERO
 | 
						|
      PARAMETER          ( ONE = 1.0D+0, ZERO = 0.0D+0 )
 | 
						|
*     ..
 | 
						|
*     .. Local Scalars ..
 | 
						|
      LOGICAL            UPPER
 | 
						|
      CHARACTER          NORMIN
 | 
						|
      INTEGER            IX, KASE
 | 
						|
      DOUBLE PRECISION   AINVNM, SCALE, SCALEL, SCALEU, SMLNUM
 | 
						|
      COMPLEX*16         ZDUM
 | 
						|
*     ..
 | 
						|
*     .. Local Arrays ..
 | 
						|
      INTEGER            ISAVE( 3 )
 | 
						|
*     ..
 | 
						|
*     .. External Functions ..
 | 
						|
      LOGICAL            LSAME
 | 
						|
      INTEGER            IZAMAX
 | 
						|
      DOUBLE PRECISION   DLAMCH
 | 
						|
      EXTERNAL           LSAME, IZAMAX, DLAMCH
 | 
						|
*     ..
 | 
						|
*     .. External Subroutines ..
 | 
						|
      EXTERNAL           XERBLA, ZDRSCL, ZLACN2, ZLATRS
 | 
						|
*     ..
 | 
						|
*     .. Intrinsic Functions ..
 | 
						|
      INTRINSIC          ABS, DBLE, DIMAG, MAX
 | 
						|
*     ..
 | 
						|
*     .. Statement Functions ..
 | 
						|
      DOUBLE PRECISION   CABS1
 | 
						|
*     ..
 | 
						|
*     .. Statement Function definitions ..
 | 
						|
      CABS1( ZDUM ) = ABS( DBLE( ZDUM ) ) + ABS( DIMAG( ZDUM ) )
 | 
						|
*     ..
 | 
						|
*     .. Executable Statements ..
 | 
						|
*
 | 
						|
*     Test the input parameters.
 | 
						|
*
 | 
						|
      INFO = 0
 | 
						|
      UPPER = LSAME( UPLO, 'U' )
 | 
						|
      IF( .NOT.UPPER .AND. .NOT.LSAME( UPLO, 'L' ) ) THEN
 | 
						|
         INFO = -1
 | 
						|
      ELSE IF( N.LT.0 ) THEN
 | 
						|
         INFO = -2
 | 
						|
      ELSE IF( LDA.LT.MAX( 1, N ) ) THEN
 | 
						|
         INFO = -4
 | 
						|
      ELSE IF( ANORM.LT.ZERO ) THEN
 | 
						|
         INFO = -5
 | 
						|
      END IF
 | 
						|
      IF( INFO.NE.0 ) THEN
 | 
						|
         CALL XERBLA( 'ZPOCON', -INFO )
 | 
						|
         RETURN
 | 
						|
      END IF
 | 
						|
*
 | 
						|
*     Quick return if possible
 | 
						|
*
 | 
						|
      RCOND = ZERO
 | 
						|
      IF( N.EQ.0 ) THEN
 | 
						|
         RCOND = ONE
 | 
						|
         RETURN
 | 
						|
      ELSE IF( ANORM.EQ.ZERO ) THEN
 | 
						|
         RETURN
 | 
						|
      END IF
 | 
						|
*
 | 
						|
      SMLNUM = DLAMCH( 'Safe minimum' )
 | 
						|
*
 | 
						|
*     Estimate the 1-norm of inv(A).
 | 
						|
*
 | 
						|
      KASE = 0
 | 
						|
      NORMIN = 'N'
 | 
						|
   10 CONTINUE
 | 
						|
      CALL ZLACN2( N, WORK( N+1 ), WORK, AINVNM, KASE, ISAVE )
 | 
						|
      IF( KASE.NE.0 ) THEN
 | 
						|
         IF( UPPER ) THEN
 | 
						|
*
 | 
						|
*           Multiply by inv(U**H).
 | 
						|
*
 | 
						|
            CALL ZLATRS( 'Upper', 'Conjugate transpose', 'Non-unit',
 | 
						|
     $                   NORMIN, N, A, LDA, WORK, SCALEL, RWORK, INFO )
 | 
						|
            NORMIN = 'Y'
 | 
						|
*
 | 
						|
*           Multiply by inv(U).
 | 
						|
*
 | 
						|
            CALL ZLATRS( 'Upper', 'No transpose', 'Non-unit', NORMIN, N,
 | 
						|
     $                   A, LDA, WORK, SCALEU, RWORK, INFO )
 | 
						|
         ELSE
 | 
						|
*
 | 
						|
*           Multiply by inv(L).
 | 
						|
*
 | 
						|
            CALL ZLATRS( 'Lower', 'No transpose', 'Non-unit', NORMIN, N,
 | 
						|
     $                   A, LDA, WORK, SCALEL, RWORK, INFO )
 | 
						|
            NORMIN = 'Y'
 | 
						|
*
 | 
						|
*           Multiply by inv(L**H).
 | 
						|
*
 | 
						|
            CALL ZLATRS( 'Lower', 'Conjugate transpose', 'Non-unit',
 | 
						|
     $                   NORMIN, N, A, LDA, WORK, SCALEU, RWORK, INFO )
 | 
						|
         END IF
 | 
						|
*
 | 
						|
*        Multiply by 1/SCALE if doing so will not cause overflow.
 | 
						|
*
 | 
						|
         SCALE = SCALEL*SCALEU
 | 
						|
         IF( SCALE.NE.ONE ) THEN
 | 
						|
            IX = IZAMAX( N, WORK, 1 )
 | 
						|
            IF( SCALE.LT.CABS1( WORK( IX ) )*SMLNUM .OR. SCALE.EQ.ZERO )
 | 
						|
     $         GO TO 20
 | 
						|
            CALL ZDRSCL( N, SCALE, WORK, 1 )
 | 
						|
         END IF
 | 
						|
         GO TO 10
 | 
						|
      END IF
 | 
						|
*
 | 
						|
*     Compute the estimate of the reciprocal condition number.
 | 
						|
*
 | 
						|
      IF( AINVNM.NE.ZERO )
 | 
						|
     $   RCOND = ( ONE / AINVNM ) / ANORM
 | 
						|
*
 | 
						|
   20 CONTINUE
 | 
						|
      RETURN
 | 
						|
*
 | 
						|
*     End of ZPOCON
 | 
						|
*
 | 
						|
      END
 |