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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PCDiagonalScaleLeft</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<A NAME="PCDiagonalScaleLeft"><H1>PCDiagonalScaleLeft</H1></A>
Indicates the left scaling to use to apply an additional left and right scaling as needed by certain time-stepping codes.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscsles.h"
int PCDiagonalScaleLeft(PC pc,Vec in,Vec out)
</PRE>
Collective on <A HREF="../PC/PC.html#PC">PC</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>pc </B></TD><TD>- the preconditioner context
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>in </B></TD><TD>- input vector
+ out - scaled vector (maybe the same as in)
</TD></TR>
<P>
<P>
Notes: The system solved via the Krylov method is
<pre>
D <A HREF="../Vec/M.html#M">M</A> A D^{-1} y = D <A HREF="../Vec/M.html#M">M</A> b for left preconditioning or
</pre>
<pre>
D A <A HREF="../Vec/M.html#M">M</A> D^{-1} z = D b for right preconditioning
</pre>
<P>
<A HREF="../PC/PCDiagonalScaleLeft.html#PCDiagonalScaleLeft">PCDiagonalScaleLeft</A>() scales a vector by D. <A HREF="../PC/PCDiagonalScaleRight.html#PCDiagonalScaleRight">PCDiagonalScaleRight</A>() scales a vector by D^{-1}.
<P>
If diagonal scaling is turned off and in is not out then in is copied to out
<P>
<H3><FONT COLOR="#CC3333">Keywords</FONT></H3>
<A HREF="../PC/PC.html#PC">PC</A>
<BR>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../PC/PCCreate.html#PCCreate">PCCreate</A>(), <A HREF="../PC/PCSetUp.html#PCSetUp">PCSetUp</A>(), <A HREF="../PC/PCDiagonalScaleSet.html#PCDiagonalScaleSet">PCDiagonalScaleSet</A>(), <A HREF="../PC/PCDiagonalScaleRight.html#PCDiagonalScaleRight">PCDiagonalScaleRight</A>(), <A HREF="../PC/PCDiagonalScale.html#PCDiagonalScale">PCDiagonalScale</A>()
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>intermediate
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/sles/pc/interface/precon.c.html#PCDiagonalScaleLeft">src/sles/pc/interface/precon.c</A>
<BR><A HREF="./index.html">Index of all PC 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>
|
