#define PETSC_DLL #include "src/sys/viewer/viewerimpl.h" /*I "petsc.h" I*/ #undef __FUNCT__ #define __FUNCT__ "PetscViewerSetFormat" /*@C PetscViewerSetFormat - Sets the format for PetscViewers. Collective on PetscViewer Input Parameters: + viewer - the PetscViewer - format - the format Level: intermediate Notes: Available formats include + PETSC_VIEWER_ASCII_DEFAULT - default format . PETSC_VIEWER_ASCII_MATLAB - Matlab format . PETSC_VIEWER_ASCII_DENSE - print matrix as dense . 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_ASCII_SYMMODU - print parallel vectors without indicating the processor ranges . PETSC_VIEWER_BINARY_NATIVE - store the object to the binary file in its native format (for example, dense matrices are stored as dense) . 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 These formats are most often used for viewing matrices and vectors. If a format (for example PETSC_VIEWER_DRAW_CONTOUR) was applied to a viewer where it didn't apply (PETSC_VIEWER_STDOUT_WORLD) it cause the default behavior for that viewer to be used. Concepts: PetscViewer^setting format .seealso: PetscViewerASCIIOpen(), PetscViewerBinaryOpen(), MatView(), VecView(), PetscViewerPushFormat(), PetscViewerPopFormat(), PetscViewerDrawOpen(),PetscViewerSocketOpen() @*/ PetscErrorCode PETSC_DLLEXPORT PetscViewerSetFormat(PetscViewer viewer,PetscViewerFormat format) { PetscFunctionBegin; if (!viewer) viewer = PETSC_VIEWER_STDOUT_SELF; PetscValidHeaderSpecific(viewer,PETSC_VIEWER_COOKIE,1); CHKMEMQ; viewer->format = format; CHKMEMQ; PetscFunctionReturn(0); } #undef __FUNCT__ #define __FUNCT__ "PetscViewerPushFormat" /*@C PetscViewerPushFormat - Sets the format for file PetscViewers. Collective on PetscViewer Input Parameters: + viewer - the PetscViewer - format - the format Level: intermediate Notes: Available formats include + PETSC_VIEWER_ASCII_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_BINARY_NATIVE - store the object to the binary file in its native format (for example, dense matrices are stored as dense) . 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_NATIVE - for DA vectors displays vectors in DA ordering, not natural These formats are most often used for viewing matrices and vectors. Currently, the object name is used only in the Matlab format. Concepts: PetscViewer^setting format .seealso: PetscViewerASCIIOpen(), PetscViewerBinaryOpen(), MatView(), VecView(), PetscViewerSetFormat(), PetscViewerPopFormat() @*/ PetscErrorCode PETSC_DLLEXPORT PetscViewerPushFormat(PetscViewer viewer,PetscViewerFormat format) { PetscFunctionBegin; PetscValidHeaderSpecific(viewer,PETSC_VIEWER_COOKIE,1); if (viewer->iformat > 9) SETERRQ(PETSC_ERR_ARG_OUTOFRANGE,"Too many pushes"); viewer->formats[viewer->iformat++] = viewer->format; viewer->format = format; PetscFunctionReturn(0); } #undef __FUNCT__ #define __FUNCT__ "PetscViewerPopFormat" /*@C PetscViewerPopFormat - Resets the format for file PetscViewers. Collective on PetscViewer Input Parameters: . viewer - the PetscViewer Level: intermediate Concepts: PetscViewer^setting format .seealso: PetscViewerASCIIOpen(), PetscViewerBinaryOpen(), MatView(), VecView(), PetscViewerSetFormat(), PetscViewerPushFormat() @*/ PetscErrorCode PETSC_DLLEXPORT PetscViewerPopFormat(PetscViewer viewer) { PetscFunctionBegin; PetscValidHeaderSpecific(viewer,PETSC_VIEWER_COOKIE,1); if (viewer->iformat <= 0) PetscFunctionReturn(0); viewer->format = viewer->formats[--viewer->iformat]; PetscFunctionReturn(0); } #undef __FUNCT__ #define __FUNCT__ "PetscViewerGetFormat" PetscErrorCode PETSC_DLLEXPORT PetscViewerGetFormat(PetscViewer viewer,PetscViewerFormat *format) { PetscFunctionBegin; *format = viewer->format; PetscFunctionReturn(0); }