f12fff is a setup routine for
f12fgf which can be used to find some eigenvalues (and optionally the corresponding eigenvectors) of a standard or generalized eigenvalue problem defined by real, banded, symmetric matrices. The banded matrix must be stored using the LAPACK storage format for real banded nonsymmetric matrices.
The pair of routines
f12fff and
f12fgf together with the option setting routine
f12fdf 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 real and symmetric.
f12fff is a setup routine which must be called before the option setting routine
f12fdf and the solver routine
f12fgf. Internally,
f12fgf makes calls to
f12fbf and
f12fcf; the routine documents for
f12fbf and
f12fcf 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
f12fdf, 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
f12fdf.
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
$\mathrm{-1}$, explanatory error messages are output on the current error message unit (as defined by
x04aaf).
Not applicable.
None.
The use of
f12fff is illustrated by the example program of
f12fgf (see
f12fgf).