diff options
author | deaglanhalligan <deaglanhalligan@8a072113-8704-0410-8d35-dd094bca7971> | 2009-04-08 00:05:18 +0000 |
---|---|---|
committer | deaglanhalligan <deaglanhalligan@8a072113-8704-0410-8d35-dd094bca7971> | 2009-04-08 00:05:18 +0000 |
commit | 47e45705b295f273c6c83f8b7f45a53cbce793d8 (patch) | |
tree | 03feea881aabfc40504b1cfdf35d1dd82d19b07d /SRC/cla_gbrcond_c.f | |
parent | 1d4ed33a5cfc65afcd46a0babb74979dfbed73f3 (diff) |
Updated documentation for EPIR routines. Changed ERRS_{N,C} variable names. Other cosmetic changes.
Diffstat (limited to 'SRC/cla_gbrcond_c.f')
-rw-r--r-- | SRC/cla_gbrcond_c.f | 65 |
1 files changed, 58 insertions, 7 deletions
diff --git a/SRC/cla_gbrcond_c.f b/SRC/cla_gbrcond_c.f index 0eee2f47..2851b147 100644 --- a/SRC/cla_gbrcond_c.f +++ b/SRC/cla_gbrcond_c.f @@ -32,11 +32,61 @@ * Arguments * ========= * -* C REAL vector. +* TRANS (input) CHARACTER*1 +* Specifies the form of the system of equations: +* = 'N': A * X = B (No transpose) +* = 'T': A**T * X = B (Transpose) +* = 'C': A**H * X = B (Conjugate Transpose = Transpose) * -* WORK COMPLEX workspace of size 2*N. +* N (input) INTEGER +* The number of linear equations, i.e., the order of the +* matrix A. N >= 0. * -* RWORK REAL workspace of size N. +* KL (input) INTEGER +* The number of subdiagonals within the band of A. KL >= 0. +* +* KU (input) INTEGER +* The number of superdiagonals within the band of A. KU >= 0. +* +* AB (input) COMPLEX 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) +* +* LDAB (input) INTEGER +* The leading dimension of the array AB. LDAB >= KL+KU+1. +* +* AFB (input) COMPLEX array, dimension (LDAFB,N) +* Details of the LU factorization of the band matrix A, as +* computed by CGBTRF. 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. +* +* LDAFB (input) INTEGER +* The leading dimension of the array AFB. LDAFB >= 2*KL+KU+1. +* +* IPIV (input) INTEGER array, dimension (N) +* The pivot indices from the factorization A = P*L*U +* as computed by CGBTRF; row i of the matrix was interchanged +* with row IPIV(i). +* +* C (input) REAL array, dimension (N) +* The vector C in the formula op(A) * inv(diag(C)). +* +* CAPPLY (input) LOGICAL +* If .TRUE. then access the vector C in the formula above. +* +* INFO (output) INTEGER +* = 0: Successful exit. +* i > 0: The ith argument is invalid. +* +* WORK (input) COMPLEX array, dimension (2*N). +* Workspace. +* +* RWORK (input) REAL array, dimension (N). +* Workspace. * * ===================================================================== * @@ -72,16 +122,17 @@ NOTRANS = LSAME( TRANS, 'N' ) IF ( .NOT. NOTRANS .AND. .NOT. LSAME( TRANS, 'T' ) .AND. .NOT. $ LSAME( TRANS, 'C' ) ) THEN + INFO = -1 ELSE IF( N.LT.0 ) THEN INFO = -2 ELSE IF( KL.LT.0 .OR. KL.GT.N-1 ) THEN - INFO = -4 + INFO = -3 ELSE IF( KU.LT.0 .OR. KU.GT.N-1 ) THEN - INFO = -5 + INFO = -4 ELSE IF( LDAB.LT.KL+KU+1 ) THEN - INFO = -8 + INFO = -6 ELSE IF( LDAFB.LT.2*KL+KU+1 ) THEN - INFO = -10 + INFO = -8 END IF IF( INFO.NE.0 ) THEN CALL XERBLA( 'CLA_GBRCOND_C', -INFO ) |