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

NAME

6       CLAQSP - a symmetric matrix A using the scaling factors in the vector S
7

SYNOPSIS

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

PURPOSE

22       CLAQSP  equilibrates  a symmetric 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               symmetric 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       AP      (input/output) COMPLEX array, dimension (N*(N+1)/2)
36               On  entry,  the upper or lower triangle of the symmetric matrix
37               A, packed columnwise in a linear array.  The j-th column  of  A
38               is  stored  in  the  array AP as follows: if UPLO = 'U', AP(i +
39               (j-1)*j/2) =  A(i,j)  for  1<=i<=j;  if  UPLO  =  'L',  AP(i  +
40               (j-1)*(2n-j)/2) = A(i,j) for j<=i<=n.
41
42               On  exit,  the  equilibrated matrix:  diag(S) * A * diag(S), in
43               the same storage format as A.
44
45       S       (input) REAL array, dimension (N)
46               The scale factors for A.
47
48       SCOND   (input) REAL
49               Ratio of the smallest S(i) to the largest S(i).
50
51       AMAX    (input) REAL
52               Absolute value of largest matrix entry.
53
54       EQUED   (output) CHARACTER*1
55               Specifies whether or not equilibration was done.   =  'N':   No
56               equilibration.
57               =  'Y':   Equilibration  was done, i.e., A has been replaced by
58               diag(S) * A * diag(S).
59

PARAMETERS

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