f12atf is a setup routine for
f12auf which may be used for finding some eigenvalues (and optionally the corresponding eigenvectors) of a standard or generalized eigenvalue problem defined by complex, banded, non-Hermitian matrices. The banded matrix must be stored using the LAPACK column ordered storage format for complex banded non-Hermitian matrices (see
Section 3.3.4 in the F07 Chapter Introduction).
The pair of routines
f12atf and
f12auf together with the option setting routine
f12arf are designed to calculate some of the eigenvalues,
$\lambda $, (and optionally the corresponding eigenvectors,
$x$) of a standard eigenvalue problem
$Ax=\lambda x$, or of a generalized eigenvalue problem
$Ax=\lambda Bx$ of order
$n$, where
$n$ is large and the coefficient matrices
$A$ and
$B$ are banded complex and non-Hermitian.
f12atf is a setup routine which must be called before the option setting routine
f12arf and the solver routine
f12auf. Internally,
f12auf makes calls to
f12apf and
f12aqf; the routine documents for
f12apf and
f12aqf should be consulted for details of the algorithm used.
This setup routine initializes the communication arrays, sets (to their default values) all options that can be set by you via the option setting routine
f12arf, and checks that the lengths of the communication arrays as passed by you are of sufficient length. For details of the options available and how to set them, see
Section 11.1 in
f12arf.
Lehoucq R B and Scott J A (1996) An evaluation of software for computing eigenvalues of sparse nonsymmetric matrices Preprint MCS-P547-1195 Argonne National Laboratory
Lehoucq R B and Sorensen D C (1996) Deflation techniques for an implicitly restarted Arnoldi iteration SIAM Journal on Matrix Analysis and Applications 17 789–821
If on entry
${\mathbf{ifail}}=0$ or
$-1$, explanatory error messages are output on the current error message unit (as defined by
x04aaf).
Not applicable.
None.