petsc-dev 2014-04-19
Report Typos and Errors

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().

If a multiprocessor communicator is used (such as PETSC_COMM_WORLD), then only the first processor in the group opens the file. All other processors send their data to the first processor to print.

Each processor can instead write its own independent output by specifying the communicator PETSC_COMM_SELF.

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

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

See Also

MatView(), VecView(), PetscViewerDestroy(), PetscViewerBinaryOpen(),
PetscViewerASCIIGetPointer(), PetscViewerSetFormat(), PETSC_VIEWER_STDOUT_, PETSC_VIEWER_STDERR_, PETSC_VIEWER_STDOUT_WORLD, PETSC_VIEWER_STDOUT_SELF,

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

Examples

src/ksp/ksp/examples/tutorials/ex4.c.html
src/ksp/ksp/examples/tutorials/ex10.c.html
src/ksp/ksp/examples/tutorials/ex54.c.html
src/ksp/ksp/examples/tutorials/ex55.c.html
src/ksp/ksp/examples/tutorials/ex56.c.html
src/snes/examples/tutorials/ex15.c.html
src/snes/examples/tutorials/ex48.c.html
src/snes/examples/tutorials/ex61.c.html
src/snes/examples/tutorials/ex61view.c.html
src/snes/examples/tutorials/ex70.c.html
src/ts/examples/tutorials/ex9.c.html