LAPACK 3.12.1
LAPACK: Linear Algebra PACKage
Loading...
Searching...
No Matches

◆ zla_gbrpvgrw()

double precision function zla_gbrpvgrw ( integer n,
integer kl,
integer ku,
integer ncols,
complex*16, dimension( ldab, * ) ab,
integer ldab,
complex*16, dimension( ldafb, * ) afb,
integer ldafb )

ZLA_GBRPVGRW computes the reciprocal pivot growth factor norm(A)/norm(U) for a general banded matrix.

Download ZLA_GBRPVGRW + dependencies [TGZ] [ZIP] [TXT]

Purpose:
!>
!> ZLA_GBRPVGRW computes the reciprocal pivot growth factor
!> norm(A)/norm(U). The  norm is used. If this is
!> much less than 1, the stability of the LU factorization of the
!> (equilibrated) matrix A could be poor. This also means that the
!> solution X, estimated condition numbers, and error bounds could be
!> unreliable.
!> 
Parameters
[in]N
!>          N is INTEGER
!>     The number of linear equations, i.e., the order of the
!>     matrix A.  N >= 0.
!> 
[in]KL
!>          KL is INTEGER
!>     The number of subdiagonals within the band of A.  KL >= 0.
!> 
[in]KU
!>          KU is INTEGER
!>     The number of superdiagonals within the band of A.  KU >= 0.
!> 
[in]NCOLS
!>          NCOLS is INTEGER
!>     The number of columns of the matrix A.  NCOLS >= 0.
!> 
[in]AB
!>          AB is COMPLEX*16 array, dimension (LDAB,N)
!>     On entry, the matrix A in band storage, in rows 1 to KL+KU+1.
!>     The j-th column of A is stored in the j-th column of the
!>     array AB as follows:
!>     AB(KU+1+i-j,j) = A(i,j) for max(1,j-KU)<=i<=min(N,j+kl)
!> 
[in]LDAB
!>          LDAB is INTEGER
!>     The leading dimension of the array AB.  LDAB >= KL+KU+1.
!> 
[in]AFB
!>          AFB is COMPLEX*16 array, dimension (LDAFB,N)
!>     Details of the LU factorization of the band matrix A, as
!>     computed by ZGBTRF.  U is stored as an upper triangular
!>     band matrix with KL+KU superdiagonals in rows 1 to KL+KU+1,
!>     and the multipliers used during the factorization are stored
!>     in rows KL+KU+2 to 2*KL+KU+1.
!> 
[in]LDAFB
!>          LDAFB is INTEGER
!>     The leading dimension of the array AFB.  LDAFB >= 2*KL+KU+1.
!> 
Author
Univ. of Tennessee
Univ. of California Berkeley
Univ. of Colorado Denver
NAG Ltd.

Definition at line 113 of file zla_gbrpvgrw.f.

115*
116* -- LAPACK computational routine --
117* -- LAPACK is a software package provided by Univ. of Tennessee, --
118* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
119*
120* .. Scalar Arguments ..
121 INTEGER N, KL, KU, NCOLS, LDAB, LDAFB
122* ..
123* .. Array Arguments ..
124 COMPLEX*16 AB( LDAB, * ), AFB( LDAFB, * )
125* ..
126*
127* =====================================================================
128*
129* .. Local Scalars ..
130 INTEGER I, J, KD
131 DOUBLE PRECISION AMAX, UMAX, RPVGRW
132 COMPLEX*16 ZDUM
133* ..
134* .. Intrinsic Functions ..
135 INTRINSIC abs, max, min, real, dimag
136* ..
137* .. Statement Functions ..
138 DOUBLE PRECISION CABS1
139* ..
140* .. Statement Function Definitions ..
141 cabs1( zdum ) = abs( dble( zdum ) ) + abs( dimag( zdum ) )
142* ..
143* .. Executable Statements ..
144*
145 rpvgrw = 1.0d+0
146
147 kd = ku + 1
148 DO j = 1, ncols
149 amax = 0.0d+0
150 umax = 0.0d+0
151 DO i = max( j-ku, 1 ), min( j+kl, n )
152 amax = max( cabs1( ab( kd+i-j, j ) ), amax )
153 END DO
154 DO i = max( j-ku, 1 ), j
155 umax = max( cabs1( afb( kd+i-j, j ) ), umax )
156 END DO
157 IF ( umax /= 0.0d+0 ) THEN
158 rpvgrw = min( amax / umax, rpvgrw )
159 END IF
160 END DO
161 zla_gbrpvgrw = rpvgrw
162*
163* End of ZLA_GBRPVGRW
164*
double precision function zla_gbrpvgrw(n, kl, ku, ncols, ab, ldab, afb, ldafb)
ZLA_GBRPVGRW computes the reciprocal pivot growth factor norm(A)/norm(U) for a general banded matrix.
Here is the call graph for this function:
Here is the caller graph for this function: