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

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

Contents


CGTCON(3F)							    CGTCON(3F)


NAME    [Toc]    [Back]

     CGTCON - estimate the reciprocal of the condition number of a complex
     tridiagonal matrix	A using	the LU factorization as	computed by CGTTRF

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	CGTCON(	NORM, N, DL, D,	DU, DU2, IPIV, ANORM, RCOND, WORK,
			INFO )

	 CHARACTER	NORM

	 INTEGER	INFO, N

	 REAL		ANORM, RCOND

	 INTEGER	IPIV( *	)

	 COMPLEX	D( * ),	DL( * ), DU( * ), DU2( * ), WORK( * )

PURPOSE    [Toc]    [Back]

     CGTCON estimates the reciprocal of	the condition number of	a complex
     tridiagonal matrix	A using	the LU factorization as	computed by CGTTRF.

     An	estimate is obtained for norm(inv(A)), and the reciprocal of the
     condition number is computed as RCOND = 1 / (ANORM	* norm(inv(A))).

ARGUMENTS    [Toc]    [Back]

     NORM    (input) CHARACTER*1
	     Specifies whether the 1-norm condition number or the infinitynorm
 condition number is required:
	     = '1' or 'O':  1-norm;
	     = 'I':	    Infinity-norm.

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

     DL	     (input) COMPLEX array, dimension (N-1)
	     The (n-1) multipliers that	define the matrix L from the LU
	     factorization of A	as computed by CGTTRF.

     D	     (input) COMPLEX array, dimension (N)
	     The n diagonal elements of	the upper triangular matrix U from the
	     LU	factorization of A.

     DU	     (input) COMPLEX array, dimension (N-1)
	     The (n-1) elements	of the first superdiagonal of U.

     DU2     (input) COMPLEX array, dimension (N-2)
	     The (n-2) elements	of the second superdiagonal of U.






									Page 1






CGTCON(3F)							    CGTCON(3F)



     IPIV    (input) INTEGER array, dimension (N)
	     The pivot indices;	for 1 <= i <= n, row i of the matrix was
	     interchanged with row IPIV(i).  IPIV(i) will always be either i
	     or	i+1; IPIV(i) = i indicates a row interchange was not required.

     ANORM   (input) REAL
	     If	NORM = '1' or 'O', the 1-norm of the original matrix A.	 If
	     NORM = 'I', the infinity-norm of the original matrix A.

     RCOND   (output) REAL
	     The reciprocal of the condition number of the matrix A, computed
	     as	RCOND =	1/(ANORM * AINVNM), where AINVNM is an estimate	of the
	     1-norm of inv(A) computed in this routine.

     WORK    (workspace) COMPLEX array,	dimension (2*N)

     INFO    (output) INTEGER
	     = 0:  successful exit
	     < 0:  if INFO = -i, the i-th argument had an illegal value
CGTCON(3F)							    CGTCON(3F)


NAME    [Toc]    [Back]

     CGTCON - estimate the reciprocal of the condition number of a complex
     tridiagonal matrix	A using	the LU factorization as	computed by CGTTRF

SYNOPSIS    [Toc]    [Back]

     SUBROUTINE	CGTCON(	NORM, N, DL, D,	DU, DU2, IPIV, ANORM, RCOND, WORK,
			INFO )

	 CHARACTER	NORM

	 INTEGER	INFO, N

	 REAL		ANORM, RCOND

	 INTEGER	IPIV( *	)

	 COMPLEX	D( * ),	DL( * ), DU( * ), DU2( * ), WORK( * )

PURPOSE    [Toc]    [Back]

     CGTCON estimates the reciprocal of	the condition number of	a complex
     tridiagonal matrix	A using	the LU factorization as	computed by CGTTRF.

     An	estimate is obtained for norm(inv(A)), and the reciprocal of the
     condition number is computed as RCOND = 1 / (ANORM	* norm(inv(A))).

ARGUMENTS    [Toc]    [Back]

     NORM    (input) CHARACTER*1
	     Specifies whether the 1-norm condition number or the infinitynorm
 condition number is required:
	     = '1' or 'O':  1-norm;
	     = 'I':	    Infinity-norm.

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

     DL	     (input) COMPLEX array, dimension (N-1)
	     The (n-1) multipliers that	define the matrix L from the LU
	     factorization of A	as computed by CGTTRF.

     D	     (input) COMPLEX array, dimension (N)
	     The n diagonal elements of	the upper triangular matrix U from the
	     LU	factorization of A.

     DU	     (input) COMPLEX array, dimension (N-1)
	     The (n-1) elements	of the first superdiagonal of U.

     DU2     (input) COMPLEX array, dimension (N-2)
	     The (n-2) elements	of the second superdiagonal of U.






									Page 1






CGTCON(3F)							    CGTCON(3F)



     IPIV    (input) INTEGER array, dimension (N)
	     The pivot indices;	for 1 <= i <= n, row i of the matrix was
	     interchanged with row IPIV(i).  IPIV(i) will always be either i
	     or	i+1; IPIV(i) = i indicates a row interchange was not required.

     ANORM   (input) REAL
	     If	NORM = '1' or 'O', the 1-norm of the original matrix A.	 If
	     NORM = 'I', the infinity-norm of the original matrix A.

     RCOND   (output) REAL
	     The reciprocal of the condition number of the matrix A, computed
	     as	RCOND =	1/(ANORM * AINVNM), where AINVNM is an estimate	of the
	     1-norm of inv(A) computed in this routine.

     WORK    (workspace) COMPLEX array,	dimension (2*N)

     INFO    (output) INTEGER
	     = 0:  successful exit
	     < 0:  if INFO = -i, the i-th argument had an illegal value


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
dgtcon IRIX estimate the reciprocal of the condition number of a real tridiagonal matrix A using the LU factorization as c
sgtcon IRIX estimate the reciprocal of the condition number of a real tridiagonal matrix A using the LU factorization as c
zhecon IRIX estimate the reciprocal of the condition number of a complex Hermitian matrix A using the factorization A = U*
checon IRIX estimate the reciprocal of the condition number of a complex Hermitian matrix A using the factorization A = U*
chpcon IRIX estimate the reciprocal of the condition number of a complex Hermitian packed matrix A using the factorization
zhpcon IRIX estimate the reciprocal of the condition number of a complex Hermitian packed matrix A using the factorization
cspcon IRIX estimate the reciprocal of the condition number (in the 1-norm) of a complex symmetric packed matrix A using t
zsycon IRIX estimate the reciprocal of the condition number (in the 1-norm) of a complex symmetric matrix A using the fact
zspcon IRIX estimate the reciprocal of the condition number (in the 1-norm) of a complex symmetric packed matrix A using t
csycon IRIX estimate the reciprocal of the condition number (in the 1-norm) of a complex symmetric matrix A using the fact
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service