1CGBTRS(1)                LAPACK routine (version 3.2)                CGBTRS(1)
2
3
4

NAME

6       CGBTRS  - solves a system of linear equations  A * X = B, A**T * X = B,
7       or A**H * X = B with a general band matrix A using the LU factorization
8       computed by CGBTRF
9

SYNOPSIS

11       SUBROUTINE CGBTRS( TRANS, N, KL, KU, NRHS, AB, LDAB, IPIV, B, LDB, INFO
12                          )
13
14           CHARACTER      TRANS
15
16           INTEGER        INFO, KL, KU, LDAB, LDB, N, NRHS
17
18           INTEGER        IPIV( * )
19
20           COMPLEX        AB( LDAB, * ), B( LDB, * )
21

PURPOSE

23       CGBTRS solves a system of linear equations
24          A * X = B,  A**T * X = B,  or  A**H * X =  B  with  a  general  band
25       matrix A using the LU factorization computed by CGBTRF.
26

ARGUMENTS

28       TRANS   (input) CHARACTER*1
29               Specifies the form of the system of equations.  = 'N':  A * X =
30               B     (No transpose)
31               = 'T':  A**T * X = B  (Transpose)
32               = 'C':  A**H * X = B  (Conjugate transpose)
33
34       N       (input) INTEGER
35               The order of the matrix A.  N >= 0.
36
37       KL      (input) INTEGER
38               The number of subdiagonals within the band of A.  KL >= 0.
39
40       KU      (input) INTEGER
41               The number of superdiagonals within the band of A.  KU >= 0.
42
43       NRHS    (input) INTEGER
44               The number of right hand sides, i.e., the number of columns  of
45               the matrix B.  NRHS >= 0.
46
47       AB      (input) COMPLEX array, dimension (LDAB,N)
48               Details  of  the LU factorization of the band matrix A, as com‐
49               puted by CGBTRF.  U is  stored  as  an  upper  triangular  band
50               matrix  with KL+KU superdiagonals in rows 1 to KL+KU+1, and the
51               multipliers used during the factorization are  stored  in  rows
52               KL+KU+2 to 2*KL+KU+1.
53
54       LDAB    (input) INTEGER
55               The leading dimension of the array AB.  LDAB >= 2*KL+KU+1.
56
57       IPIV    (input) INTEGER array, dimension (N)
58               The  pivot  indices;  for  1 <= i <= N, row i of the matrix was
59               interchanged with row IPIV(i).
60
61       B       (input/output) COMPLEX array, dimension (LDB,NRHS)
62               On entry, the right hand side matrix B.  On exit, the  solution
63               matrix X.
64
65       LDB     (input) INTEGER
66               The leading dimension of the array B.  LDB >= max(1,N).
67
68       INFO    (output) INTEGER
69               = 0:  successful exit
70               < 0:  if INFO = -i, the i-th argument had an illegal value
71
72
73
74 LAPACK routine (version 3.2)    November 2008                       CGBTRS(1)
Impressum