slepc-main 2024-11-22

EPSSetStoppingTestFunction

Sets a function to decide when to stop the outer iteration of the eigensolver.

Synopsis

#include "slepceps.h" 
PetscErrorCode EPSSetStoppingTestFunction(EPS eps,EPSStoppingTestFn *func,void* ctx,PetscCtxDestroyFn *destroy)

Logically Collective

Input Parameters

	eps	- eigensolver context obtained from EPSCreate()
	func	- stopping test function, see EPSStoppingTestFn for the calling sequence
	ctx	- context for private data for the stopping routine (may be NULL)
	destroy	- a routine for destroying the context (may be NULL), see PetscCtxDestroyFn for the calling sequence

Note

Normal usage is to first call the default routine EPSStoppingBasic() and then set reason to EPS_CONVERGED_USER if some user-defined conditions have been met. To let the eigensolver continue iterating, the result must be left as EPS_CONVERGED_ITERATING.

Level

advanced

Location

src/eps/interface/epsopts.c

Examples

src/eps/tutorials/ex29.c
src/eps/tutorials/ex30.c

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