1CLAQHE(1)           LAPACK auxiliary routine (version 3.2)           CLAQHE(1)
2
3
4

NAME

6       CLAQHE - equilibrates a Hermitian matrix A using the scaling factors in
7       the vector S
8

SYNOPSIS

10       SUBROUTINE CLAQHE( UPLO, N, A, LDA, S, SCOND, AMAX, EQUED )
11
12           CHARACTER      EQUED, UPLO
13
14           INTEGER        LDA, N
15
16           REAL           AMAX, SCOND
17
18           REAL           S( * )
19
20           COMPLEX        A( LDA, * )
21

PURPOSE

23       CLAQHE equilibrates a Hermitian matrix A using the scaling  factors  in
24       the vector S.
25

ARGUMENTS

27       UPLO    (input) CHARACTER*1
28               Specifies  whether  the  upper  or lower triangular part of the
29               Hermitian matrix A is stored.  = 'U':  Upper triangular
30               = 'L':  Lower triangular
31
32       N       (input) INTEGER
33               The order of the matrix A.  N >= 0.
34
35       A       (input/output) COMPLEX array, dimension (LDA,N)
36               On entry, the Hermitian matrix A.  If UPLO = 'U', the leading n
37               by  n  upper triangular part of A contains the upper triangular
38               part of the matrix A, and the strictly lower triangular part of
39               A  is  not referenced.  If UPLO = 'L', the leading n by n lower
40               triangular part of A contains the lower triangular part of  the
41               matrix  A,  and  the strictly upper triangular part of A is not
42               referenced.  On exit, if EQUED = 'Y', the equilibrated  matrix:
43               diag(S) * A * diag(S).
44
45       LDA     (input) INTEGER
46               The leading dimension of the array A.  LDA >= max(N,1).
47
48       S       (input) REAL array, dimension (N)
49               The scale factors for A.
50
51       SCOND   (input) REAL
52               Ratio of the smallest S(i) to the largest S(i).
53
54       AMAX    (input) REAL
55               Absolute value of largest matrix entry.
56
57       EQUED   (output) CHARACTER*1
58               Specifies  whether  or  not equilibration was done.  = 'N':  No
59               equilibration.
60               = 'Y':  Equilibration was done, i.e., A has  been  replaced  by
61               diag(S) * A * diag(S).
62

PARAMETERS

64       THRESH  is  a  threshold value used to decide if scaling should be done
65       based on the ratio of the scaling factors.  If SCOND < THRESH,  scaling
66       is  done.  LARGE and SMALL are threshold values used to decide if scal‐
67       ing should be done based on the absolute size  of  the  largest  matrix
68       element.  If AMAX > LARGE or AMAX < SMALL, scaling is done.
69
70
71
72 LAPACK auxiliary routine (versionNo3v.e2m)ber 2008                       CLAQHE(1)
Impressum