EPSAttachDeflationSpace

Add vectors to the basis of the deflation space.

Synopsis

#include "slepceps.h" 
PetscErrorCode EPSAttachDeflationSpace(EPS eps,PetscInt n,Vec *ds,PetscTruth ortho)
Not Collective

Input Parameter

eps - the eigenproblem solver context
n - number of vectors to add
ds - set of basis vectors of the deflation space
ortho - PETSC_TRUE if basis vectors of deflation space are orthonormal

Notes

When a deflation space is given, the eigensolver seeks the eigensolution in the restriction of the problem to the orthogonal complement of this space. This can be used for instance in the case that an invariant subspace is known beforehand (such as the nullspace of the matrix).

The basis vectors can be provided all at once or incrementally with several calls to EPSAttachDeflationSpace().

Use a value of PETSC_TRUE for parameter ortho if all the vectors passed in are known to be mutually orthonormal.

See Also

EPSRemoveDeflationSpace()

Location: src/eps/interface/setup.c
Index of all EPS routines
Table of Contents for all manual pages
Index of all manual pages