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

NAME

6       CGEEQUB  -  computes row and column scalings intended to equilibrate an
7       M-by-N matrix A and reduce its condition number
8

SYNOPSIS

10       SUBROUTINE CGEEQUB( M, N, A, LDA, R, C, ROWCND, COLCND, AMAX, INFO )
11
12           IMPLICIT        NONE
13
14           INTEGER         INFO, LDA, M, N
15
16           REAL            AMAX, COLCND, ROWCND
17
18           REAL            C( * ), R( * )
19
20           COMPLEX         A( LDA, * )
21

PURPOSE

23       CGEEQUB computes row and column scalings intended to equilibrate an  M-
24       by-N matrix A and reduce its condition number.  R returns the row scale
25       factors and C the column scale factors,  chosen  to  try  to  make  the
26       largest  element  in  each row and column of the matrix B with elements
27       B(i,j)=R(i)*A(i,j)*C(j) have an absolute value of at most the radix.
28       R(i) and C(j) are restricted to be a power of the radix between  SMLNUM
29       =  smallest safe number and BIGNUM = largest safe number.  Use of these
30       scaling factors is not guaranteed to reduce the condition number  of  A
31       but works well in practice.
32       This  routine differs from CGEEQU by restricting the scaling factors to
33       a power of the radix.  Baring over- and  underflow,  scaling  by  these
34       factors  introduces no additional rounding errors.  However, the scaled
35       entries' magnitured are no  longer  approximately  1  but  lie  between
36       sqrt(radix) and 1/sqrt(radix).
37

ARGUMENTS

39       M       (input) INTEGER
40               The number of rows of the matrix A.  M >= 0.
41
42       N       (input) INTEGER
43               The number of columns of the matrix A.  N >= 0.
44
45       A       (input) COMPLEX array, dimension (LDA,N)
46               The  M-by-N  matrix  whose equilibration factors are to be com‐
47               puted.
48
49       LDA     (input) INTEGER
50               The leading dimension of the array A.  LDA >= max(1,M).
51
52       R       (output) REAL array, dimension (M)
53               If INFO = 0 or INFO > M, R contains the row scale  factors  for
54               A.
55
56       C       (output) REAL array, dimension (N)
57               If INFO = 0,  C contains the column scale factors for A.
58
59       ROWCND  (output) REAL
60               If  INFO  =  0  or  INFO  > M, ROWCND contains the ratio of the
61               smallest R(i) to the largest R(i).  If ROWCND >= 0.1  and  AMAX
62               is  neither too large nor too small, it is not worth scaling by
63               R.
64
65       COLCND  (output) REAL
66               If INFO = 0, COLCND contains the ratio of the smallest C(i)  to
67               the largest C(i).  If COLCND >= 0.1, it is not worth scaling by
68               C.
69
70       AMAX    (output) REAL
71               Absolute value of largest matrix  element.   If  AMAX  is  very
72               close to overflow or very close to underflow, the matrix should
73               be scaled.
74
75       INFO    (output) INTEGER
76               = 0:  successful exit
77               < 0:  if INFO = -i, the i-th argument had an illegal value
78               > 0:  if INFO = i,  and i is
79               <= M:  the i-th row of A is exactly zero
80               >  M:  the (i-M)-th column of A is exactly zero
81
82
83
84    LAPACK routine (version 3.2) November 2008                      CGEEQUB(1)