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> <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.10.3 2018-12-18</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.10.3 v3.10.3 docs/manualpages/PC/PCGASMSetSubdomains.html "><small>Report Typos and Errors</small></a></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"
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../PC/PCGASMSetSubdomains.html#PCGASMSetSubdomains">PCGASMSetSubdomains</A>(<A HREF="../PC/PC.html#PC">PC</A> pc,<A HREF="../Sys/PetscInt.html#PetscInt">PetscInt</A> n,<A HREF="../IS/IS.html#IS">IS</A> iis[],<A HREF="../IS/IS.html#IS">IS</A> ois[])
</PRE>
Collective on pc
<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 object
</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 the 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 the outer subdomains (or NULL to use the same as iis, or to construct by expanding iis by the requested overlap)
</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>
Inner subdomains can not overlap with each other, do not have any entities from remote processors,
and have to cover the entire local subdomain owned by the current processor. The index sets on each
process should be ordered such that the ith local subdomain is connected to the ith remote subdomain
on another MPI process.
<P>
By default the GASM preconditioner uses 1 (local) subdomain per processor.
<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>
PCGASMSetNumSubdomains(), <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></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>advanced<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/ksp/pc/impls/gasm/gasm.c.html#PCGASMSetSubdomains">src/ksp/pc/impls/gasm/gasm.c</A>
<P><H3><FONT COLOR="#CC3333">Examples</FONT></H3>
<A HREF="../../../src/ksp/ksp/examples/tutorials/ex62.c.html">src/ksp/ksp/examples/tutorials/ex62.c.html</A><BR>
<P><H3><FONT COLOR="CC3333">Implementations</FONT></H3><A HREF="../../../src/ksp/pc/impls/gasm/gasm.c.html#PCGASMSetSubdomains_GASM">PCGASMSetSubdomains_GASM in src/ksp/pc/impls/gasm/gasm.c</A><BR>
<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>
|
