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
55
56
57
58
59
60
61
62
63
64
|
<!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>EPSGetEigenpair</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<H1>EPSGetEigenpair</H1>
Gets the i-th solution of the eigenproblem as computed by <A HREF="../EPS/EPSSolve.html#EPSSolve">EPSSolve</A>(). The solution consists in both the eigenvalue and the eigenvector.
<H3><FONT COLOR="#883300">Synopsis</FONT></H3>
<PRE>
#include "slepceps.h"
PetscErrorCode EPSGetEigenpair(EPS eps,PetscInt i,PetscScalar *eigr,PetscScalar *eigi,Vec Vr,Vec Vi)
</PRE>
Not Collective, but vectors are shared by all processors that share the <A HREF="../EPS/EPS.html#EPS">EPS</A>
<P>
<H3><FONT COLOR="#883300">Input Parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>eps </B></TD><TD> - eigensolver context
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>i </B></TD><TD> - index of the solution
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Output Parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>eigr </B></TD><TD> - real part of eigenvalue
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>eigi </B></TD><TD> - imaginary part of eigenvalue
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>Vr </B></TD><TD> - real part of eigenvector
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>Vi </B></TD><TD> - imaginary part of eigenvector
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Notes</FONT></H3>
If the eigenvalue is real, then eigi and Vi are set to zero. If PETSc is
configured with complex scalars the eigenvalue is stored
directly in eigr (eigi is set to zero) and the eigenvector in Vr (Vi is
set to zero).
<P>
The index i should be a value between 0 and nconv-1 (see <A HREF="../EPS/EPSGetConverged.html#EPSGetConverged">EPSGetConverged</A>()).
Eigenpairs are indexed according to the ordering criterion established
with <A HREF="../EPS/EPSSetWhichEigenpairs.html#EPSSetWhichEigenpairs">EPSSetWhichEigenpairs</A>().
<P>
The 2-norm of the eigenvector is one unless the problem is generalized
Hermitian. In this case the eigenvector is normalized with respect to the
norm defined by the B matrix.
<P>
<P>
<H3><FONT COLOR="#883300">See Also</FONT></H3>
<A HREF="../EPS/EPSGetEigenvalue.html#EPSGetEigenvalue">EPSGetEigenvalue</A>(), <A HREF="../EPS/EPSGetEigenvector.html#EPSGetEigenvector">EPSGetEigenvector</A>(), <A HREF="../EPS/EPSGetEigenvectorLeft.html#EPSGetEigenvectorLeft">EPSGetEigenvectorLeft</A>(), <A HREF="../EPS/EPSSolve.html#EPSSolve">EPSSolve</A>(),
<BR><A HREF="../EPS/EPSGetConverged.html#EPSGetConverged">EPSGetConverged</A>(), <A HREF="../EPS/EPSSetWhichEigenpairs.html#EPSSetWhichEigenpairs">EPSSetWhichEigenpairs</A>(), <A HREF="../EPS/EPSGetInvariantSubspace.html#EPSGetInvariantSubspace">EPSGetInvariantSubspace</A>()
<P><B><FONT COLOR="#883300">Location: </FONT></B><A HREF="../../../src/eps/interface/solve.c.html#EPSGetEigenpair">src/eps/interface/solve.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/ex1.c.html">src/eps/examples/tutorials/ex1.c.html</A><BR>
<A HREF="../../../src/eps/examples/tutorials/ex19.c.html">src/eps/examples/tutorials/ex19.c.html</A><BR>
<A HREF="../../../src/eps/examples/tutorials/ex1f.F.html">src/eps/examples/tutorials/ex1f.F.html</A><BR>
</BODY></HTML>
|
