petsc-3.9.4 2018-09-11

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.

Level

beginner

Location

src/sys/classes/viewer/impls/binary/binv.c

Examples