.TH "SRC/claein.f" 3 "Version 3.12.0" "LAPACK" \" -*- nroff -*-
.ad l
.nh
.SH NAME
SRC/claein.f
.SH SYNOPSIS
.br
.PP
.SS "Functions/Subroutines"

.in +1c
.ti -1c
.RI "subroutine \fBclaein\fP (rightv, noinit, n, h, ldh, w, v, b, ldb, rwork, eps3, smlnum, info)"
.br
.RI "\fBCLAEIN\fP computes a specified right or left eigenvector of an upper Hessenberg matrix by inverse iteration\&. "
.in -1c
.SH "Function/Subroutine Documentation"
.PP 
.SS "subroutine claein (logical rightv, logical noinit, integer n, complex, dimension( ldh, * ) h, integer ldh, complex w, complex, dimension( * ) v, complex, dimension( ldb, * ) b, integer ldb, real, dimension( * ) rwork, real eps3, real smlnum, integer info)"

.PP
\fBCLAEIN\fP computes a specified right or left eigenvector of an upper Hessenberg matrix by inverse iteration\&.  
.PP
\fBPurpose:\fP
.RS 4

.PP
.nf
 CLAEIN uses inverse iteration to find a right or left eigenvector
 corresponding to the eigenvalue W of a complex upper Hessenberg
 matrix H\&.
.fi
.PP
 
.RE
.PP
\fBParameters\fP
.RS 4
\fIRIGHTV\fP 
.PP
.nf
          RIGHTV is LOGICAL
          = \&.TRUE\&. : compute right eigenvector;
          = \&.FALSE\&.: compute left eigenvector\&.
.fi
.PP
.br
\fINOINIT\fP 
.PP
.nf
          NOINIT is LOGICAL
          = \&.TRUE\&. : no initial vector supplied in V
          = \&.FALSE\&.: initial vector supplied in V\&.
.fi
.PP
.br
\fIN\fP 
.PP
.nf
          N is INTEGER
          The order of the matrix H\&.  N >= 0\&.
.fi
.PP
.br
\fIH\fP 
.PP
.nf
          H is COMPLEX array, dimension (LDH,N)
          The upper Hessenberg matrix H\&.
.fi
.PP
.br
\fILDH\fP 
.PP
.nf
          LDH is INTEGER
          The leading dimension of the array H\&.  LDH >= max(1,N)\&.
.fi
.PP
.br
\fIW\fP 
.PP
.nf
          W is COMPLEX
          The eigenvalue of H whose corresponding right or left
          eigenvector is to be computed\&.
.fi
.PP
.br
\fIV\fP 
.PP
.nf
          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|\&.
.fi
.PP
.br
\fIB\fP 
.PP
.nf
          B is COMPLEX array, dimension (LDB,N)
.fi
.PP
.br
\fILDB\fP 
.PP
.nf
          LDB is INTEGER
          The leading dimension of the array B\&.  LDB >= max(1,N)\&.
.fi
.PP
.br
\fIRWORK\fP 
.PP
.nf
          RWORK is REAL array, dimension (N)
.fi
.PP
.br
\fIEPS3\fP 
.PP
.nf
          EPS3 is REAL
          A small machine-dependent value which is used to perturb
          close eigenvalues, and to replace zero pivots\&.
.fi
.PP
.br
\fISMLNUM\fP 
.PP
.nf
          SMLNUM is REAL
          A machine-dependent value close to the underflow threshold\&.
.fi
.PP
.br
\fIINFO\fP 
.PP
.nf
          INFO is INTEGER
          = 0:  successful exit
          = 1:  inverse iteration did not converge; V is set to the
                last iterate\&.
.fi
.PP
 
.RE
.PP
\fBAuthor\fP
.RS 4
Univ\&. of Tennessee 
.PP
Univ\&. of California Berkeley 
.PP
Univ\&. of Colorado Denver 
.PP
NAG Ltd\&. 
.RE
.PP

.PP
Definition at line \fB147\fP of file \fBclaein\&.f\fP\&.
.SH "Author"
.PP 
Generated automatically by Doxygen for LAPACK from the source code\&.