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
|
<!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/PCGASMSetTotalSubdomains.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PCGASMSetTotalSubdomains</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.4.2 2013-07-02</b></div>
<A NAME="PCGASMSetTotalSubdomains"><H1>PCGASMSetTotalSubdomains</H1></A>
Sets the total number of subdomains to use in the generalized additive Schwarz preconditioner. The number of subdomains is cumulative across all processors in pc's communicator. Either all or no processors in the <A HREF="../PC/PC.html#PC">PC</A> communicator must call this routine with the same N. The subdomains will be created automatically during <A HREF="../PC/PCSetUp.html#PCSetUp">PCSetUp</A>().
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscpc.h"
PetscErrorCode PCGASMSetTotalSubdomains(PC pc,PetscInt N, PetscBool create_local)
</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 total number of subdomains cumulative across all processors
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>create_local </B></TD><TD>- whether the subdomains to be created are to be local
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Options Database Key</FONT></H3>
<H3><FONT COLOR="#CC3333">To set the total number of subdomains and let PCGASM autocreate them, rather than specify the index sets, use the following options</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-pc_gasm_total_subdomains <n> </B></TD><TD>- sets the total number of subdomains to be autocreated by <A HREF="../PC/PCGASM.html#PCGASM">PCGASM</A>
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-pc_gasm_subdomains_create_local <true|false> </B></TD><TD>- whether autocreated subdomains should be local or not (default is true)
</TD></TR></TABLE>
<P>
By default the GASM preconditioner uses 1 subdomain per processor.
<P>
<P>
Use <A HREF="../PC/PCGASMSetSubdomains.html#PCGASMSetSubdomains">PCGASMSetSubdomains</A>() to set subdomains explicitly or to set different numbers
of subdomains per processor.
<P>
<P>
<H3><FONT COLOR="#CC3333">Keywords</FONT></H3>
<A HREF="../PC/PC.html#PC">PC</A>, GASM, set, total, global, subdomains, additive Schwarz
<BR>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../PC/PCGASMSetSubdomains.html#PCGASMSetSubdomains">PCGASMSetSubdomains</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>()
<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#PCGASMSetTotalSubdomains">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>
</BODY></HTML>
|
