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
|
<!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>DSVectors</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<H1>DSVectors</H1>
Compute vectors associated to the dense system such as eigenvectors.
<H3><FONT COLOR="#883300">Synopsis</FONT></H3>
<PRE>
#include "slepcds.h"
PetscErrorCode DSVectors(DS ds,DSMatType mat,PetscInt *j,PetscReal *rnorm)
</PRE>
Logically Collective on <A HREF="../DS/DS.html#DS">DS</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>ds </B></TD><TD> - the direct solver context
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>mat </B></TD><TD> - the matrix, used to indicate which vectors are required
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#883300">Input/Output Parameter</FONT></H3>
<DT><B>j </B> - (optional) index of vector to be computed
<br>
</TABLE>
<P>
<H3><FONT COLOR="#883300">Output Parameter</FONT></H3>
<DT><B>rnorm </B> - (optional) computed residual norm
<br>
<P>
<H3><FONT COLOR="#883300">Notes</FONT></H3>
Allowed values for mat are DS_MAT_X, DS_MAT_Y, DS_MAT_U and DS_MAT_VT, to
compute right or left eigenvectors, or left or right singular vectors,
respectively.
<P>
If NULL is passed in argument j then all vectors are computed,
otherwise j indicates which vector must be computed. In real non-symmetric
problems, on exit the index j will be incremented when a complex conjugate
pair is found.
<P>
This function can be invoked after the dense problem has been solved,
to get the residual norm estimate of the associated Ritz pair. In that
case, the relevant information is returned in rnorm.
<P>
For computing eigenvectors, LAPACK's _trevc is used so the matrix must
be in (quasi-)triangular form, or call <A HREF="../DS/DSSolve.html#DSSolve">DSSolve</A>() first.
<P>
<P>
<H3><FONT COLOR="#883300">See Also</FONT></H3>
<A HREF="../DS/DSSolve.html#DSSolve">DSSolve</A>()
<BR><P><B><FONT COLOR="#883300">Location: </FONT></B><A HREF="../../../src/ds/interface/dsops.c.html#DSVectors">src/ds/interface/dsops.c</A>
<BR><A HREF="./index.html">Index of all DS 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>
|
