1CTBCON(1)                LAPACK routine (version 3.1)                CTBCON(1)
2
3
4

NAME

6       CTBCON  -  the  reciprocal of the condition number of a triangular band
7       matrix A, in either the 1-norm or the infinity-norm
8

SYNOPSIS

10       SUBROUTINE CTBCON( NORM, UPLO, DIAG, N,  KD,  AB,  LDAB,  RCOND,  WORK,
11                          RWORK, INFO )
12
13           CHARACTER      DIAG, NORM, UPLO
14
15           INTEGER        INFO, KD, LDAB, N
16
17           REAL           RCOND
18
19           REAL           RWORK( * )
20
21           COMPLEX        AB( LDAB, * ), WORK( * )
22

PURPOSE

24       CTBCON estimates the reciprocal of the condition number of a triangular
25       band matrix A, in either the 1-norm or the infinity-norm.
26
27       The norm of A is computed and an estimate is obtained for norm(inv(A)),
28       then the reciprocal of the condition number is computed as
29          RCOND = 1 / ( norm(A) * norm(inv(A)) ).
30
31

ARGUMENTS

33       NORM    (input) CHARACTER*1
34               Specifies  whether the 1-norm condition number or the infinity-
35               norm condition number is required:
36               = '1' or 'O':  1-norm;
37               = 'I':         Infinity-norm.
38
39       UPLO    (input) CHARACTER*1
40               = 'U':  A is upper triangular;
41               = 'L':  A is lower triangular.
42
43       DIAG    (input) CHARACTER*1
44               = 'N':  A is non-unit triangular;
45               = 'U':  A is unit triangular.
46
47       N       (input) INTEGER
48               The order of the matrix A.  N >= 0.
49
50       KD      (input) INTEGER
51               The number of superdiagonals or subdiagonals of the  triangular
52               band matrix A.  KD >= 0.
53
54       AB      (input) COMPLEX array, dimension (LDAB,N)
55               The  upper  or  lower  triangular  band matrix A, stored in the
56               first kd+1 rows of the array. The j-th column of A is stored in
57               the  j-th  column  of  the  array AB as follows: if UPLO = 'U',
58               AB(kd+1+i-j,j) = A(i,j) for max(1,j-kd)<=i<=j; if UPLO  =  'L',
59               AB(1+i-j,j)     = A(i,j) for j<=i<=min(n,j+kd).  If DIAG = 'U',
60               the diagonal elements of A are not referenced and  are  assumed
61               to be 1.
62
63       LDAB    (input) INTEGER
64               The leading dimension of the array AB.  LDAB >= KD+1.
65
66       RCOND   (output) REAL
67               The  reciprocal  of  the condition number of the matrix A, com‐
68               puted as RCOND = 1/(norm(A) * norm(inv(A))).
69
70       WORK    (workspace) COMPLEX array, dimension (2*N)
71
72       RWORK   (workspace) REAL array, dimension (N)
73
74       INFO    (output) INTEGER
75               = 0:  successful exit
76               < 0:  if INFO = -i, the i-th argument had an illegal value
77
78
79
80 LAPACK routine (version 3.1)    November 2006                       CTBCON(1)
Impressum