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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Viewer/PetscViewerSAWsOpen.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PetscViewerSAWsOpen</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.7.5 2017-01-01</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.7.5 v3.7.5 docs/manualpages/Viewer/PetscViewerSAWsOpen.html "><small>Report Typos and Errors</small></a></div>
<A NAME="PetscViewerSAWsOpen"><H1>PetscViewerSAWsOpen</H1></A>
Opens an SAWs <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A>.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscsys.h" */
PetscErrorCode PetscViewerSAWsOpen(MPI_Comm comm,PetscViewer *lab)
</PRE>
Collective on <A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameters</FONT></H3>
<DT><B>comm </B> -the MPI communicator
<br>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<DT><B>lab </B> -the <A HREF="../Viewer/PetscViewer.html#PetscViewer">PetscViewer</A>
<br>
<P>
<H3><FONT COLOR="#CC3333">Options Database Keys</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-saws_port <port number> </B></TD><TD>- port number where you are running SAWs client
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-xxx_view saws </B></TD><TD>- publish the object xxx
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-xxx_saws_block </B></TD><TD>- blocks the program at the end of a critical point (for <A HREF="../KSP/KSP.html#KSP">KSP</A> and <A HREF="../SNES/SNES.html#SNES">SNES</A> it is the end of a solve) until
the user unblocks the problem with an external tool that access the object with SAWS
</TD></TR></TABLE>
<P>
<P>
<H3><FONT COLOR="#CC3333">Fortran Note</FONT></H3>
This routine is not supported in Fortran.
<P>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
Unlike other viewers that only access the object being viewed on the call to XXXView(object,viewer) the SAWs viewer allows
one to view the object asynchronously as the program continues to run. One can remove SAWs access to the object with a call to
PetscObjectSAWsViewOff().
<P>
Information about the SAWs is available via <a href="http://bitbucket.org/saws/saws">http://bitbucket.org/saws/saws </a> <P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../Viewer/PetscViewerDestroy.html#PetscViewerDestroy">PetscViewerDestroy</A>(), <A HREF="../Viewer/PetscViewerStringSPrintf.html#PetscViewerStringSPrintf">PetscViewerStringSPrintf</A>(), <A HREF="../Viewer/PETSC_VIEWER_SAWS_.html#PETSC_VIEWER_SAWS_">PETSC_VIEWER_SAWS_</A>(), <A HREF="../Sys/PetscObjectSAWsBlock.html#PetscObjectSAWsBlock">PetscObjectSAWsBlock</A>(),
<BR>PetscObjectSAWsViewOff(), <A HREF="../Sys/PetscObjectSAWsTakeAccess.html#PetscObjectSAWsTakeAccess">PetscObjectSAWsTakeAccess</A>(), <A HREF="../Sys/PetscObjectSAWsGrantAccess.html#PetscObjectSAWsGrantAccess">PetscObjectSAWsGrantAccess</A>()
<P>
<P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>advanced
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/sys/classes/viewer/impls/ams/amsopen.c.html#PetscViewerSAWsOpen">src/sys/classes/viewer/impls/ams/amsopen.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>
|
