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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PetscViewerGetSubcomm</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<A NAME="PetscViewerGetSubcomm"><H1>PetscViewerGetSubcomm</H1></A>
Creates a new <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A> (same type as the old) that lives on a subgroup of processors
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscviewer.h"
PetscErrorCode PetscViewerGetSubcomm(PetscViewer viewer,MPI_Comm subcomm,PetscViewer *outviewer)
</PRE>
Collective on <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>viewer </B></TD><TD>- the <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A> to be duplicated
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>subcomm </B></TD><TD>- MPI communicator
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<DT><B>outviewer </B> -new <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A>
<br>
<P>
<P>
Notes: Call <A HREF="../Viewer/PetscViewerRestoreSubcomm.html#PetscViewerRestoreSubcomm">PetscViewerRestoreSubcomm</A>() to return this <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A>, NOT <A HREF="../Viewer/PetscViewerDestroy.html#PetscViewerDestroy">PetscViewerDestroy</A>()
<P>
This is used to view a sequential or a parallel object that is part of a larger
parallel object. For example redundant <A HREF="../PC/PC.html#PC">PC</A> view could use this to obtain a
<A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A> that is used within a subcommunicator on one duplicated preconditioner.
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../Viewer/PetscViewerSocketOpen.html#PetscViewerSocketOpen">PetscViewerSocketOpen</A>(), <A HREF="../Viewer/PetscViewerASCIIOpen.html#PetscViewerASCIIOpen">PetscViewerASCIIOpen</A>(), <A HREF="../Viewer/PetscViewerDrawOpen.html#PetscViewerDrawOpen">PetscViewerDrawOpen</A>(), <A HREF="../Viewer/PetscViewerRestoreSubcomm.html#PetscViewerRestoreSubcomm">PetscViewerRestoreSubcomm</A>()
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>advanced
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/sys/viewer/interface/dupl.c.html#PetscViewerGetSubcomm">src/sys/viewer/interface/dupl.c</A>
<BR><A HREF="./index.html">Index of all Viewer 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>
|
