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

NAME

6       DTRCON - estimates the reciprocal of the condition number of a triangu‐
7       lar matrix A, in either the 1-norm or the infinity-norm
8

SYNOPSIS

10       SUBROUTINE DTRCON( NORM, UPLO, DIAG, N, A,  LDA,  RCOND,  WORK,  IWORK,
11                          INFO )
12
13           CHARACTER      DIAG, NORM, UPLO
14
15           INTEGER        INFO, LDA, N
16
17           DOUBLE         PRECISION RCOND
18
19           INTEGER        IWORK( * )
20
21           DOUBLE         PRECISION A( LDA, * ), WORK( * )
22

PURPOSE

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

ARGUMENTS

31       NORM    (input) CHARACTER*1
32               Specifies whether the 1-norm condition number or the  infinity-
33               norm condition number is required:
34               = '1' or 'O':  1-norm;
35               = 'I':         Infinity-norm.
36
37       UPLO    (input) CHARACTER*1
38               = 'U':  A is upper triangular;
39               = 'L':  A is lower triangular.
40
41       DIAG    (input) CHARACTER*1
42               = 'N':  A is non-unit triangular;
43               = 'U':  A is unit triangular.
44
45       N       (input) INTEGER
46               The order of the matrix A.  N >= 0.
47
48       A       (input) DOUBLE PRECISION array, dimension (LDA,N)
49               The  triangular  matrix  A.   If UPLO = 'U', the leading N-by-N
50               upper triangular part of the array A contains the upper  trian‐
51               gular  matrix,  and  the strictly lower triangular part of A is
52               not referenced.  If UPLO = 'L', the leading N-by-N lower trian‐
53               gular part of the array A contains the lower triangular matrix,
54               and the strictly upper triangular part of A is not  referenced.
55               If  DIAG  = 'U', the diagonal elements of A are also not refer‐
56               enced and are assumed to be 1.
57
58       LDA     (input) INTEGER
59               The leading dimension of the array A.  LDA >= max(1,N).
60
61       RCOND   (output) DOUBLE PRECISION
62               The reciprocal of the condition number of the  matrix  A,  com‐
63               puted as RCOND = 1/(norm(A) * norm(inv(A))).
64
65       WORK    (workspace) DOUBLE PRECISION array, dimension (3*N)
66
67       IWORK   (workspace) INTEGER array, dimension (N)
68
69       INFO    (output) INTEGER
70               = 0:  successful exit
71               < 0:  if INFO = -i, the i-th argument had an illegal value
72
73
74
75 LAPACK routine (version 3.2)    November 2008                       DTRCON(1)
Impressum