petsc4py.PETSc.Viewer#
- class petsc4py.PETSc.Viewer#
Bases:
Object
Viewer object.
Viewer is described in the
PETSc manual
.Viewers can be called as functions where the argument specified is the PETSc object to be viewed. See the example below.
Examples
>>> from petsc4py import PETSc >>> u = PETSc.Vec().createWithArray([1,2]) >>> v = PETSc.Viewer() >>> v(u) Vec Object: 1 MPI process type: seq 1. 2.
See also
Enumerations
Window size.
Viewer file mode.
Viewer format.
Viewer type.
Methods Summary
ASCII
(name[, comm])Return an ASCII viewer associated with the communicator.
BINARY
([comm])Return the default
Type.BINARY
viewer associated with the communicator.DRAW
([comm])Return the default
Type.DRAW
viewer associated with the communicator.STDERR
([comm])Return the standard error viewer associated with the communicator.
STDOUT
([comm])Return the standard output viewer associated with the communicator.
addASCIITab
(tabs)Increment the ASCII tab level.
Reset graphics.
create
([comm])Create a viewer.
createASCII
(name[, mode, comm])Create a viewer of type
Type.ASCII
.createBinary
(name[, mode, comm])Create a viewer of type
Type.BINARY
.createDraw
([display, title, position, size, ...])Create a
Type.DRAW
viewer.createHDF5
(name[, mode, comm])Create a viewer of type
Type.HDF5
.createMPIIO
(name[, mode, comm])Create a viewer of type
Type.BINARY
supporting MPI-IO.createVTK
(name[, mode, comm])Create a viewer of type
Type.VTK
.destroy
()Destroy the viewer.
flush
()Flush the viewer.
Return the ASCII tab level.
Return the file mode.
Return file name.
Return the format of the viewer.
getSubViewer
([comm])Return a viewer defined on a subcommunicator.
getType
()Return the type of the viewer.
Disallow ASCII synchronized calls.
Pop an additional tab level pushed via
pushASCIITab
.Pop format from the viewer.
printfASCII
(msg)Print a message.
Print a synchronized message.
Allow ASCII synchronized calls.
Push an additional tab level.
pushFormat
(format)Push format to the viewer.
restoreSubViewer
(sub)Restore a viewer defined on a subcommunicator.
setASCIITab
(tabs)Set ASCII tab level.
setDrawInfo
([display, title, position, size])Set window information for a
Type.DRAW
viewer.setFileMode
(mode)Set file mode.
setFileName
(name)Set file name.
setType
(vwr_type)Set the type of the viewer.
subtractASCIITab
(tabs)Decrement the ASCII tab level.
useASCIITabs
(flag)Enable/disable the use of ASCII tabs.
view
([obj])View the viewer.
Methods Documentation
- classmethod ASCII(name, comm=None)#
Return an ASCII viewer associated with the communicator.
Collective.
- Parameters:
name (str) – The filename.
comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.
- Return type:
- classmethod BINARY(comm=None)#
Return the default
Type.BINARY
viewer associated with the communicator.Collective.
- Parameters:
comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.- Return type:
- classmethod DRAW(comm=None)#
Return the default
Type.DRAW
viewer associated with the communicator.Collective.
- Parameters:
comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.- Return type:
- classmethod STDERR(comm=None)#
Return the standard error viewer associated with the communicator.
Collective.
- Parameters:
comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.- Return type:
- classmethod STDOUT(comm=None)#
Return the standard output viewer associated with the communicator.
Collective.
- Parameters:
comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.- Return type:
- addASCIITab(tabs)#
Increment the ASCII tab level.
Collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:661
- Parameters:
tabs (int) –
- clearDraw()#
Reset graphics.
Not collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:892
- Return type:
- create(comm=None)#
Create a viewer.
Collective.
- Parameters:
comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.- Return type:
See also
- createASCII(name, mode=None, comm=None)#
Create a viewer of type
Type.ASCII
.Collective.
- Parameters:
- Return type:
Self
- createBinary(name, mode=None, comm=None)#
Create a viewer of type
Type.BINARY
.Collective.
- Parameters:
- Return type:
Self
See also
create
,setType
,setFileMode
,setFileName
,Sys.getDefaultComm
- createDraw(display=None, title=None, position=None, size=None, comm=None)#
Create a
Type.DRAW
viewer.Collective.
- Parameters:
display (str | None) – The X display to use or
None
for the local machine.position (tuple[int, int] | None) – Screen coordinates of the upper left corner, or
None
for default.size (tuple[int, int] | int | None) – Window size or
None
for default.comm (Comm | None) – MPI communicator, defaults to
Sys.getDefaultComm
.
- Return type:
See also
- createHDF5(name, mode=None, comm=None)#
Create a viewer of type
Type.HDF5
.Collective.
- Parameters:
- Return type:
Self
See also
create
,setType
,setFileMode
,setFileName
,Sys.getDefaultComm
- createMPIIO(name, mode=None, comm=None)#
Create a viewer of type
Type.BINARY
supporting MPI-IO.Collective.
- Parameters:
- Return type:
Self
See also
create
,setType
,setFileMode
,setFileName
,Sys.getDefaultComm
- createVTK(name, mode=None, comm=None)#
Create a viewer of type
Type.VTK
.Collective.
- Parameters:
- Return type:
Self
See also
create
,setType
,setFileMode
,setFileName
,Sys.getDefaultComm
- destroy()#
Destroy the viewer.
Collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:162
- Return type:
- flush()#
Flush the viewer.
Collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:780
- Return type:
- getASCIITab()#
Return the ASCII tab level.
Not collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:647
- Return type:
- getFileMode()#
Return the file mode.
Not collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:804
- Return type:
- getFileName()#
Return file name.
Not collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:832
- Return type:
- getFormat()#
Return the format of the viewer.
Not collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:459
- Return type:
- getSubViewer(comm=None)#
Return a viewer defined on a subcommunicator.
Collective.
Notes
Users must call
restoreSubViewer
when done.See also
- getType()#
Return the type of the viewer.
Not collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:445
- Return type:
- popASCIISynchronized()#
Disallow ASCII synchronized calls.
Collective.
Source code at petsc4py/PETSc/Viewer.pyx:700
- Return type:
- popASCIITab()#
Pop an additional tab level pushed via
pushASCIITab
.Collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:725
- Return type:
- popFormat()#
Pop format from the viewer.
Collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:485
- Return type:
- printfASCII(msg)#
Print a message.
Collective.
See also
- printfASCIISynchronized(msg)#
Print a synchronized message.
Collective.
- pushASCIISynchronized()#
Allow ASCII synchronized calls.
Collective.
Source code at petsc4py/PETSc/Viewer.pyx:687
- Return type:
- pushASCIITab()#
Push an additional tab level.
Collective.
See also
Source code at petsc4py/PETSc/Viewer.pyx:713
- Return type:
- pushFormat(format)#
Push format to the viewer.
Collective.
See also
- restoreSubViewer(sub)#
Restore a viewer defined on a subcommunicator.
Collective.
- Parameters:
sub (Viewer) – The subviewer obtained from
getSubViewer
.- Return type:
See also
- setASCIITab(tabs)#
Set ASCII tab level.
Collective.
See also
- setDrawInfo(display=None, title=None, position=None, size=None)#
Set window information for a
Type.DRAW
viewer.Collective.
- setFileMode(mode)#
Set file mode.
Collective.
See also
- setFileName(name)#
Set file name.
Collective.
See also
- setType(vwr_type)#
Set the type of the viewer.
Logically collective.
See also
- subtractASCIITab(tabs)#
Decrement the ASCII tab level.
Collective.
See also
- useASCIITabs(flag)#
Enable/disable the use of ASCII tabs.
Collective.
See also