*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> complib/zpoequ (3)              
Title
Content
Arch
Section
 

Contents


ZPOEQU(3F)							    ZPOEQU(3F)


NAME    [Toc]    [Back]

     ZPOEQU - compute row and column scalings intended to equilibrate a
     Hermitian positive	definite matrix	A and reduce its condition number
     (with respect to the two-norm)

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	ZPOEQU(	N, A, LDA, S, SCOND, AMAX, INFO	)

	 INTEGER	INFO, LDA, N

	 DOUBLE		PRECISION AMAX,	SCOND

	 DOUBLE		PRECISION S( * )

	 COMPLEX*16	A( LDA,	* )

PURPOSE    [Toc]    [Back]

     ZPOEQU computes row and column scalings intended to equilibrate a
     Hermitian positive	definite matrix	A and reduce its condition number
     (with respect to the two-norm).  S	contains the scale factors, S(i) =
     1/sqrt(A(i,i)), chosen so that the	scaled matrix B	with elements B(i,j) =
     S(i)*A(i,j)*S(j) has ones on the diagonal.	 This choice of	S puts the
     condition number of B within a factor N of	the smallest possible
     condition number over all possible	diagonal scalings.

ARGUMENTS    [Toc]    [Back]

     N	     (input) INTEGER
	     The order of the matrix A.	 N >= 0.

     A	     (input) COMPLEX*16	array, dimension (LDA,N)
	     The N-by-N	Hermitian positive definite matrix whose scaling
	     factors are to be computed.  Only the diagonal elements of	A are
	     referenced.

     LDA     (input) INTEGER
	     The leading dimension of the array	A.  LDA	>= max(1,N).

     S	     (output) DOUBLE PRECISION array, dimension	(N)
	     If	INFO = 0, S contains the scale factors for A.

     SCOND   (output) DOUBLE PRECISION
	     If	INFO = 0, S contains the ratio of the smallest S(i) to the
	     largest S(i).  If SCOND >=	0.1 and	AMAX is	neither	too large nor
	     too small,	it is not worth	scaling	by S.

     AMAX    (output) DOUBLE PRECISION
	     Absolute value of largest matrix element.	If AMAX	is very	close
	     to	overflow or very close to underflow, the matrix	should be
	     scaled.





									Page 1






ZPOEQU(3F)							    ZPOEQU(3F)



     INFO    (output) INTEGER
	     = 0:  successful exit
	     < 0:  if INFO = -i, the i-th argument had an illegal value
	     > 0:  if INFO = i,	the i-th diagonal element is nonpositive.
ZPOEQU(3F)							    ZPOEQU(3F)


NAME    [Toc]    [Back]

     ZPOEQU - compute row and column scalings intended to equilibrate a
     Hermitian positive	definite matrix	A and reduce its condition number
     (with respect to the two-norm)

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	ZPOEQU(	N, A, LDA, S, SCOND, AMAX, INFO	)

	 INTEGER	INFO, LDA, N

	 DOUBLE		PRECISION AMAX,	SCOND

	 DOUBLE		PRECISION S( * )

	 COMPLEX*16	A( LDA,	* )

PURPOSE    [Toc]    [Back]

     ZPOEQU computes row and column scalings intended to equilibrate a
     Hermitian positive	definite matrix	A and reduce its condition number
     (with respect to the two-norm).  S	contains the scale factors, S(i) =
     1/sqrt(A(i,i)), chosen so that the	scaled matrix B	with elements B(i,j) =
     S(i)*A(i,j)*S(j) has ones on the diagonal.	 This choice of	S puts the
     condition number of B within a factor N of	the smallest possible
     condition number over all possible	diagonal scalings.

ARGUMENTS    [Toc]    [Back]

     N	     (input) INTEGER
	     The order of the matrix A.	 N >= 0.

     A	     (input) COMPLEX*16	array, dimension (LDA,N)
	     The N-by-N	Hermitian positive definite matrix whose scaling
	     factors are to be computed.  Only the diagonal elements of	A are
	     referenced.

     LDA     (input) INTEGER
	     The leading dimension of the array	A.  LDA	>= max(1,N).

     S	     (output) DOUBLE PRECISION array, dimension	(N)
	     If	INFO = 0, S contains the scale factors for A.

     SCOND   (output) DOUBLE PRECISION
	     If	INFO = 0, S contains the ratio of the smallest S(i) to the
	     largest S(i).  If SCOND >=	0.1 and	AMAX is	neither	too large nor
	     too small,	it is not worth	scaling	by S.

     AMAX    (output) DOUBLE PRECISION
	     Absolute value of largest matrix element.	If AMAX	is very	close
	     to	overflow or very close to underflow, the matrix	should be
	     scaled.





									Page 1






ZPOEQU(3F)							    ZPOEQU(3F)



     INFO    (output) INTEGER
	     = 0:  successful exit
	     < 0:  if INFO = -i, the i-th argument had an illegal value
	     > 0:  if INFO = i,	the i-th diagonal element is nonpositive.


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
zpbequ IRIX compute row and column scalings intended to equilibrate a Hermitian positive definite band matrix A and reduce
cpbequ IRIX compute row and column scalings intended to equilibrate a Hermitian positive definite band matrix A and reduce
dpoequ IRIX compute row and column scalings intended to equilibrate a symmetric positive definite matrix A and reduce its
spoequ IRIX compute row and column scalings intended to equilibrate a symmetric positive definite matrix A and reduce its
spbequ IRIX compute row and column scalings intended to equilibrate a symmetric positive definite band matrix A and reduce
dpbequ IRIX compute row and column scalings intended to equilibrate a symmetric positive definite band matrix A and reduce
zppequ IRIX compute row and column scalings intended to equilibrate a Hermitian positive definite matrix A in packed stora
cppequ IRIX compute row and column scalings intended to equilibrate a Hermitian positive definite matrix A in packed stora
dppequ IRIX compute row and column scalings intended to equilibrate a symmetric positive definite matrix A in packed stora
sppequ IRIX compute row and column scalings intended to equilibrate a symmetric positive definite matrix A in packed stora
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service