slepc-3.20.2 2024-03-15
Report Typos and Errors

EPSSetWhichEigenpairs

Specifies which portion of the spectrum is to be sought.

Synopsis

#include "slepceps.h" 
PetscErrorCode EPSSetWhichEigenpairs(EPS eps,EPSWhich which)
Logically Collective

Input Parameters

eps  - eigensolver context obtained from EPSCreate()
which  - the portion of the spectrum to be sought

Options Database Keys

-eps_largest_magnitude  - Sets largest eigenvalues in magnitude
-eps_smallest_magnitude  - Sets smallest eigenvalues in magnitude
-eps_largest_real  - Sets largest real parts
-eps_smallest_real  - Sets smallest real parts
-eps_largest_imaginary  - Sets largest imaginary parts
-eps_smallest_imaginary  - Sets smallest imaginary parts
-eps_target_magnitude  - Sets eigenvalues closest to target
-eps_target_real  - Sets real parts closest to target
-eps_target_imaginary  - Sets imaginary parts closest to target
-eps_all  - Sets all eigenvalues in an interval or region

Notes

The parameter 'which' can have one of these values

EPS_LARGEST_MAGNITUDE  - largest eigenvalues in magnitude (default)
EPS_SMALLEST_MAGNITUDE  - smallest eigenvalues in magnitude
EPS_LARGEST_REAL  - largest real parts
EPS_SMALLEST_REAL  - smallest real parts
EPS_LARGEST_IMAGINARY  - largest imaginary parts
EPS_SMALLEST_IMAGINARY  - smallest imaginary parts
EPS_TARGET_MAGNITUDE  - eigenvalues closest to the target (in magnitude)
EPS_TARGET_REAL  - eigenvalues with real part closest to target
EPS_TARGET_IMAGINARY  - eigenvalues with imaginary part closest to target
EPS_ALL  - all eigenvalues contained in a given interval or region
EPS_WHICH_USER  - user defined ordering set with EPSSetEigenvalueComparison()

Not all eigensolvers implemented in EPS account for all the possible values stated above. Also, some values make sense only for certain types of problems. If SLEPc is compiled for real numbers EPS_LARGEST_IMAGINARY and EPS_SMALLEST_IMAGINARY use the absolute value of the imaginary part for eigenvalue selection.

The target is a scalar value provided with EPSSetTarget().

The criterion EPS_TARGET_IMAGINARY is available only in case PETSc and SLEPc have been built with complex scalars.

EPS_ALL is intended for use in combination with an interval (see EPSSetInterval()), when all eigenvalues within the interval are requested, or in the context of the CISS solver for computing all eigenvalues in a region. In those cases, the number of eigenvalues is unknown, so the nev parameter has a different sense, see EPSSetDimensions().

See Also

EPSGetWhichEigenpairs(), EPSSetTarget(), EPSSetInterval(),
EPSSetDimensions(), EPSSetEigenvalueComparison(), EPSWhich

Level

intermediate

Location

src/eps/interface/epsopts.c

Examples

src/eps/tutorials/ex9.c
src/eps/tutorials/ex10.c
src/eps/tutorials/ex10f90.F90
src/eps/tutorials/ex11.c
src/eps/tutorials/ex12.c
src/eps/tutorials/ex19.c
src/eps/tutorials/ex24.c
src/eps/tutorials/ex25.c
src/eps/tutorials/ex30.c
src/eps/tutorials/ex35.c
src/eps/tutorials/ex36.c


Index of all EPS routines
Table of Contents for all manual pages
Index of all manual pages