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

NAME

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

SYNOPSIS

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

PURPOSE

22       CLAQHE  equilibrates  a Hermitian matrix A using the scaling factors in
23       the vector S.
24
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.
43
44               On exit, if EQUED = 'Y', the equilibrated matrix: diag(S) * A *
45               diag(S).
46
47       LDA     (input) INTEGER
48               The leading dimension of the array A.  LDA >= max(N,1).
49
50       S       (input) REAL array, dimension (N)
51               The scale factors for A.
52
53       SCOND   (input) REAL
54               Ratio of the smallest S(i) to the largest S(i).
55
56       AMAX    (input) REAL
57               Absolute value of largest matrix entry.
58
59       EQUED   (output) CHARACTER*1
60               Specifies whether or not equilibration was done.   =  'N':   No
61               equilibration.
62               =  'Y':   Equilibration  was done, i.e., A has been replaced by
63               diag(S) * A * diag(S).
64

PARAMETERS

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