cchkec.f

Go to the documentation of this file.

*> \brief \b CCHKEC
*
*  =========== DOCUMENTATION ===========
*
* Online html documentation available at
*            http://www.netlib.org/lapack/explore-html/
*
*  Definition:
*  ===========
*
*       SUBROUTINE CCHKEC( THRESH, TSTERR, NIN, NOUT )
*
*       .. Scalar Arguments ..
*       LOGICAL            TSTERR
*       INTEGER            NIN, NOUT
*       REAL               THRESH
*       ..
*
*
*> \par Purpose:
*  =============
*>
*> \verbatim
*>
*> CCHKEC tests eigen- condition estimation routines
*>        CTRSYL, CTREXC, CTRSNA, CTRSEN
*>
*> In all cases, the routine runs through a fixed set of numerical
*> examples, subjects them to various tests, and compares the test
*> results to a threshold THRESH. In addition, CTRSNA and CTRSEN are
*> tested by reading in precomputed examples from a file (on input unit
*> NIN).  Output is written to output unit NOUT.
*> \endverbatim
*
*  Arguments:
*  ==========
*
*> \param[in] THRESH
*> \verbatim
*>          THRESH is REAL
*>          Threshold for residual tests.  A computed test ratio passes
*>          the threshold if it is less than THRESH.
*> \endverbatim
*>
*> \param[in] TSTERR
*> \verbatim
*>          TSTERR is LOGICAL
*>          Flag that indicates whether error exits are to be tested.
*> \endverbatim
*>
*> \param[in] NIN
*> \verbatim
*>          NIN is INTEGER
*>          The logical unit number for input.
*> \endverbatim
*>
*> \param[in] NOUT
*> \verbatim
*>          NOUT is INTEGER
*>          The logical unit number for output.
*> \endverbatim
*
*  Authors:
*  ========
*
*> \author Univ. of Tennessee
*> \author Univ. of California Berkeley
*> \author Univ. of Colorado Denver
*> \author NAG Ltd.
*
*> \ingroup complex_eig
*
*  =====================================================================
      SUBROUTINE cchkec( THRESH, TSTERR, NIN, NOUT )
*
*  -- LAPACK test routine --
*  -- LAPACK is a software package provided by Univ. of Tennessee,    --
*  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
*
*     .. Scalar Arguments ..
      LOGICAL            TSTERR
      INTEGER            NIN, NOUT
      REAL               THRESH
*     ..
*
*  =====================================================================
*
*     .. Local Scalars ..
      LOGICAL            OK
      CHARACTER*3        PATH
      INTEGER            KTREXC, KTRSEN, KTRSNA, KTRSYL, LTREXC, LTRSYL,
     $                   NTESTS, NTREXC, NTRSYL
      REAL               EPS, RTREXC, RTRSYL, SFMIN
*     ..
*     .. Local Arrays ..
      INTEGER            LTRSEN( 3 ), LTRSNA( 3 ), NTRSEN( 3 ),
     $                   NTRSNA( 3 )
      REAL               RTRSEN( 3 ), RTRSNA( 3 )
*     ..
*     .. External Subroutines ..
      EXTERNAL           cerrec, cget35, cget36, cget37, cget38
*     ..
*     .. External Functions ..
      REAL               SLAMCH
      EXTERNAL           slamch
*     ..
*     .. Executable Statements ..
*
      path( 1: 1 ) = 'Complex precision'
      path( 2: 3 ) = 'EC'
      eps = slamch( 'P' )
      sfmin = slamch( 'S' )
      WRITE( nout, fmt = 9994 )
      WRITE( nout, fmt = 9993 )eps, sfmin
      WRITE( nout, fmt = 9992 )thresh
*
*     Test error exits if TSTERR is .TRUE.
*
      IF( tsterr )
     $   CALL cerrec( path, nout )
*
      ok = .true.
      CALL cget35( rtrsyl, ltrsyl, ntrsyl, ktrsyl, nin )
      IF( rtrsyl.GT.thresh ) THEN
         ok = .false.
         WRITE( nout, fmt = 9999 )rtrsyl, ltrsyl, ntrsyl, ktrsyl
      END IF
*
      CALL cget36( rtrexc, ltrexc, ntrexc, ktrexc, nin )
      IF( rtrexc.GT.thresh .OR. ntrexc.GT.0 ) THEN
         ok = .false.
         WRITE( nout, fmt = 9998 )rtrexc, ltrexc, ntrexc, ktrexc
      END IF
*
      CALL cget37( rtrsna, ltrsna, ntrsna, ktrsna, nin )
      IF( rtrsna( 1 ).GT.thresh .OR. rtrsna( 2 ).GT.thresh .OR.
     $    ntrsna( 1 ).NE.0 .OR. ntrsna( 2 ).NE.0 .OR. ntrsna( 3 ).NE.0 )
     $     THEN
         ok = .false.
         WRITE( nout, fmt = 9997 )rtrsna, ltrsna, ntrsna, ktrsna
      END IF
*
      CALL cget38( rtrsen, ltrsen, ntrsen, ktrsen, nin )
      IF( rtrsen( 1 ).GT.thresh .OR. rtrsen( 2 ).GT.thresh .OR.
     $    ntrsen( 1 ).NE.0 .OR. ntrsen( 2 ).NE.0 .OR. ntrsen( 3 ).NE.0 )
     $     THEN
         ok = .false.
         WRITE( nout, fmt = 9996 )rtrsen, ltrsen, ntrsen, ktrsen
      END IF
*
      ntests = ktrsyl + ktrexc + ktrsna + ktrsen
      IF( ok )
     $   WRITE( nout, fmt = 9995 )path, ntests
*
 9999 FORMAT( ' Error in CTRSYL: RMAX =', e12.3, / ' LMAX = ', i8,
     $      ' NINFO=', i8, ' KNT=', i8 )
 9998 FORMAT( ' Error in CTREXC: RMAX =', e12.3, / ' LMAX = ', i8,
     $      ' NINFO=', i8, ' KNT=', i8 )
 9997 FORMAT( ' Error in CTRSNA: RMAX =', 3e12.3, / ' LMAX = ',
     $      3i8, ' ninfo=', 3I8, ' knt=', I8 )
 9996 FORMAT( ' error in ctrsen: rmax =', 3E12.3, / ' lmax = ',
     $      3I8, ' ninfo=', 3I8, ' knt=', I8 )
 9995 FORMAT( / 1X, 'all tests for ', A3,
     $      ' routines passed the threshold( ', I6, ' tests run)' )
 9994 FORMAT( ' tests of the nonsymmetric eigenproblem condition',
     $      ' estimation routines', / ' ctrsyl, ctrexc, ctrsna, ctrsen',
     $      / )
 9993 FORMAT( ' relative machine precision (eps) = ', E16.6,
     $      / ' safe minimum(sfmin)             = ', E16.6, / )
 9992 FORMAT( ' routines pass computational tests if test ratio is ',
     $      'less than', F8.2, / / )
      RETURN
*
*     End of CCHKEC
*
      END