File: QEPSetInitialSpaceLeft.html

package info (click to toggle)
slepc 3.4.2.dfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 15,584 kB
  • ctags: 66,037
  • sloc: ansic: 51,275; makefile: 2,762; python: 1,577; fortran: 785; f90: 186; sh: 9
file content (49 lines) | stat: -rw-r--r-- 2,258 bytes parent folder | download | duplicates (2)
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
<!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>QEPSetInitialSpaceLeft</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">

<H1>QEPSetInitialSpaceLeft</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 "slepcqep.h" 
PetscErrorCode QEPSetInitialSpaceLeft(QEP qep,PetscInt n,Vec *is)
</PRE>
Collective on <A HREF="../QEP/QEP.html#QEP">QEP</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>qep   </B></TD><TD> - the quadratic eigensolver 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>
These vectors do not persist from one <A HREF="../QEP/QEPSolve.html#QEPSolve">QEPSolve</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="../QEP/QEPSetInitialSpace.html#QEPSetInitialSpace">QEPSetInitialSpace</A>()
<BR><P><B><FONT COLOR="#883300">Location: </FONT></B><A HREF="../../../src/qep/interface/qepsetup.c.html#QEPSetInitialSpaceLeft">src/qep/interface/qepsetup.c</A>
<BR><A HREF="./index.html">Index of all QEP 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>
</BODY></HTML>