#include "petscmat.h" PetscErrorCode MatView(Mat mat,PetscViewer viewer)Collective on Mat
| mat | - the matrix | |
| viewer | - visualization context |
| PETSC_VIEWER_STDOUT_SELF | - for sequential matrices | |
| PETSC_VIEWER_STDOUT_WORLD | - for parallel matrices created on PETSC_COMM_WORLD | |
| PETSC_VIEWER_STDOUT_(comm) | - for matrices created on MPI communicator comm | |
| PETSC_VIEWER_DRAW_WORLD | - graphical display of nonzero structure |
The user can open alternative visualization contexts with
| PetscViewerASCIIOpen() | - Outputs matrix to a specified file | |
| PetscViewerBinaryOpen() | - Outputs matrix in binary to a specified file; corresponding input uses MatLoad() | |
| PetscViewerDrawOpen() | - Outputs nonzero matrix structure to an X window display | |
| PetscViewerSocketOpen() | - Outputs matrix to Socket viewer. Currently only the sequential dense and AIJ matrix types support the Socket viewer. |
The user can call PetscViewerPushFormat() to specify the output format of ASCII printed objects (when using PETSC_VIEWER_STDOUT_SELF, PETSC_VIEWER_STDOUT_WORLD and PetscViewerASCIIOpen). Available formats include
| PETSC_VIEWER_DEFAULT | - default, prints matrix contents | |
| PETSC_VIEWER_ASCII_MATLAB | - prints matrix contents in Matlab format | |
| PETSC_VIEWER_ASCII_DENSE | - prints entire matrix including zeros | |
| PETSC_VIEWER_ASCII_COMMON | - prints matrix contents, using a sparse format common among all matrix types | |
| PETSC_VIEWER_ASCII_IMPL | - prints matrix contents, using an implementation-specific format (which is in many cases the same as the default) | |
| PETSC_VIEWER_ASCII_INFO | - prints basic information about the matrix size and structure (not the matrix entries) | |
| PETSC_VIEWER_ASCII_INFO_DETAIL | - prints more detailed information about the matrix structure |
| -mat_view ::ascii_info | - Prints info on matrix at conclusion of MatAssemblyEnd() | |
| -mat_view ::ascii_info_detail | - Prints more detailed info | |
| -mat_view | - Prints matrix in ASCII format | |
| -mat_view ::ascii_matlab | - Prints matrix in Matlab format | |
| -mat_view draw | - PetscDraws nonzero structure of matrix, using MatView() and PetscDrawOpenX(). | |
| -display <name> | - Sets display name (default is host) | |
| -draw_pause <sec> | - Sets number of seconds to pause after display | |
| -mat_view socket | - Sends matrix to socket, can be accessed from Matlab (see Users-Manual: Chapter 12 Using MATLAB with PETSc for details) | |
| -viewer_socket_machine <machine> | - | |
| -viewer_socket_port <port> | - | |
| -mat_view binary | - save matrix to file in binary format | |
| -viewer_binary_filename <name> | - |
See the manual page for MatLoad() for the exact format of the binary file when the binary viewer is used.
See share/petsc/matlab/PetscBinaryRead.m for a Matlab code that can read in the binary file when the binary viewer is used and lib/petsc/bin/PetscBinaryIO.py for loading them into Python.
One can use '-mat_view draw -draw_pause -1' to pause the graphical display of matrix nonzero structure, and then use the following mouse functions.
| left mouse: zoom in | - . middle mouse: zoom out | |
| right mouse: continue with the simulation | - |