1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      78
      79
      80
      81
      82
      83
      84
      85
      86
      87
      88
      89
      90
      91
      92
      93
      94
      95
      96
      97
      98
      99
     100
     101
     102
     103
     104
     105
     106
     107
     108
     109
     110
     111
     112
     113
     114
     115
     116
     117
     118
     119
     120
     121
     122
     123
     124
     125
     126
     127
     128
     129
     130
     131
     132
     133
     134
     135
     136
     137
     138
     139
     140
     141
     142
     143
     144
     145
     146
     147
     148
     149
     150
     151
     152
     153
     154
     155
     156
     157
     158
     159
     160
     161
     162
     163
     164
     165
     166
     167
     168
     169
     170
     171
     172
     173
     174
     175
     176
     177
     178
     179
     180
     181
     182
     183
     184
     185
     186
     187
     188
     189
     190
     191
     192
     193
     194
      SUBROUTINE CTBT03UPLOTRANSDIAGNKDNRHSABLDAB,
     $                   SCALECNORMTSCALXLDXBLDBWORK,
     $                   RESID )
*
*  -- LAPACK test routine (version 3.1) --
*     Univ. of Tennessee, Univ. of California Berkeley and NAG Ltd..
*     November 2006
*
*     .. Scalar Arguments ..
      CHARACTER          DIAGTRANSUPLO
      INTEGER            KDLDABLDBLDXNNRHS
      REAL               RESIDSCALETSCAL
*     ..
*     .. Array Arguments ..
      REAL               CNORM* )
      COMPLEX            ABLDAB* ), BLDB* ), WORK* ),
     $                   XLDX* )
*     ..
*
*  Purpose
*  =======
*
*  CTBT03 computes the residual for the solution to a scaled triangular
*  system of equations  A*x = s*b,  A**T *x = s*b,  or  A**H *x = s*b
*  when A is a triangular band matrix.  Here A**T  denotes the transpose
*  of A, A**H denotes the conjugate transpose of A, s is a scalar, and
*  x and b are N by NRHS matrices.  The test ratio is the maximum over
*  the number of right hand sides of
*     norm(s*b - op(A)*x) / ( norm(op(A)) * norm(x) * EPS ),
*  where op(A) denotes A, A**T, or A**H, and EPS is the machine epsilon.
*
*  Arguments
*  =========
*
*  UPLO    (input) CHARACTER*1
*          Specifies whether the matrix A is upper or lower triangular.
*          = 'U':  Upper triangular
*          = 'L':  Lower triangular
*
*  TRANS   (input) CHARACTER*1
*          Specifies the operation applied to A.
*          = 'N':  A *x = s*b     (No transpose)
*          = 'T':  A**T *x = s*b  (Transpose)
*          = 'C':  A**H *x = s*b  (Conjugate transpose)
*
*  DIAG    (input) CHARACTER*1
*          Specifies whether or not the matrix A is unit triangular.
*          = 'N':  Non-unit triangular
*          = 'U':  Unit triangular
*
*  N       (input) INTEGER
*          The order of the matrix A.  N >= 0.
*
*  KD      (input) INTEGER
*          The number of superdiagonals or subdiagonals of the
*          triangular band matrix A.  KD >= 0.
*
*  NRHS    (input) INTEGER
*          The number of right hand sides, i.e., the number of columns
*          of the matrices X and B.  NRHS >= 0.
*
*  AB      (input) COMPLEX array, dimension (LDAB,N)
*          The upper or lower triangular band matrix A, stored in the
*          first kd+1 rows of the array. The j-th column of A is stored
*          in the j-th column of the array AB as follows:
*          if UPLO = 'U', AB(kd+1+i-j,j) = A(i,j) for max(1,j-kd)<=i<=j;
*          if UPLO = 'L', AB(1+i-j,j)    = A(i,j) for j<=i<=min(n,j+kd).
*
*  LDAB    (input) INTEGER
*          The leading dimension of the array AB.  LDAB >= KD+1.
*
*  SCALE   (input) REAL
*          The scaling factor s used in solving the triangular system.
*
*  CNORM   (input) REAL array, dimension (N)
*          The 1-norms of the columns of A, not counting the diagonal.
*
*  TSCAL   (input) REAL
*          The scaling factor used in computing the 1-norms in CNORM.
*          CNORM actually contains the column norms of TSCAL*A.
*
*  X       (input) COMPLEX array, dimension (LDX,NRHS)
*          The computed solution vectors for the system of linear
*          equations.
*
*  LDX     (input) INTEGER
*          The leading dimension of the array X.  LDX >= max(1,N).
*
*  B       (input) COMPLEX array, dimension (LDB,NRHS)
*          The right hand side vectors for the system of linear
*          equations.
*
*  LDB     (input) INTEGER
*          The leading dimension of the array B.  LDB >= max(1,N).
*
*  WORK    (workspace) COMPLEX array, dimension (N)
*
*  RESID   (output) REAL
*          The maximum over the number of right hand sides of
*          norm(op(A)*x - s*b) / ( norm(op(A)) * norm(x) * EPS ).
*
*  =====================================================================
*
*
*     .. Parameters ..
      REAL               ONEZERO
      PARAMETER          ( ONE = 1.0E+0ZERO = 0.0E+0 )
