EPSSolve#

Solves the eigensystem.

Synopsis#

#include "slepceps.h" 
PetscErrorCode EPSSolve(EPS eps)

Collective

Input Parameter#

eps - the linear eigensolver context

Options Database Keys#

-eps_view - print information about the solver once the solve is complete
-eps_view_pre - print information about the solver before the solve starts
-eps_view_mat0 - view the first matrix (\(A\))
-eps_view_mat1 - view the second matrix (\(B\))
-eps_view_vectors - view the computed eigenvectors
-eps_view_values - view the computed eigenvalues
-eps_converged_reason - print reason for convergence/divergence, and number of iterations
-eps_error_absolute - print absolute errors of each eigenpair
-eps_error_relative - print relative errors of each eigenpair
-eps_error_backward - print backward errors of each eigenpair

Notes#

The problem matrices are specified with EPSSetOperators().

EPSSolve() will return without generating an error regardless of whether all requested solutions were computed or not. Call EPSGetConverged() to get the actual number of computed solutions, and EPSGetConvergedReason() to determine if the solver converged or failed and why.

All the command-line options listed above admit an optional argument specifying the viewer type and options. For instance, use -eps_view_mat0 binary:amatrix.bin to save the \(A\) matrix to a binary file, -eps_view_values draw to draw the computed eigenvalues graphically, or -eps_error_relative :myerr.m:ascii_matlab to save the errors in a file that can be executed in Matlab.

Level#

beginner

Location#

src/eps/interface/epssolve.c

Examples#

src/eps/tutorials/ex29.c
src/eps/tutorials/ex1f.F90
src/eps/tutorials/ex55.c
src/eps/tutorials/ex18.c
src/eps/tutorials/ex3.c
src/eps/tutorials/ex36.c
src/eps/tutorials/ex9.c
src/eps/tutorials/ex2.c
src/eps/tutorials/ex6f.F90
src/eps/tutorials/ex31.c

Implementations#

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