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
|
<!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>EPSSetInitialSpaceLeft</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<H1>EPSSetInitialSpaceLeft</H1>
Specify a basis of vectors that constitute the initial left space, that is, the subspace from which the solver starts to iterate for building the left subspace (in methods that work with two subspaces).
<H3><FONT COLOR="#883300">Synopsis</FONT></H3>
<PRE>
#include "slepceps.h"
PetscErrorCode EPSSetInitialSpaceLeft(EPS eps,PetscInt n,Vec *is)
</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>is </B></TD><TD> - set of basis vectors of the initial left space
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Notes</FONT></H3>
Some solvers start to iterate on a single vector (initial left vector). In that case,
the other vectors are ignored.
<P>
In contrast to <A HREF="../EPS/EPSSetDeflationSpace.html#EPSSetDeflationSpace">EPSSetDeflationSpace</A>(), these vectors do not persist from one
<A HREF="../EPS/EPSSolve.html#EPSSolve">EPSSolve</A>() call to the other, so the initial left space should be set every time.
<P>
The vectors do not need to be mutually orthonormal, since they are explicitly
orthonormalized internally.
<P>
Common usage of this function is when the user can provide a rough approximation
of the wanted left eigenspace. Then, convergence may be faster.
<P>
<P>
<H3><FONT COLOR="#883300">See Also</FONT></H3>
<A HREF="../EPS/EPSSetInitialSpace.html#EPSSetInitialSpace">EPSSetInitialSpace</A>(), <A HREF="../EPS/EPSSetDeflationSpace.html#EPSSetDeflationSpace">EPSSetDeflationSpace</A>()
<BR><P><B><FONT COLOR="#883300">Location: </FONT></B><A HREF="../../../src/eps/interface/setup.c.html#EPSSetInitialSpaceLeft">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/ex12.c.html">src/eps/examples/tutorials/ex12.c.html</A><BR>
</BODY></HTML>
|
