claein.f(3) [debian man page]

claein.f(3)							      LAPACK							       claein.f(3)

NAME

       claein.f -

SYNOPSIS

   Functions/Subroutines
       subroutine claein (RIGHTV, NOINIT, N, H, LDH, W, V, B, LDB, RWORK, EPS3, SMLNUM, INFO)
	   CLAEIN

Function/Subroutine Documentation
   subroutine claein (logicalRIGHTV, logicalNOINIT, integerN, complex, dimension( ldh, * )H, integerLDH, complexW, complex, dimension( * )V,
       complex, dimension( ldb, * )B, integerLDB, real, dimension( * )RWORK, realEPS3, realSMLNUM, integerINFO)
       CLAEIN

       Purpose:

	    CLAEIN uses inverse iteration to find a right or left eigenvector
	    corresponding to the eigenvalue W of a complex upper Hessenberg
	    matrix H.

       Parameters:
	   RIGHTV

		     RIGHTV is LOGICAL
		     = .TRUE. : compute right eigenvector;
		     = .FALSE.: compute left eigenvector.

	   NOINIT

		     NOINIT is LOGICAL
		     = .TRUE. : no initial vector supplied in V
		     = .FALSE.: initial vector supplied in V.

	   N

		     N is INTEGER
		     The order of the matrix H.  N >= 0.

	   H

		     H is COMPLEX array, dimension (LDH,N)
		     The upper Hessenberg matrix H.

	   LDH

		     LDH is INTEGER
		     The leading dimension of the array H.  LDH >= max(1,N).

	   W

		     W is COMPLEX
		     The eigenvalue of H whose corresponding right or left
		     eigenvector is to be computed.

	   V

		     V is COMPLEX array, dimension (N)
		     On entry, if NOINIT = .FALSE., V must contain a starting
		     vector for inverse iteration; otherwise V need not be set.
		     On exit, V contains the computed eigenvector, normalized so
		     that the component of largest magnitude has magnitude 1; here
		     the magnitude of a complex number (x,y) is taken to be
		     |x| + |y|.

	   B

		     B is COMPLEX array, dimension (LDB,N)

	   LDB

		     LDB is INTEGER
		     The leading dimension of the array B.  LDB >= max(1,N).

	   RWORK

		     RWORK is REAL array, dimension (N)

	   EPS3

		     EPS3 is REAL
		     A small machine-dependent value which is used to perturb
		     close eigenvalues, and to replace zero pivots.

	   SMLNUM

		     SMLNUM is REAL
		     A machine-dependent value close to the underflow threshold.

	   INFO

		     INFO is INTEGER
		     = 0:  successful exit
		     = 1:  inverse iteration did not converge; V is set to the
			   last iterate.

       Author:
	   Univ. of Tennessee

	   Univ. of California Berkeley

	   Univ. of Colorado Denver

	   NAG Ltd.

       Date:
	   November 2011

       Definition at line 149 of file claein.f.

Author
       Generated automatically by Doxygen for LAPACK from the source code.

Version 3.4.1							  Sun May 26 2013						       claein.f(3)

Check Out this Related Man Page

CLAEIN(l)								 )								 CLAEIN(l)

NAME

       CLAEIN - use inverse iteration to find a right or left eigenvector corresponding to the eigenvalue W of a complex upper Hessenberg matrix H

SYNOPSIS

       SUBROUTINE CLAEIN( RIGHTV, NOINIT, N, H, LDH, W, V, B, LDB, RWORK, EPS3, SMLNUM, INFO )

	   LOGICAL	  NOINIT, RIGHTV

	   INTEGER	  INFO, LDB, LDH, N

	   REAL 	  EPS3, SMLNUM

	   COMPLEX	  W

	   REAL 	  RWORK( * )

	   COMPLEX	  B( LDB, * ), H( LDH, * ), V( * )

PURPOSE

       CLAEIN uses inverse iteration to find a right or left eigenvector corresponding to the eigenvalue W of a complex upper Hessenberg matrix H.

ARGUMENTS

       RIGHTV	(input) LOGICAL
		= .TRUE. : compute right eigenvector;
		= .FALSE.: compute left eigenvector.

       NOINIT	(input) LOGICAL
		= .TRUE. : no initial vector supplied in V
		= .FALSE.: initial vector supplied in V.

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

       H       (input) COMPLEX array, dimension (LDH,N)
	       The upper Hessenberg matrix H.

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

       W       (input) COMPLEX
	       The eigenvalue of H whose corresponding right or left eigenvector is to be computed.

       V       (input/output) COMPLEX array, dimension (N)
	       On  entry,  if  NOINIT  = .FALSE., V must contain a starting vector for inverse iteration; otherwise V need not be set.	On exit, V
	       contains the computed eigenvector, normalized so that the component of largest magnitude has magnitude 1; here the magnitude  of  a
	       complex number (x,y) is taken to be |x| + |y|.

       B       (workspace) COMPLEX array, dimension (LDB,N)

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

       RWORK   (workspace) REAL array, dimension (N)

       EPS3    (input) REAL
	       A small machine-dependent value which is used to perturb close eigenvalues, and to replace zero pivots.

       SMLNUM  (input) REAL
	       A machine-dependent value close to the underflow threshold.

       INFO    (output) INTEGER
	       = 0:  successful exit
	       = 1:  inverse iteration did not converge; V is set to the last iterate.

LAPACK version 3.0						   15 June 2000 							 CLAEIN(l)

Linux and UNIX Man Pages

claein.f(3) [debian man page]

Check Out this Related Man Page