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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
<!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>EPSSetWhichEigenpairs</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<H1>EPSSetWhichEigenpairs</H1>
Specifies which portion of the spectrum is to be sought.
<H3><FONT COLOR="#883300">Synopsis</FONT></H3>
<PRE>
#include "slepceps.h"
PetscErrorCode EPSSetWhichEigenpairs(EPS eps,EPSWhich which)
</PRE>
Logically Collective on <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 obtained from <A HREF="../EPS/EPSCreate.html#EPSCreate">EPSCreate</A>()
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>which </B></TD><TD> - the portion of the spectrum to be sought
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Possible values</FONT></H3>
The parameter 'which' can have one of these values
<P>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_LARGEST_MAGNITUDE </B></TD><TD> - largest eigenvalues in magnitude (default)
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_SMALLEST_MAGNITUDE </B></TD><TD> - smallest eigenvalues in magnitude
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_LARGEST_REAL </B></TD><TD> - largest real parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_SMALLEST_REAL </B></TD><TD> - smallest real parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_LARGEST_IMAGINARY </B></TD><TD> - largest imaginary parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_SMALLEST_IMAGINARY </B></TD><TD> - smallest imaginary parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_TARGET_MAGNITUDE </B></TD><TD> - eigenvalues closest to the target (in magnitude)
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_TARGET_REAL </B></TD><TD> - eigenvalues with real part closest to target
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_TARGET_IMAGINARY </B></TD><TD> - eigenvalues with imaginary part closest to target
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_ALL </B></TD><TD> - all eigenvalues contained in a given interval
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>EPS_WHICH_USER </B></TD><TD> - user defined ordering set with <A HREF="../EPS/EPSSetEigenvalueComparison.html#EPSSetEigenvalueComparison">EPSSetEigenvalueComparison</A>()
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Options Database Keys</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_largest_magnitude </B></TD><TD> - Sets largest eigenvalues in magnitude
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_smallest_magnitude </B></TD><TD> - Sets smallest eigenvalues in magnitude
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_largest_real </B></TD><TD> - Sets largest real parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_smallest_real </B></TD><TD> - Sets smallest real parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_largest_imaginary </B></TD><TD> - Sets largest imaginary parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_smallest_imaginary </B></TD><TD> - Sets smallest imaginary parts
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_target_magnitude </B></TD><TD> - Sets eigenvalues closest to target
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_target_real </B></TD><TD> - Sets real parts closest to target
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_target_imaginary </B></TD><TD> - Sets imaginary parts closest to target
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-eps_all </B></TD><TD> - Sets all eigenvalues in an interval
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Notes</FONT></H3>
Not all eigensolvers implemented in <A HREF="../EPS/EPS.html#EPS">EPS</A> account for all the possible values
stated above. Also, some values make sense only for certain types of
problems. If SLEPc is compiled for real numbers EPS_LARGEST_IMAGINARY
and EPS_SMALLEST_IMAGINARY use the absolute value of the imaginary part
for eigenvalue selection.
<P>
The target is a scalar value provided with <A HREF="../EPS/EPSSetTarget.html#EPSSetTarget">EPSSetTarget</A>().
<P>
The criterion EPS_TARGET_IMAGINARY is available only in case PETSc and
SLEPc have been built with complex scalars.
<P>
EPS_ALL is intended for use in combination with an interval (see
<A HREF="../EPS/EPSSetInterval.html#EPSSetInterval">EPSSetInterval</A>()), when all eigenvalues within the interval are requested.
In that case, the number of eigenvalues is unknown, so the nev parameter
has a different sense, see <A HREF="../EPS/EPSSetDimensions.html#EPSSetDimensions">EPSSetDimensions</A>().
<P>
<P>
<H3><FONT COLOR="#883300">See Also</FONT></H3>
<A HREF="../EPS/EPSGetWhichEigenpairs.html#EPSGetWhichEigenpairs">EPSGetWhichEigenpairs</A>(), <A HREF="../EPS/EPSSetTarget.html#EPSSetTarget">EPSSetTarget</A>(), <A HREF="../EPS/EPSSetInterval.html#EPSSetInterval">EPSSetInterval</A>(),
<BR><A HREF="../EPS/EPSSetDimensions.html#EPSSetDimensions">EPSSetDimensions</A>(), <A HREF="../EPS/EPSSetEigenvalueComparison.html#EPSSetEigenvalueComparison">EPSSetEigenvalueComparison</A>(),
<A HREF="../EPS/EPSSortEigenvalues.html#EPSSortEigenvalues">EPSSortEigenvalues</A>(), <A HREF="../EPS/EPSWhich.html#EPSWhich">EPSWhich</A>
<P><B><FONT COLOR="#883300">Location: </FONT></B><A HREF="../../../src/eps/interface/opts.c.html#EPSSetWhichEigenpairs">src/eps/interface/opts.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/ex9.c.html">src/eps/examples/tutorials/ex9.c.html</A><BR>
<A HREF="../../../src/eps/examples/tutorials/ex11.c.html">src/eps/examples/tutorials/ex11.c.html</A><BR>
<A HREF="../../../src/eps/examples/tutorials/ex13.c.html">src/eps/examples/tutorials/ex13.c.html</A><BR>
<A HREF="../../../src/eps/examples/tutorials/ex19.c.html">src/eps/examples/tutorials/ex19.c.html</A><BR>
</BODY></HTML>
|
