petsc-master 2015-11-25
Report Typos and Errors


Gets a viewer appropriate for the type indicated by the user


#include "petscviewer.h" 
PetscErrorCode  PetscOptionsGetViewer(MPI_Comm comm,const char pre[],const char name[],PetscViewer *viewer,PetscViewerFormat *format,PetscBool  *set)
Collective on MPI_Comm

Input Parameters

comm - the communicator to own the viewer
pre - the string to prepend to the name or NULL
name - the option one is seeking

Output Parameter

viewer - the viewer, pass NULL if not needed
format - the PetscViewerFormat requested by the user, pass NULL if not needed
set - PETSC_TRUE if found, else PETSC_FALSE

Notes: If no value is provided ascii:stdout is used

      ascii[:[filename][:[format][:append]]]    defaults to stdout - format can be one of ascii_info, ascii_info_detail, or ascii_matlab, 
for example ascii::ascii_info prints just the information about the object not all details unless :append is given filename opens in write mode, overwriting what was already there
      binary[:[filename][:[format][:append]]]   defaults to the file binaryoutput
      draw[:drawtype]                           for example, draw:tikz  or draw:x
      socket[:port]                             defaults to the standard output port
      saws[:communicatorname]                    publishes object to the Scientific Application Webserver (SAWs)

Use PetscViewerDestroy() after using the viewer, otherwise a memory leak will occur

See Also

PetscOptionsGetReal(), PetscOptionsHasName(), PetscOptionsGetString(),
PetscOptionsGetIntArray(), PetscOptionsGetRealArray(), PetscOptionsBool() PetscOptionsInt(), PetscOptionsString(), PetscOptionsReal(), PetscOptionsBool(), PetscOptionsName(), PetscOptionsBegin(), PetscOptionsEnd(), PetscOptionsHead(), PetscOptionsStringArray(),PetscOptionsRealArray(), PetscOptionsScalar(), PetscOptionsBoolGroupBegin(), PetscOptionsBoolGroup(), PetscOptionsBoolGroupEnd(), PetscOptionsFList(), PetscOptionsEList()

Index of all Viewer routines
Table of Contents for all manual pages
Index of all manual pages