1 /* $Id: petscviewer.h,v 1.85 2001/08/06 21:13:28 bsmith Exp $ */ 2 /* 3 PetscViewers are objects where other objects can be looked at or stored. 4 */ 5 6 #if !defined(__PETSCVIEWER_H) 7 #define __PETSCVIEWER_H 8 9 /*S 10 PetscViewer - Abstract PETSc object that helps view (in ASCII, binary, graphically etc) 11 other PETSc objects 12 13 Level: beginner 14 15 Concepts: viewing 16 17 .seealso: PetscViewerCreate(), PetscViewerSetType(), PetscViewerType 18 S*/ 19 typedef struct _p_PetscViewer* PetscViewer; 20 21 /* 22 petsc.h must be included AFTER the definition of PetscViewer for ADIC to 23 process correctly. 24 */ 25 #include "petsc.h" 26 27 #define PETSC_VIEWER_COOKIE PETSC_COOKIE+1 28 29 /*E 30 PetscViewerType - String with the name of a PETSc PETScViewer 31 32 Level: beginner 33 34 .seealso: PetscViewerSetType(), PetscViewer 35 E*/ 36 typedef char* PetscViewerType; 37 #define PETSC_VIEWER_SOCKET "socket" 38 #define PETSC_VIEWER_ASCII "ascii" 39 #define PETSC_VIEWER_BINARY "binary" 40 #define PETSC_VIEWER_STRING "string" 41 #define PETSC_VIEWER_DRAW "draw" 42 #define PETSC_VIEWER_AMS "ams" 43 #define PETSC_VIEWER_MATHEMATICA "mathematica" 44 #define PETSC_VIEWER_SILO "silo" 45 46 extern PetscFList PetscViewerList; 47 EXTERN int PetscViewerRegisterAll(char *); 48 EXTERN int PetscViewerRegisterDestroy(void); 49 50 EXTERN int PetscViewerRegister(char*,char*,char*,int(*)(PetscViewer)); 51 #if defined(PETSC_USE_DYNAMIC_LIBRARIES) 52 #define PetscViewerRegisterDynamic(a,b,c,d) PetscViewerRegister(a,b,c,0) 53 #else 54 #define PetscViewerRegisterDynamic(a,b,c,d) PetscViewerRegister(a,b,c,d) 55 #endif 56 EXTERN int PetscViewerCreate(MPI_Comm,PetscViewer*); 57 EXTERN int PetscViewerSetFromOptions(PetscViewer); 58 59 EXTERN int PetscViewerASCIIOpen(MPI_Comm,const char[],PetscViewer*); 60 typedef enum {PETSC_BINARY_RDONLY,PETSC_BINARY_WRONLY,PETSC_BINARY_CREATE} PetscViewerBinaryType; 61 EXTERN int PetscViewerBinaryOpen(MPI_Comm,const char[],PetscViewerBinaryType,PetscViewer*); 62 EXTERN int PetscViewerSocketOpen(MPI_Comm,const char[],int,PetscViewer*); 63 EXTERN int PetscViewerStringOpen(MPI_Comm,char[],int,PetscViewer*); 64 EXTERN int PetscViewerDrawOpen(MPI_Comm,const char[],const char[],int,int,int,int,PetscViewer*); 65 EXTERN int PetscViewerAMSSetCommName(PetscViewer,const char[]); 66 EXTERN int PetscViewerMathematicaOpen(MPI_Comm, int, const char[], const char[], PetscViewer *); 67 EXTERN int PetscViewerSiloOpen(MPI_Comm, const char[], PetscViewer *); 68 69 EXTERN int PetscViewerGetType(PetscViewer,PetscViewerType*); 70 EXTERN int PetscViewerSetType(PetscViewer,PetscViewerType); 71 EXTERN int PetscViewerDestroy(PetscViewer); 72 EXTERN int PetscViewerGetSingleton(PetscViewer,PetscViewer*); 73 EXTERN int PetscViewerRestoreSingleton(PetscViewer,PetscViewer*); 74 75 76 /*E 77 PetscViewerFormat - Way a viewer presents the object 78 79 Level: beginner 80 81 .seealso: PetscViewerSetFormat(), PetscViewer, PetscViewerType, PetscViewerPushFormat(), PetscViewerPopFormat() 82 E*/ 83 typedef enum { 84 PETSC_VIEWER_ASCII_DEFAULT, 85 PETSC_VIEWER_ASCII_MATLAB, 86 PETSC_VIEWER_ASCII_MATHEMATICA, 87 PETSC_VIEWER_ASCII_IMPL, 88 PETSC_VIEWER_ASCII_INFO, 89 PETSC_VIEWER_ASCII_INFO_LONG, 90 PETSC_VIEWER_ASCII_COMMON, 91 PETSC_VIEWER_ASCII_SYMMODU, 92 PETSC_VIEWER_ASCII_INDEX, 93 PETSC_VIEWER_ASCII_DENSE, 94 PETSC_VIEWER_BINARY_DEFAULT, 95 PETSC_VIEWER_BINARY_NATIVE, 96 PETSC_VIEWER_DRAW_BASIC, 97 PETSC_VIEWER_DRAW_LG, 98 PETSC_VIEWER_DRAW_CONTOUR, 99 PETSC_VIEWER_DRAW_PORTS, 100 PETSC_VIEWER_NATIVE, 101 PETSC_VIEWER_NOFORMAT} PetscViewerFormat; 102 103 EXTERN int PetscViewerSetFormat(PetscViewer,PetscViewerFormat); 104 EXTERN int PetscViewerPushFormat(PetscViewer,PetscViewerFormat); 105 EXTERN int PetscViewerPopFormat(PetscViewer); 106 EXTERN int PetscViewerGetFormat(PetscViewer,PetscViewerFormat*); 107 EXTERN int PetscViewerFlush(PetscViewer); 108 109 /* 110 Operations explicit to a particular class of viewers 111 */ 112 113 /*E 114 PetscViewerFormat - Access mode for a file. 115 116 Level: beginner 117 118 .seealso: PetscViewerASCIISetMode() 119 E*/ 120 typedef enum {FILE_MODE_READ, FILE_MODE_WRITE, FILE_MODE_APPEND, FILE_MODE_UPDATE, FILE_MODE_APPEND_UPDATE} PetscFileMode; 121 122 EXTERN int PetscViewerASCIIGetPointer(PetscViewer,FILE**); 123 EXTERN int PetscViewerASCIISetMode(PetscViewer,PetscFileMode); 124 EXTERN int PetscViewerASCIIPrintf(PetscViewer,const char[],...); 125 EXTERN int PetscViewerASCIISynchronizedPrintf(PetscViewer,const char[],...); 126 EXTERN int PetscViewerASCIIPushTab(PetscViewer); 127 EXTERN int PetscViewerASCIIPopTab(PetscViewer); 128 EXTERN int PetscViewerASCIIUseTabs(PetscViewer,PetscTruth); 129 EXTERN int PetscViewerASCIISetTab(PetscViewer,int); 130 EXTERN int PetscViewerBinaryGetDescriptor(PetscViewer,int*); 131 EXTERN int PetscViewerBinaryGetInfoPointer(PetscViewer,FILE **); 132 EXTERN int PetscViewerBinarySetType(PetscViewer,PetscViewerBinaryType); 133 EXTERN int PetscViewerStringSPrintf(PetscViewer,char *,...); 134 EXTERN int PetscViewerStringSetString(PetscViewer,char[],int); 135 EXTERN int PetscViewerDrawClear(PetscViewer); 136 EXTERN int PetscViewerDrawSetInfo(PetscViewer,const char[],const char[],int,int,int,int); 137 EXTERN int PetscViewerSocketSetConnection(PetscViewer,const char[],int); 138 EXTERN int PetscViewerBinarySkipInfo(PetscViewer); 139 140 EXTERN int PetscViewerSetFilename(PetscViewer,const char[]); 141 EXTERN int PetscViewerGetFilename(PetscViewer,char**); 142 143 EXTERN int ViewerMathematicaGetName(PetscViewer, char **); 144 EXTERN int ViewerMathematicaSetName(PetscViewer, const char []); 145 EXTERN int ViewerMathematicaClearName(PetscViewer); 146 EXTERN int ViewerMathematicaSkipPackets(PetscViewer, int); 147 #ifdef PETSC_HAVE_MATHEMATICA 148 EXTERN int ViewerMathematicaGetLink(PetscViewer, MLINK *); 149 #endif 150 151 EXTERN int ViewerSiloGetName(PetscViewer, char **); 152 EXTERN int ViewerSiloSetName(PetscViewer, const char []); 153 EXTERN int ViewerSiloClearName(PetscViewer); 154 EXTERN int ViewerSiloGetMeshName(PetscViewer, char **); 155 EXTERN int ViewerSiloSetMeshName(PetscViewer, const char []); 156 EXTERN int ViewerSiloClearMeshName(PetscViewer); 157 158 /* 159 These are all the default viewers that do not have 160 to be explicitly opened 161 */ 162 EXTERN PetscViewer PETSC_VIEWER_STDOUT_(MPI_Comm); 163 EXTERN PetscViewer PETSC_VIEWER_STDERR_(MPI_Comm); 164 EXTERN PetscViewer PETSC_VIEWER_DRAW_(MPI_Comm); 165 EXTERN PetscViewer PETSC_VIEWER_SOCKET_(MPI_Comm); 166 EXTERN PetscViewer PETSC_VIEWER_BINARY_(MPI_Comm); 167 EXTERN PetscViewer VIEWER_MATHEMATICA_WORLD_PRIVATE; 168 169 #define PETSC_VIEWER_STDOUT_SELF PETSC_VIEWER_STDOUT_(PETSC_COMM_SELF) 170 #define PETSC_VIEWER_STDOUT_WORLD PETSC_VIEWER_STDOUT_(PETSC_COMM_WORLD) 171 #define PETSC_VIEWER_STDERR_SELF PETSC_VIEWER_STDERR_(PETSC_COMM_SELF) 172 #define PETSC_VIEWER_STDERR_WORLD PETSC_VIEWER_STDERR_(PETSC_COMM_WORLD) 173 #define PETSC_VIEWER_DRAW_SELF PETSC_VIEWER_DRAW_(PETSC_COMM_SELF) 174 #define PETSC_VIEWER_DRAW_WORLD PETSC_VIEWER_DRAW_(PETSC_COMM_WORLD) 175 #define PETSC_VIEWER_SOCKET_WORLD PETSC_VIEWER_SOCKET_(PETSC_COMM_WORLD) 176 #define PETSC_VIEWER_SOCKET_SELF PETSC_VIEWER_SOCKET_(PETSC_COMM_SELF) 177 #define PETSC_VIEWER_BINARY_WORLD PETSC_VIEWER_BINARY_(PETSC_COMM_WORLD) 178 #define PETSC_VIEWER_BINARY_SELF PETSC_VIEWER_BINARY_(PETSC_COMM_SELF) 179 #define VIEWER_MATHEMATICA_WORLD (ViewerInitializeMathematicaWorld_Private(),VIEWER_MATHEMATICA_WORLD_PRIVATE) 180 181 /* 182 PetscViewer based on the ALICE Memory Snooper 183 */ 184 #if defined(PETSC_HAVE_AMS) 185 #include "ams.h" 186 EXTERN int PetscViewerAMSGetAMSComm(PetscViewer,AMS_Comm *); 187 EXTERN int PetscViewerAMSOpen(MPI_Comm,const char[],PetscViewer*); 188 EXTERN int PetscViewerAMSLock(PetscViewer); 189 EXTERN PetscViewer PETSC_VIEWER_AMS_(MPI_Comm); 190 EXTERN int PETSC_VIEWER_AMS_Destroy(MPI_Comm); 191 #define PETSC_VIEWER_AMS_WORLD PETSC_VIEWER_AMS_(PETSC_COMM_WORLD) 192 #endif 193 194 /* 195 PetscViewer utility routines used by PETSc that are not normally used 196 by users. 197 */ 198 EXTERN int PetscViewerSocketPutScalar(PetscViewer,int,int,PetscScalar*); 199 EXTERN int PetscViewerSocketPutReal(PetscViewer,int,int,PetscReal*); 200 EXTERN int PetscViewerSocketPutInt(PetscViewer,int,int*); 201 EXTERN int PetscViewerSocketPutSparse_Private(PetscViewer,int,int,int,PetscScalar*,int*,int *); 202 EXTERN int PetscViewerDestroyAMS_Private(void); 203 204 /*S 205 PetscViewers - Abstract collection of PetscViewers 206 207 Level: intermediate 208 209 Concepts: viewing 210 211 .seealso: PetscViewerCreate(), PetscViewerSetType(), PetscViewerType, PetscViewer, PetscViewersCreate(), 212 PetscViewersGetViewer() 213 S*/ 214 typedef struct _p_PetscViewers* PetscViewers; 215 EXTERN int PetscViewersCreate(MPI_Comm,PetscViewers*); 216 EXTERN int PetscViewersDestroy(PetscViewers); 217 EXTERN int PetscViewersGetViewer(PetscViewers,int,PetscViewer*); 218 219 #endif 220 221 222 223 224