1 /* 2 PetscViewers are objects where other objects can be looked at or stored. 3 */ 4 #if !defined(PETSCVIEWER_H) 5 #define PETSCVIEWER_H 6 7 #include <petscsys.h> 8 #include <petscviewertypes.h> 9 #include <petscdrawtypes.h> 10 11 /* SUBMANSEC = Viewer */ 12 13 PETSC_EXTERN PetscClassId PETSC_VIEWER_CLASSID; 14 15 /*J 16 PetscViewerType - String with the name of a PETSc PETScViewer 17 18 Level: beginner 19 20 .seealso: `PetscViewerSetType()`, `PetscViewer`, `PetscViewerRegister()`, `PetscViewerCreate()` 21 J*/ 22 typedef const char* PetscViewerType; 23 #define PETSCVIEWERSOCKET "socket" 24 #define PETSCVIEWERASCII "ascii" 25 #define PETSCVIEWERBINARY "binary" 26 #define PETSCVIEWERSTRING "string" 27 #define PETSCVIEWERDRAW "draw" 28 #define PETSCVIEWERVU "vu" 29 #define PETSCVIEWERMATHEMATICA "mathematica" 30 #define PETSCVIEWERHDF5 "hdf5" 31 #define PETSCVIEWERVTK "vtk" 32 #define PETSCVIEWERMATLAB "matlab" 33 #define PETSCVIEWERSAWS "saws" 34 #define PETSCVIEWERGLVIS "glvis" 35 #define PETSCVIEWERADIOS "adios" 36 #define PETSCVIEWEREXODUSII "exodusii" 37 38 PETSC_EXTERN PetscFunctionList PetscViewerList; 39 PETSC_EXTERN PetscErrorCode PetscViewerInitializePackage(void); 40 41 PETSC_EXTERN PetscErrorCode PetscViewerRegister(const char[],PetscErrorCode (*)(PetscViewer)); 42 43 PETSC_EXTERN PetscErrorCode PetscViewerCreate(MPI_Comm,PetscViewer*); 44 PETSC_EXTERN PetscErrorCode PetscViewerSetFromOptions(PetscViewer); 45 PETSC_EXTERN PetscErrorCode PetscViewerASCIIOpenWithFILE(MPI_Comm,FILE*,PetscViewer*); 46 47 PETSC_EXTERN PetscErrorCode PetscViewerASCIIOpen(MPI_Comm,const char[],PetscViewer*); 48 PETSC_EXTERN PetscErrorCode PetscViewerASCIISetFILE(PetscViewer,FILE*); 49 PETSC_EXTERN PetscErrorCode PetscViewerBinaryOpen(MPI_Comm,const char[],PetscFileMode,PetscViewer*); 50 PETSC_EXTERN PetscErrorCode PetscViewerADIOSOpen(MPI_Comm,const char[],PetscFileMode,PetscViewer*); 51 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetFlowControl(PetscViewer,PetscInt*); 52 PETSC_EXTERN PetscErrorCode PetscViewerBinarySetFlowControl(PetscViewer,PetscInt); 53 PETSC_EXTERN PetscErrorCode PetscViewerBinarySetUseMPIIO(PetscViewer,PetscBool); 54 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetUseMPIIO(PetscViewer,PetscBool *); 55 #if defined(PETSC_HAVE_MPIIO) 56 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetMPIIODescriptor(PetscViewer,MPI_File*); 57 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetMPIIOOffset(PetscViewer,MPI_Offset*); 58 PETSC_EXTERN PetscErrorCode PetscViewerBinaryAddMPIIOOffset(PetscViewer,MPI_Offset); 59 #endif 60 61 PETSC_EXTERN PetscErrorCode PetscViewerSocketOpen(MPI_Comm,const char[],int,PetscViewer*); 62 PETSC_EXTERN PetscErrorCode PetscViewerStringOpen(MPI_Comm,char[],size_t,PetscViewer*); 63 PETSC_EXTERN PetscErrorCode PetscViewerDrawOpen(MPI_Comm,const char[],const char[],int,int,int,int,PetscViewer*); 64 PETSC_EXTERN PetscErrorCode PetscViewerDrawSetDrawType(PetscViewer,PetscDrawType); 65 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetDrawType(PetscViewer,PetscDrawType*); 66 PETSC_EXTERN PetscErrorCode PetscViewerDrawSetTitle(PetscViewer,const char[]); 67 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetTitle(PetscViewer,const char*[]); 68 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetDraw(PetscViewer,PetscInt,PetscDraw*); 69 PETSC_EXTERN PetscErrorCode PetscViewerDrawBaseAdd(PetscViewer,PetscInt); 70 PETSC_EXTERN PetscErrorCode PetscViewerDrawBaseSet(PetscViewer,PetscInt); 71 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetDrawLG(PetscViewer,PetscInt,PetscDrawLG*); 72 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetDrawAxis(PetscViewer,PetscInt,PetscDrawAxis*); 73 74 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaOpen(MPI_Comm, int, const char[], const char[], PetscViewer *); 75 PETSC_EXTERN PetscErrorCode PetscViewerSiloOpen(MPI_Comm, const char[], PetscViewer *); 76 PETSC_EXTERN PetscErrorCode PetscViewerMatlabOpen(MPI_Comm,const char[],PetscFileMode,PetscViewer*); 77 78 /*E 79 PetscViewerGLVisType - indicates what type of GLVis viewer to use 80 81 Level: beginner 82 83 .seealso: `PetscViewerGLVisOpen()` 84 E*/ 85 typedef enum {PETSC_VIEWER_GLVIS_DUMP, PETSC_VIEWER_GLVIS_SOCKET} PetscViewerGLVisType; 86 PETSC_EXTERN PetscErrorCode PetscViewerGLVisOpen(MPI_Comm,PetscViewerGLVisType,const char*,PetscInt,PetscViewer*); 87 PETSC_EXTERN PetscErrorCode PetscViewerGLVisSetPrecision(PetscViewer,PetscInt); 88 PETSC_EXTERN PetscErrorCode PetscViewerGLVisSetSnapId(PetscViewer,PetscInt); 89 PETSC_EXTERN PetscErrorCode PetscViewerGLVisSetFields(PetscViewer,PetscInt,const char*[],PetscInt[],PetscErrorCode(*)(PetscObject,PetscInt,PetscObject[],void*),PetscObject[],void*,PetscErrorCode(*)(void*)); 90 91 PETSC_EXTERN PetscErrorCode PetscViewerGetType(PetscViewer,PetscViewerType*); 92 PETSC_EXTERN PetscErrorCode PetscViewerSetType(PetscViewer,PetscViewerType); 93 PETSC_EXTERN PetscErrorCode PetscViewerDestroy(PetscViewer*); 94 PETSC_EXTERN PetscErrorCode PetscViewerGetSubViewer(PetscViewer,MPI_Comm,PetscViewer*); 95 PETSC_EXTERN PetscErrorCode PetscViewerRestoreSubViewer(PetscViewer,MPI_Comm,PetscViewer*); 96 97 PETSC_EXTERN PetscErrorCode PetscViewerSetUp(PetscViewer); 98 PETSC_EXTERN PetscErrorCode PetscViewerView(PetscViewer,PetscViewer); 99 PETSC_EXTERN PetscErrorCode PetscViewerViewFromOptions(PetscViewer,PetscObject,const char[]); 100 101 PETSC_EXTERN PetscErrorCode PetscViewerSetOptionsPrefix(PetscViewer,const char[]); 102 PETSC_EXTERN PetscErrorCode PetscViewerAppendOptionsPrefix(PetscViewer,const char[]); 103 PETSC_EXTERN PetscErrorCode PetscViewerGetOptionsPrefix(PetscViewer,const char*[]); 104 105 PETSC_EXTERN PetscErrorCode PetscViewerReadable(PetscViewer,PetscBool*); 106 PETSC_EXTERN PetscErrorCode PetscViewerWritable(PetscViewer,PetscBool*); 107 PETSC_EXTERN PetscErrorCode PetscViewerCheckReadable(PetscViewer); 108 PETSC_EXTERN PetscErrorCode PetscViewerCheckWritable(PetscViewer); 109 110 #define PETSC_VIEWER_ASCII_VTK_ATTR PETSC_VIEWER_ASCII_VTK PETSC_DEPRECATED_ENUM("Legacy VTK deprecated; use PetscViewerVTKOpen() with XML (.vtr .vts .vtu) format (since 3.14)") 111 #define PETSC_VIEWER_ASCII_VTK_CELL_ATTR PETSC_VIEWER_ASCII_VTK_CELL PETSC_DEPRECATED_ENUM("Legacy VTK deprecated; use PetscViewerVTKOpen() with XML (.vtr .vts .vtu) format (since 3.14)") 112 #define PETSC_VIEWER_ASCII_VTK_COORDS_ATTR PETSC_VIEWER_ASCII_VTK_COORDS PETSC_DEPRECATED_ENUM("Legacy VTK deprecated; use PetscViewerVTKOpen() with XML (.vtr .vts .vtu) format (since 3.14)") 113 /*E 114 PetscViewerFormat - Way a viewer presents the object 115 116 Level: beginner 117 118 .seealso: `PetscViewer`, `PetscViewerType`, `PetscViewerPushFormat()`, `PetscViewerPopFormat()` 119 E*/ 120 typedef enum { 121 PETSC_VIEWER_DEFAULT, 122 PETSC_VIEWER_ASCII_MATLAB, 123 PETSC_VIEWER_ASCII_MATHEMATICA, 124 PETSC_VIEWER_ASCII_IMPL, 125 PETSC_VIEWER_ASCII_INFO, 126 PETSC_VIEWER_ASCII_INFO_DETAIL, 127 PETSC_VIEWER_ASCII_COMMON, 128 PETSC_VIEWER_ASCII_SYMMODU, 129 PETSC_VIEWER_ASCII_INDEX, 130 PETSC_VIEWER_ASCII_DENSE, 131 PETSC_VIEWER_ASCII_MATRIXMARKET, 132 PETSC_VIEWER_ASCII_VTK_DEPRECATED, 133 PETSC_VIEWER_ASCII_VTK_ATTR = PETSC_VIEWER_ASCII_VTK_DEPRECATED, 134 PETSC_VIEWER_ASCII_VTK_CELL_DEPRECATED, 135 PETSC_VIEWER_ASCII_VTK_CELL_ATTR = PETSC_VIEWER_ASCII_VTK_CELL_DEPRECATED, 136 PETSC_VIEWER_ASCII_VTK_COORDS_DEPRECATED, 137 PETSC_VIEWER_ASCII_VTK_COORDS_ATTR = PETSC_VIEWER_ASCII_VTK_COORDS_DEPRECATED, 138 PETSC_VIEWER_ASCII_PCICE, 139 PETSC_VIEWER_ASCII_PYTHON, 140 PETSC_VIEWER_ASCII_FACTOR_INFO, 141 PETSC_VIEWER_ASCII_LATEX, 142 PETSC_VIEWER_ASCII_XML, 143 PETSC_VIEWER_ASCII_FLAMEGRAPH, 144 PETSC_VIEWER_ASCII_GLVIS, 145 PETSC_VIEWER_ASCII_CSV, 146 PETSC_VIEWER_DRAW_BASIC, 147 PETSC_VIEWER_DRAW_LG, 148 PETSC_VIEWER_DRAW_LG_XRANGE, 149 PETSC_VIEWER_DRAW_CONTOUR, 150 PETSC_VIEWER_DRAW_PORTS, 151 PETSC_VIEWER_VTK_VTS, 152 PETSC_VIEWER_VTK_VTR, 153 PETSC_VIEWER_VTK_VTU, 154 PETSC_VIEWER_BINARY_MATLAB, 155 PETSC_VIEWER_NATIVE, 156 PETSC_VIEWER_HDF5_PETSC, 157 PETSC_VIEWER_HDF5_VIZ, 158 PETSC_VIEWER_HDF5_XDMF, 159 PETSC_VIEWER_HDF5_MAT, 160 PETSC_VIEWER_NOFORMAT, 161 PETSC_VIEWER_LOAD_BALANCE, 162 PETSC_VIEWER_FAILED, 163 PETSC_VIEWER_ALL 164 } PetscViewerFormat; 165 PETSC_EXTERN const char *const PetscViewerFormats[]; 166 167 PETSC_EXTERN PETSC_DEPRECATED_FUNCTION("Use PetscViewerPushFormat()/PetscViewerPopFormat()") PetscErrorCode PetscViewerSetFormat(PetscViewer,PetscViewerFormat); 168 PETSC_EXTERN PetscErrorCode PetscViewerPushFormat(PetscViewer,PetscViewerFormat); 169 PETSC_EXTERN PetscErrorCode PetscViewerPopFormat(PetscViewer); 170 PETSC_EXTERN PetscErrorCode PetscViewerGetFormat(PetscViewer,PetscViewerFormat*); 171 PETSC_EXTERN PetscErrorCode PetscViewerFlush(PetscViewer); 172 173 PETSC_EXTERN PetscErrorCode PetscOptionsPushGetViewerOff(PetscBool); 174 PETSC_EXTERN PetscErrorCode PetscOptionsPopGetViewerOff(void); 175 PETSC_EXTERN PetscErrorCode PetscOptionsGetViewerOff(PetscBool*); 176 PETSC_EXTERN PetscErrorCode PetscOptionsGetViewer(MPI_Comm,PetscOptions,const char[],const char[],PetscViewer*,PetscViewerFormat*,PetscBool*); 177 #define PetscOptionsViewer(a,b,c,d,e,f) PetscOptionsViewer_Private(PetscOptionsObject,a,b,c,d,e,f) 178 PETSC_EXTERN PetscErrorCode PetscOptionsViewer_Private(PetscOptionItems*,const char[],const char[],const char[],PetscViewer*,PetscViewerFormat *,PetscBool *); 179 180 typedef struct {PetscViewer viewer;PetscViewerFormat format;PetscDrawLG lg;void *data;} PetscViewerAndFormat; 181 PETSC_EXTERN PetscErrorCode PetscViewerAndFormatCreate(PetscViewer,PetscViewerFormat,PetscViewerAndFormat**); 182 PETSC_EXTERN PetscErrorCode PetscViewerAndFormatDestroy(PetscViewerAndFormat**); 183 184 /* 185 Operations explicit to a particular class of viewers 186 */ 187 188 PETSC_EXTERN PetscErrorCode PetscViewerASCIIGetPointer(PetscViewer,FILE**); 189 PETSC_EXTERN PetscErrorCode PetscViewerFileGetMode(PetscViewer,PetscFileMode*); 190 PETSC_EXTERN PetscErrorCode PetscViewerFileSetMode(PetscViewer,PetscFileMode); 191 PETSC_EXTERN PetscErrorCode PetscViewerRead(PetscViewer,void*,PetscInt,PetscInt*,PetscDataType); 192 PETSC_EXTERN PetscErrorCode PetscViewerASCIIPrintf(PetscViewer,const char[],...) PETSC_ATTRIBUTE_FORMAT(2,3); 193 PETSC_EXTERN PetscErrorCode PetscViewerASCIISynchronizedPrintf(PetscViewer,const char[],...) PETSC_ATTRIBUTE_FORMAT(2,3); 194 PETSC_EXTERN PetscErrorCode PetscViewerASCIIPushSynchronized(PetscViewer); 195 PETSC_EXTERN PetscErrorCode PetscViewerASCIIPopSynchronized(PetscViewer); 196 PETSC_EXTERN PetscErrorCode PetscViewerASCIIPushTab(PetscViewer); 197 PETSC_EXTERN PetscErrorCode PetscViewerASCIIPopTab(PetscViewer); 198 PETSC_EXTERN PetscErrorCode PetscViewerASCIIUseTabs(PetscViewer,PetscBool); 199 PETSC_EXTERN PetscErrorCode PetscViewerASCIISetTab(PetscViewer,PetscInt); 200 PETSC_EXTERN PetscErrorCode PetscViewerASCIIGetTab(PetscViewer,PetscInt*); 201 PETSC_EXTERN PetscErrorCode PetscViewerASCIIAddTab(PetscViewer,PetscInt); 202 PETSC_EXTERN PetscErrorCode PetscViewerASCIISubtractTab(PetscViewer,PetscInt); 203 PETSC_EXTERN PetscErrorCode PetscViewerASCIIRead(PetscViewer,void *,PetscInt,PetscInt*,PetscDataType); 204 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetDescriptor(PetscViewer,int*); 205 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetInfoPointer(PetscViewer,FILE **); 206 PETSC_EXTERN PetscErrorCode PetscViewerBinaryRead(PetscViewer,void*,PetscInt,PetscInt*,PetscDataType); 207 PETSC_EXTERN PetscErrorCode PetscViewerBinaryWrite(PetscViewer,const void*,PetscInt,PetscDataType); 208 PETSC_EXTERN PetscErrorCode PetscViewerBinaryReadAll(PetscViewer,void*,PetscInt,PetscInt,PetscInt,PetscDataType); 209 PETSC_EXTERN PetscErrorCode PetscViewerBinaryWriteAll(PetscViewer,const void*,PetscInt,PetscInt,PetscInt,PetscDataType); 210 PETSC_EXTERN PetscErrorCode PetscViewerStringSPrintf(PetscViewer,const char[],...) PETSC_ATTRIBUTE_FORMAT(2,3); 211 PETSC_EXTERN PetscErrorCode PetscViewerStringSetString(PetscViewer,char[],size_t); 212 PETSC_EXTERN PetscErrorCode PetscViewerStringGetStringRead(PetscViewer,const char*[],size_t*); 213 PETSC_EXTERN PetscErrorCode PetscViewerStringSetOwnString(PetscViewer); 214 PETSC_EXTERN PetscErrorCode PetscViewerDrawClear(PetscViewer); 215 PETSC_EXTERN PetscErrorCode PetscViewerDrawSetHold(PetscViewer,PetscBool); 216 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetHold(PetscViewer,PetscBool*); 217 PETSC_EXTERN PetscErrorCode PetscViewerDrawSetPause(PetscViewer,PetscReal); 218 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetPause(PetscViewer,PetscReal*); 219 PETSC_EXTERN PetscErrorCode PetscViewerDrawSetInfo(PetscViewer,const char[],const char[],int,int,int,int); 220 PETSC_EXTERN PetscErrorCode PetscViewerDrawResize(PetscViewer,int,int); 221 PETSC_EXTERN PetscErrorCode PetscViewerDrawSetBounds(PetscViewer,PetscInt,const PetscReal*); 222 PETSC_EXTERN PetscErrorCode PetscViewerDrawGetBounds(PetscViewer,PetscInt*,const PetscReal**); 223 PETSC_EXTERN PetscErrorCode PetscViewerSocketSetConnection(PetscViewer,const char[],int); 224 PETSC_EXTERN PetscErrorCode PetscViewerBinarySkipInfo(PetscViewer); 225 PETSC_EXTERN PetscErrorCode PetscViewerBinarySetSkipInfo(PetscViewer,PetscBool); 226 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetSkipInfo(PetscViewer,PetscBool*); 227 PETSC_EXTERN PetscErrorCode PetscViewerBinarySetSkipOptions(PetscViewer,PetscBool); 228 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetSkipOptions(PetscViewer,PetscBool *); 229 PETSC_EXTERN PetscErrorCode PetscViewerBinarySetSkipHeader(PetscViewer,PetscBool); 230 PETSC_EXTERN PetscErrorCode PetscViewerBinaryGetSkipHeader(PetscViewer,PetscBool*); 231 PETSC_EXTERN PetscErrorCode PetscViewerBinaryReadStringArray(PetscViewer,char***); 232 PETSC_EXTERN PetscErrorCode PetscViewerBinaryWriteStringArray(PetscViewer,const char *const*); 233 234 PETSC_EXTERN PetscErrorCode PetscViewerFileSetName(PetscViewer,const char[]); 235 PETSC_EXTERN PetscErrorCode PetscViewerFileGetName(PetscViewer,const char**); 236 237 PETSC_EXTERN PetscErrorCode PetscViewerVUGetPointer(PetscViewer, FILE**); 238 PETSC_EXTERN PetscErrorCode PetscViewerVUSetVecSeen(PetscViewer, PetscBool); 239 PETSC_EXTERN PetscErrorCode PetscViewerVUGetVecSeen(PetscViewer, PetscBool *); 240 PETSC_EXTERN PetscErrorCode PetscViewerVUPrintDeferred(PetscViewer, const char [], ...) PETSC_ATTRIBUTE_FORMAT(2,3); 241 PETSC_EXTERN PetscErrorCode PetscViewerVUFlushDeferred(PetscViewer); 242 243 /*@C 244 PetscViewerVUSetMode - Sets the mode in which to open the file. 245 246 Not Collective 247 248 Input Parameters: 249 + viewer - The PetscViewer 250 - mode - The file mode 251 252 Level: deprecated 253 254 Note: 255 Use PetscViewerFileSetMode() instead. 256 257 .seealso: `PetscViewerFileSetMode()` 258 @*/ 259 PETSC_DEPRECATED_FUNCTION("Use PetscViewerFileSetMode (since v3.15)") static inline PetscErrorCode PetscViewerVUSetMode(PetscViewer viewer, PetscFileMode mode) {return PetscViewerFileSetMode(viewer, mode);} 260 261 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaInitializePackage(void); 262 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaFinalizePackage(void); 263 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaGetName(PetscViewer, const char **); 264 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaSetName(PetscViewer, const char []); 265 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaClearName(PetscViewer); 266 PETSC_EXTERN PetscErrorCode PetscViewerMathematicaSkipPackets(PetscViewer, int); 267 268 PETSC_EXTERN PetscErrorCode PetscViewerSiloGetName(PetscViewer, char **); 269 PETSC_EXTERN PetscErrorCode PetscViewerSiloSetName(PetscViewer, const char []); 270 PETSC_EXTERN PetscErrorCode PetscViewerSiloClearName(PetscViewer); 271 PETSC_EXTERN PetscErrorCode PetscViewerSiloGetMeshName(PetscViewer, char **); 272 PETSC_EXTERN PetscErrorCode PetscViewerSiloSetMeshName(PetscViewer, const char []); 273 PETSC_EXTERN PetscErrorCode PetscViewerSiloClearMeshName(PetscViewer); 274 275 typedef enum {PETSC_VTK_INVALID, PETSC_VTK_POINT_FIELD, PETSC_VTK_POINT_VECTOR_FIELD, PETSC_VTK_CELL_FIELD, PETSC_VTK_CELL_VECTOR_FIELD} PetscViewerVTKFieldType; 276 PETSC_EXTERN PetscErrorCode PetscViewerVTKAddField(PetscViewer,PetscObject,PetscErrorCode (*PetscViewerVTKWriteFunction)(PetscObject,PetscViewer),PetscInt,PetscViewerVTKFieldType,PetscBool,PetscObject); 277 PETSC_EXTERN PetscErrorCode PetscViewerVTKGetDM(PetscViewer,PetscObject*); 278 PETSC_EXTERN PetscErrorCode PetscViewerVTKOpen(MPI_Comm,const char[],PetscFileMode,PetscViewer*); 279 280 /* 281 These are all the default viewers that do not have to be explicitly opened 282 */ 283 PETSC_EXTERN PetscViewer PETSC_VIEWER_STDOUT_(MPI_Comm); 284 PETSC_EXTERN PetscErrorCode PetscViewerASCIIGetStdout(MPI_Comm,PetscViewer*); 285 PETSC_EXTERN PetscViewer PETSC_VIEWER_STDERR_(MPI_Comm); 286 PETSC_EXTERN PetscErrorCode PetscViewerASCIIGetStderr(MPI_Comm,PetscViewer*); 287 PETSC_EXTERN PetscViewer PETSC_VIEWER_DRAW_(MPI_Comm); 288 PETSC_EXTERN PetscViewer PETSC_VIEWER_SOCKET_(MPI_Comm); 289 PETSC_EXTERN PetscViewer PETSC_VIEWER_BINARY_(MPI_Comm); 290 PETSC_EXTERN PetscViewer PETSC_VIEWER_MATLAB_(MPI_Comm); 291 PETSC_EXTERN PetscViewer PETSC_VIEWER_HDF5_(MPI_Comm); 292 PETSC_EXTERN PetscViewer PETSC_VIEWER_GLVIS_(MPI_Comm); 293 PETSC_EXTERN PetscViewer PETSC_VIEWER_EXODUSII_(MPI_Comm); 294 PETSC_EXTERN PetscViewer PETSC_VIEWER_MATHEMATICA_WORLD_PRIVATE; 295 296 /*MC 297 PETSC_VIEWER_STDERR_SELF - same as PETSC_VIEWER_STDERR_(PETSC_COMM_SELF) 298 299 Level: beginner 300 M*/ 301 #define PETSC_VIEWER_STDERR_SELF PETSC_VIEWER_STDERR_(PETSC_COMM_SELF) 302 303 /*MC 304 PETSC_VIEWER_STDERR_WORLD - same as PETSC_VIEWER_STDERR_(PETSC_COMM_WORLD) 305 306 Level: beginner 307 M*/ 308 #define PETSC_VIEWER_STDERR_WORLD PETSC_VIEWER_STDERR_(PETSC_COMM_WORLD) 309 310 /*MC 311 PETSC_VIEWER_STDOUT_WORLD - same as PETSC_VIEWER_STDOUT_(PETSC_COMM_WORLD) 312 313 Level: beginner 314 M*/ 315 #define PETSC_VIEWER_STDOUT_WORLD PETSC_VIEWER_STDOUT_(PETSC_COMM_WORLD) 316 317 /*MC 318 PETSC_VIEWER_STDOUT_SELF - same as PETSC_VIEWER_STDOUT_(PETSC_COMM_SELF) 319 320 Level: beginner 321 M*/ 322 #define PETSC_VIEWER_STDOUT_SELF PETSC_VIEWER_STDOUT_(PETSC_COMM_SELF) 323 324 /*MC 325 PETSC_VIEWER_DRAW_WORLD - same as PETSC_VIEWER_DRAW_(PETSC_COMM_WORLD) 326 327 Level: intermediate 328 M*/ 329 #define PETSC_VIEWER_DRAW_WORLD PETSC_VIEWER_DRAW_(PETSC_COMM_WORLD) 330 331 /*MC 332 PETSC_VIEWER_DRAW_SELF - same as PETSC_VIEWER_DRAW_(PETSC_COMM_SELF) 333 334 Level: intermediate 335 M*/ 336 #define PETSC_VIEWER_DRAW_SELF PETSC_VIEWER_DRAW_(PETSC_COMM_SELF) 337 338 /*MC 339 PETSC_VIEWER_SOCKET_WORLD - same as PETSC_VIEWER_SOCKET_(PETSC_COMM_WORLD) 340 341 Level: intermediate 342 M*/ 343 #define PETSC_VIEWER_SOCKET_WORLD PETSC_VIEWER_SOCKET_(PETSC_COMM_WORLD) 344 345 /*MC 346 PETSC_VIEWER_SOCKET_SELF - same as PETSC_VIEWER_SOCKET_(PETSC_COMM_SELF) 347 348 Level: intermediate 349 M*/ 350 #define PETSC_VIEWER_SOCKET_SELF PETSC_VIEWER_SOCKET_(PETSC_COMM_SELF) 351 352 /*MC 353 PETSC_VIEWER_BINARY_WORLD - same as PETSC_VIEWER_BINARY_(PETSC_COMM_WORLD) 354 355 Level: intermediate 356 M*/ 357 #define PETSC_VIEWER_BINARY_WORLD PETSC_VIEWER_BINARY_(PETSC_COMM_WORLD) 358 359 /*MC 360 PETSC_VIEWER_BINARY_SELF - same as PETSC_VIEWER_BINARY_(PETSC_COMM_SELF) 361 362 Level: intermediate 363 M*/ 364 #define PETSC_VIEWER_BINARY_SELF PETSC_VIEWER_BINARY_(PETSC_COMM_SELF) 365 366 /*MC 367 PETSC_VIEWER_MATLAB_WORLD - same as PETSC_VIEWER_MATLAB_(PETSC_COMM_WORLD) 368 369 Level: intermediate 370 M*/ 371 #define PETSC_VIEWER_MATLAB_WORLD PETSC_VIEWER_MATLAB_(PETSC_COMM_WORLD) 372 373 /*MC 374 PETSC_VIEWER_MATLAB_SELF - same as PETSC_VIEWER_MATLAB_(PETSC_COMM_SELF) 375 376 Level: intermediate 377 M*/ 378 #define PETSC_VIEWER_MATLAB_SELF PETSC_VIEWER_MATLAB_(PETSC_COMM_SELF) 379 380 #define PETSC_VIEWER_MATHEMATICA_WORLD (PetscViewerInitializeMathematicaWorld_Private(),PETSC_VIEWER_MATHEMATICA_WORLD_PRIVATE) 381 382 PETSC_EXTERN PetscErrorCode PetscViewerFlowControlStart(PetscViewer,PetscInt*,PetscInt*); 383 PETSC_EXTERN PetscErrorCode PetscViewerFlowControlStepMain(PetscViewer,PetscInt,PetscInt*,PetscInt); 384 PETSC_EXTERN PetscErrorCode PetscViewerFlowControlEndMain(PetscViewer,PetscInt*); 385 PETSC_EXTERN PetscErrorCode PetscViewerFlowControlStepWorker(PetscViewer,PetscMPIInt,PetscInt*); 386 PETSC_EXTERN PetscErrorCode PetscViewerFlowControlEndWorker(PetscViewer,PetscInt*); 387 PETSC_DEPRECATED_FUNCTION("Use PetscViewerFlowControlStepMaster (since v3.15)") static inline PetscErrorCode PetscViewerFlowControlStepMaster(PetscViewer viewer,PetscInt i,PetscInt *mcnt,PetscInt cnt) {return PetscViewerFlowControlStepMain(viewer,i,mcnt,cnt);} 388 PETSC_DEPRECATED_FUNCTION("Use PetscViewerFlowControlEndMaster (since v3.15)") static inline PetscErrorCode PetscViewerFlowControlEndMaster(PetscViewer viewer, PetscInt *mcnt) {return PetscViewerFlowControlEndMain(viewer,mcnt);} 389 390 /* 391 PetscViewer writes to MATLAB .mat file 392 */ 393 PETSC_EXTERN PetscErrorCode PetscViewerMatlabPutArray(PetscViewer,int,int,const PetscScalar*,const char*); 394 PETSC_EXTERN PetscErrorCode PetscViewerMatlabGetArray(PetscViewer,int,int,PetscScalar*,const char*); 395 PETSC_EXTERN PetscErrorCode PetscViewerMatlabPutVariable(PetscViewer,const char*,void*); 396 397 #if defined(PETSC_HAVE_SAWS) 398 PETSC_EXTERN PetscErrorCode PetscObjectViewSAWs(PetscObject,PetscViewer); 399 #endif 400 401 /*S 402 PetscViewers - Abstract collection of PetscViewers. It is just an expandable array of viewers. 403 404 Level: intermediate 405 406 .seealso: `PetscViewerCreate()`, `PetscViewerSetType()`, `PetscViewerType`, `PetscViewer`, `PetscViewersCreate()`, 407 `PetscViewersGetViewer()` 408 S*/ 409 typedef struct _n_PetscViewers* PetscViewers; 410 PETSC_EXTERN PetscErrorCode PetscViewersCreate(MPI_Comm,PetscViewers*); 411 PETSC_EXTERN PetscErrorCode PetscViewersDestroy(PetscViewers*); 412 PETSC_EXTERN PetscErrorCode PetscViewersGetViewer(PetscViewers,PetscInt,PetscViewer*); 413 414 #endif 415