petsc-3.10.5 2019-03-28

PetscViewerASCIIOpen

Opens an ASCII file as a PetscViewer.

Synopsis

#include "petscsys.h"   
PetscErrorCode  PetscViewerASCIIOpen(MPI_Comm comm,const char name[],PetscViewer *lab)

Collective on MPI_Comm

Input Parameters

	comm	- the communicator
	name	- the file name

Output Parameter

lab -the PetscViewer to use with the specified file

Notes

This PetscViewer can be destroyed with PetscViewerDestroy().

The MPI communicator used here must match that used by the object one is viewing. For example if the Mat was created with a PETSC_COMM_WORLD, then the Viewer must be created with PETSC_COMM_WORLD

As shown below, PetscViewerASCIIOpen() is useful in conjunction with MatView() and VecView()

     PetscViewerASCIIOpen(PETSC_COMM_WORLD,"mat.output",&viewer);
     MatView(matrix,viewer);

Level

beginner

Location

src/sys/classes/viewer/impls/ascii/vcreatea.c

Examples