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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/PC/PCGASMSetSubdomains.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PCGASMSetSubdomains</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.4.2 2013-07-02</b></div>
<A NAME="PCGASMSetSubdomains"><H1>PCGASMSetSubdomains</H1></A>
Sets the subdomains for this processor for the additive Schwarz preconditioner.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscpc.h"
PetscErrorCode PCGASMSetSubdomains(PC pc,PetscInt n,IS iis[],IS ois[])
</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>n </B></TD><TD>- the number of subdomains for this processor
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>iis </B></TD><TD>- the index sets that define this processor's local inner subdomains
(or NULL for PETSc to determine subdomains)
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>ois</B></TD><TD>- the index sets that define this processor's local outer subdomains
(or NULL to use the same as iis)
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
The <A HREF="../IS/IS.html#IS">IS</A> indices use the parallel, global numbering of the vector entries.
Inner subdomains are those where the correction is applied.
Outer subdomains are those where the residual necessary to obtain the
corrections is obtained (see <A HREF="../PC/PCGASMType.html#PCGASMType">PCGASMType</A> for the use of inner/outer subdomains).
Both inner and outer subdomains can extend over several processors.
This processor's portion of a subdomain is known as a local subdomain.
<P>
By default the GASM preconditioner uses 1 (local) subdomain per processor.
Use <A HREF="../PC/PCGASMSetTotalSubdomains.html#PCGASMSetTotalSubdomains">PCGASMSetTotalSubdomains</A>() to set the total number of subdomains across
all processors that <A HREF="../PC/PCGASM.html#PCGASM">PCGASM</A> will create automatically, and to specify whether
they should be local or not.
<P>
<P>
<P>
<H3><FONT COLOR="#CC3333">Keywords</FONT></H3>
<A HREF="../PC/PC.html#PC">PC</A>, GASM, set, subdomains, additive Schwarz
<BR>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../PC/PCGASMSetTotalSubdomains.html#PCGASMSetTotalSubdomains">PCGASMSetTotalSubdomains</A>(), <A HREF="../PC/PCGASMSetOverlap.html#PCGASMSetOverlap">PCGASMSetOverlap</A>(), <A HREF="../PC/PCGASMGetSubKSP.html#PCGASMGetSubKSP">PCGASMGetSubKSP</A>(),
<BR><A HREF="../PC/PCGASMCreateSubdomains2D.html#PCGASMCreateSubdomains2D">PCGASMCreateSubdomains2D</A>(), <A HREF="../PC/PCGASMGetSubdomains.html#PCGASMGetSubdomains">PCGASMGetSubdomains</A>()
<P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>advanced
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/ksp/pc/impls/gasm/gasm.c.html#PCGASMSetSubdomains">src/ksp/pc/impls/gasm/gasm.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>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ksp/ksp/examples/tutorials/ex8g.c.html">src/ksp/ksp/examples/tutorials/ex8g.c.html</A><BR>
</BODY></HTML>
|
