petsc-3.8.4 2018-03-24
Report Typos and Errors

PetscViewerBinaryOpen

Opens a file for binary input/output.

Synopsis

#include "petscviewer.h"   
PetscErrorCode PetscViewerBinaryOpen(MPI_Comm comm,const char name[],PetscFileMode type,PetscViewer *binv)
Collective on MPI_Comm

Input Parameters

comm - MPI communicator
name - name of file
type - type of file
   FILE_MODE_WRITE - create new file for binary output
   FILE_MODE_READ - open existing file for binary input
   FILE_MODE_APPEND - open existing file for binary output

Output Parameter

binv -PetscViewer for binary input/output to use with the specified file

Options Database Keys

-viewer_binary_filename <name>- . -viewer_binary_skip_info
-viewer_binary_skip_options- . -viewer_binary_skip_header
-viewer_binary_mpiio-

Note

This PetscViewer should be destroyed with PetscViewerDestroy().

For reading files, the filename may begin with ftp:// or http:// and/or end with .gz; in this case file is brought over and uncompressed.

For creating files, if the file name ends with .gz it is automatically compressed when closed.

For writing files it only opens the file on processor 0 in the communicator. For readable files it opens the file on all nodes that have the file. If node 0 does not have the file it generates an error even if other nodes do have the file.

See Also

PetscViewerASCIIOpen(), PetscViewerPushFormat(), PetscViewerDestroy(),
VecView(), MatView(), VecLoad(), MatLoad(), PetscViewerBinaryGetDescriptor(), PetscViewerBinaryGetInfoPointer(), PetscFileMode, PetscViewer, PetscViewerBinaryRead(), PetscViewerBinarySetUseMPIIO(), PetscViewerBinaryGetUseMPIIO(), PetscViewerBinaryGetMPIIOOffset()

Level:beginner
Location:
src/sys/classes/viewer/impls/binary/binv.c
Index of all Viewer routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/sys/classes/viewer/examples/tutorials/ex1f90.F90.html
src/sys/examples/tutorials/ex5.c.html
src/sys/examples/tutorials/ex5f90.F90.html
src/vec/vec/examples/tutorials/ex5.c.html
src/vec/vec/examples/tutorials/ex6.c.html
src/vec/vec/examples/tutorials/ex10.c.html
src/mat/examples/tutorials/ex1.c.html
src/mat/examples/tutorials/ex5.c.html
src/mat/examples/tutorials/ex9.c.html
src/mat/examples/tutorials/ex10.c.html
src/mat/examples/tutorials/ex12.c.html