petsc-3.14.5 2021-03-03
Report Typos and Errors

# PetscViewerPushFormat

Sets the format for file PetscViewers.

### Synopsis

    #include "petscsys.h"
    PetscErrorCode  PetscViewerPushFormat(PetscViewer viewer,PetscViewerFormat format)

Logically Collective on PetscViewer

### Input Parameters

| viewer | - the PetscViewer
| format | - the format

### Notes

Available formats include

| PETSC_VIEWER_DEFAULT | - default format
| PETSC_VIEWER_ASCII_MATLAB | - MATLAB format
| PETSC_VIEWER_ASCII_IMPL | - implementation-specific format (which is in many cases the same as the default)
| PETSC_VIEWER_ASCII_INFO | - basic information about object
| PETSC_VIEWER_ASCII_INFO_DETAIL | - more detailed info about object
| PETSC_VIEWER_ASCII_COMMON | - identical output format for all objects of a particular type
| PETSC_VIEWER_ASCII_INDEX | - (for vectors) prints the vector element number next to each vector entry
| PETSC_VIEWER_NATIVE | - store the object to the binary file in its native format (for example, dense matrices are stored as dense), for DMDA vectors displays vectors in DMDA ordering, not natural
| PETSC_VIEWER_DRAW_BASIC | - views the vector with a simple 1d plot
| PETSC_VIEWER_DRAW_LG | - views the vector with a line graph
| PETSC_VIEWER_DRAW_CONTOUR | - views the vector with a contour plot
| PETSC_VIEWER_ASCII_XML | - saves the data in XML format, needed for PetscLogView() when viewing with PetscLogNestedBegin()

These formats are most often used for viewing matrices and vectors. Currently, the object name is used only in the MATLAB format.

### See Also

PetscViewerASCIIOpen(), PetscViewerBinaryOpen(), MatView(), VecView(),
PetscViewerSetFormat(), PetscViewerPopFormat()

### Level

intermediate

### Location

src/sys/classes/viewer/interface/viewa.c

### Examples

src/sys/classes/viewer/tutorials/ex2.c.html
src/vec/vec/tutorials/ex3.c.html
src/vec/is/sf/tutorials/ex1.c.html
src/vec/is/sf/tutorials/ex1f.F90.html
src/mat/tutorials/ex10.c.html
src/dm/impls/plex/tutorials/ex5.c.html
src/dm/tutorials/ex7.c.html
src/ksp/ksp/tutorials/ex27.c.html
src/ksp/ksp/tutorials/ex34.c.html
src/ksp/ksp/tutorials/ex54.c.html
src/ksp/ksp/tutorials/ex55.c.html
Index of all Viewer routines
Table of Contents for all manual pages
Index of all manual pages