1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<link rel="stylesheet" href="/slepc/slepc.css" type="text/css">
<TITLE>EPSSetDeflationSpace</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<H1>EPSSetDeflationSpace</H1>
Specify a basis of vectors that constitute the deflation space.
<H3><FONT COLOR="#883300">Synopsis</FONT></H3>
<PRE>
#include "slepceps.h"
PetscErrorCode EPSSetDeflationSpace(EPS eps,PetscInt n,Vec *ds)
</PRE>
Collective on <A HREF="../EPS/EPS.html#EPS">EPS</A> and Vec
<P>
<H3><FONT COLOR="#883300">Input Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>eps </B></TD><TD> - the eigenproblem solver context
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>n </B></TD><TD> - number of vectors
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>ds </B></TD><TD> - set of basis vectors of the deflation space
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Notes</FONT></H3>
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).
<P>
Basis vectors set by a previous call to <A HREF="../EPS/EPSSetDeflationSpace.html#EPSSetDeflationSpace">EPSSetDeflationSpace</A>() are
replaced.
<P>
The vectors do not need to be mutually orthonormal, since they are explicitly
orthonormalized internally.
<P>
These vectors persist from one <A HREF="../EPS/EPSSolve.html#EPSSolve">EPSSolve</A>() call to the other, use
<A HREF="../EPS/EPSRemoveDeflationSpace.html#EPSRemoveDeflationSpace">EPSRemoveDeflationSpace</A>() to eliminate them.
<P>
<P>
<H3><FONT COLOR="#883300">See Also</FONT></H3>
<A HREF="../EPS/EPSRemoveDeflationSpace.html#EPSRemoveDeflationSpace">EPSRemoveDeflationSpace</A>()
<BR><P><B><FONT COLOR="#883300">Location: </FONT></B><A HREF="../../../src/eps/interface/setup.c.html#EPSSetDeflationSpace">src/eps/interface/setup.c</A>
<BR><A HREF="./index.html">Index of all EPS routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
<P><H3><FONT COLOR="#883300">Examples</FONT></H3>
<A HREF="../../../src/eps/examples/tutorials/ex7.c.html">src/eps/examples/tutorials/ex7.c.html</A><BR>
<A HREF="../../../src/eps/examples/tutorials/ex11.c.html">src/eps/examples/tutorials/ex11.c.html</A><BR>
</BODY></HTML>
|