*     ..
*     .. Local Scalars ..
      INTEGER            IXJ
      REAL               EPSERRSMLNUMTNORMXNORMXSCAL
*     ..
*     .. External Functions ..
      LOGICAL            LSAME
      INTEGER            ICAMAX
      REAL               SLAMCH
      EXTERNAL           LSAMEICAMAXSLAMCH
*     ..
*     .. External Subroutines ..
      EXTERNAL           CAXPYCCOPYCSSCALCTBMV
*     ..
*     .. Intrinsic Functions ..
      INTRINSIC          ABSCMPLXMAXREAL
*     ..
*     .. Executable Statements ..
*
*     Quick exit if N = 0
*
      IFN.LE.0 .OR. NRHS.LE.0 ) THEN
         RESID = ZERO
         RETURN
      END IF
      EPS = SLAMCH'Epsilon' )
      SMLNUM = SLAMCH'Safe minimum' )
*
*     Compute the norm of the triangular matrix A using the column
*     norms already computed by CLATBS.
*
      TNORM = ZERO
      IFLSAMEDIAG'N' ) ) THEN
         IFLSAMEUPLO'U' ) ) THEN
            DO 10 J = 1N
               TNORM = MAXTNORMTSCAL*ABSABKD+1J ) )+
     $                 CNORMJ ) )
   10       CONTINUE
         ELSE
            DO 20 J = 1N
               TNORM = MAXTNORMTSCAL*ABSAB1J ) )+CNORMJ ) )
   20       CONTINUE
         END IF
      ELSE
         DO 30 J = 1N
            TNORM = MAXTNORMTSCAL+CNORMJ ) )
   30    CONTINUE
      END IF
*
*     Compute the maximum over the number of right hand sides of
*        norm(op(A)*x - s*b) / ( norm(op(A)) * norm(x) * EPS ).
*
      RESID = ZERO
      DO 40 J = 1NRHS
         CALL CCOPYNX1J ), 1WORK1 )
         IX = ICAMAXNWORK1 )
         XNORM = MAXONEABSXIXJ ) ) )
         XSCAL = ( ONE / XNORM ) / REALKD+1 )
         CALL CSSCALNXSCALWORK1 )
         CALL CTBMVUPLOTRANSDIAGNKDABLDABWORK1 )
         CALL CAXPYNCMPLX-SCALE*XSCAL ), B1J ), 1WORK1 )
         IX = ICAMAXNWORK1 )
         ERR = TSCAL*ABSWORKIX ) )
         IX = ICAMAXNX1J ), 1 )
         XNORM = ABSXIXJ ) )
         IFERR*SMLNUM.LE.XNORM ) THEN
            IFXNORM.GT.ZERO )
     $         ERR = ERR / XNORM
         ELSE
            IFERR.GT.ZERO )
     $         ERR = ONE / EPS
         END IF
         IFERR*SMLNUM.LE.TNORM ) THEN
            IFTNORM.GT.ZERO )
     $         ERR = ERR / TNORM
         ELSE
            IFERR.GT.ZERO )
     $         ERR = ONE / EPS
         END IF
         RESID = MAXRESIDERR )
   40 CONTINUE
*
      RETURN
*
*     End of CTBT03
*
      END