xref: /petsc/src/sys/classes/viewer/impls/vtk/vtkv.c (revision f560318ce50f43192aed8957aa022ffb5d44929d)
1 #include <../src/sys/classes/viewer/impls/vtk/vtkvimpl.h> /*I "petscviewer.h" I*/
2 
3 /*MC
4     PetscViewerVTKWriteFunction - functional form used to provide writer to the PetscViewerVTK
5 
6      Synopsis:
7      #include <petscviewer.h>
8      PetscViewerVTKWriteFunction(PetscObject object,PetscViewer viewer)
9 
10      Input Parameters:
11 +      object - the PETSc object to be written
12 -      viewer - viewer it is to be written to
13 
14    Level: developer
15 
16 .seealso:   PetscViewerVTKAddField()
17 M*/
18 
19 /*@C
20    PetscViewerVTKAddField - Add a field to the viewer
21 
22    Collective
23 
24    Input Arguments:
25 + viewer - VTK viewer
26 . dm - DM on which Vec lives
27 . PetscViewerVTKWriteFunction - function to write this Vec
28 . fieldtype - Either PETSC_VTK_POINT_FIELD or PETSC_VTK_CELL_FIELD
29 . checkdm - whether to check for identical dm arguments as fields are added
30 - vec - Vec to write
31 
32    Note:
33    This routine keeps exclusive ownership of the Vec. The caller should not use or destroy the Vec after adding it.
34 
35    Level: developer
36 
37 .seealso: PetscViewerVTKOpen(), DMDAVTKWriteAll(), PetscViewerVTKWriteFunction, PetscViewerVTKGetDM()
38 @*/
39 PetscErrorCode PetscViewerVTKAddField(PetscViewer viewer,PetscObject dm,PetscErrorCode (*PetscViewerVTKWriteFunction)(PetscObject,PetscViewer),PetscViewerVTKFieldType fieldtype,PetscBool checkdm,PetscObject vec)
40 {
41   PetscErrorCode ierr;
42 
43   PetscFunctionBegin;
44   PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,1);
45   PetscValidHeader(dm,2);
46   PetscValidHeader(vec,4);
47   ierr = PetscUseMethod(viewer,"PetscViewerVTKAddField_C",(PetscViewer,PetscObject,PetscErrorCode (*)(PetscObject,PetscViewer),PetscViewerVTKFieldType,PetscBool,PetscObject),(viewer,dm,PetscViewerVTKWriteFunction,fieldtype,checkdm,vec));CHKERRQ(ierr);
48   PetscFunctionReturn(0);
49 }
50 
51 /*@C
52    PetscViewerVTKGetDM - get the DM associated with the viewer
53 
54    Collective
55 
56    Input Arguments:
57 + viewer - VTK viewer
58 - dm - DM associated with the viewer (as PetscObject)
59 
60    Level: developer
61 
62 .seealso: PetscViewerVTKOpen(), DMDAVTKWriteAll(), PetscViewerVTKWriteFunction, PetscViewerVTKAddField()
63 @*/
64 PetscErrorCode PetscViewerVTKGetDM(PetscViewer viewer,PetscObject *dm)
65 {
66   PetscErrorCode ierr;
67 
68   PetscFunctionBegin;
69   PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,1);
70   ierr = PetscUseMethod(viewer,"PetscViewerVTKGetDM_C",(PetscViewer,PetscObject*),(viewer,dm));CHKERRQ(ierr);
71   PetscFunctionReturn(0);
72 }
73 
74 static PetscErrorCode PetscViewerDestroy_VTK(PetscViewer viewer)
75 {
76   PetscViewer_VTK *vtk = (PetscViewer_VTK*)viewer->data;
77   PetscErrorCode  ierr;
78 
79   PetscFunctionBegin;
80   ierr = PetscFree(vtk->filename);CHKERRQ(ierr);
81   ierr = PetscFree(vtk);CHKERRQ(ierr);
82   ierr = PetscObjectComposeFunction((PetscObject)viewer,"PetscViewerFileSetName_C",NULL);CHKERRQ(ierr);
83   ierr = PetscObjectComposeFunction((PetscObject)viewer,"PetscViewerFileGetName_C",NULL);CHKERRQ(ierr);
84   ierr = PetscObjectComposeFunction((PetscObject)viewer,"PetscViewerFileSetMode_C",NULL);CHKERRQ(ierr);
85   ierr = PetscObjectComposeFunction((PetscObject)viewer,"PetscViewerFileGetMode_C",NULL);CHKERRQ(ierr);
86   ierr = PetscObjectComposeFunction((PetscObject)viewer,"PetscViewerVTKAddField_C",NULL);CHKERRQ(ierr);
87   ierr = PetscObjectComposeFunction((PetscObject)viewer,"PetscViewerVTKGetDM_C",NULL);CHKERRQ(ierr);
88   PetscFunctionReturn(0);
89 }
90 
91 static PetscErrorCode PetscViewerFlush_VTK(PetscViewer viewer)
92 {
93   PetscViewer_VTK          *vtk = (PetscViewer_VTK*)viewer->data;
94   PetscErrorCode           ierr;
95   PetscViewerVTKObjectLink link,next;
96 
97   PetscFunctionBegin;
98   if (vtk->link && (!vtk->dm || !vtk->write)) SETERRQ(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_WRONGSTATE,"No fields or no grid");
99   if (vtk->write) {ierr = (*vtk->write)(vtk->dm,viewer);CHKERRQ(ierr);}
100   for (link=vtk->link; link; link=next) {
101     next = link->next;
102     ierr = PetscObjectDestroy(&link->vec);CHKERRQ(ierr);
103     ierr = PetscFree(link);CHKERRQ(ierr);
104   }
105   ierr       = PetscObjectDestroy(&vtk->dm);CHKERRQ(ierr);
106   vtk->write = NULL;
107   PetscFunctionReturn(0);
108 }
109 
110 PetscErrorCode  PetscViewerFileSetName_VTK(PetscViewer viewer,const char name[])
111 {
112   PetscViewer_VTK *vtk = (PetscViewer_VTK*)viewer->data;
113   PetscErrorCode  ierr;
114   PetscBool       isvtk,isvts,isvtu,isvtr;
115   size_t          len;
116 
117   PetscFunctionBegin;
118   ierr = PetscViewerFlush(viewer);CHKERRQ(ierr);
119   ierr = PetscFree(vtk->filename);CHKERRQ(ierr);
120   ierr = PetscStrlen(name,&len);CHKERRQ(ierr);
121   if (!len) {
122     isvtk = PETSC_TRUE;
123   } else {
124     ierr = PetscStrcasecmp(name+len-4,".vtk",&isvtk);CHKERRQ(ierr);
125     ierr = PetscStrcasecmp(name+len-4,".vts",&isvts);CHKERRQ(ierr);
126     ierr = PetscStrcasecmp(name+len-4,".vtu",&isvtu);CHKERRQ(ierr);
127     ierr = PetscStrcasecmp(name+len-4,".vtr",&isvtr);CHKERRQ(ierr);
128   }
129   if (isvtk) {
130     if (viewer->format == PETSC_VIEWER_DEFAULT) viewer->format = PETSC_VIEWER_ASCII_VTK;
131     if (viewer->format != PETSC_VIEWER_ASCII_VTK) SETERRQ2(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_INCOMP,"Cannot use file '%s' with format %s, should have '.vtk' extension",name,PetscViewerFormats[viewer->format]);
132   } else if (isvts) {
133     if (viewer->format == PETSC_VIEWER_DEFAULT) viewer->format = PETSC_VIEWER_VTK_VTS;
134     if (viewer->format != PETSC_VIEWER_VTK_VTS) SETERRQ2(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_INCOMP,"Cannot use file '%s' with format %s, should have '.vts' extension",name,PetscViewerFormats[viewer->format]);
135   } else if (isvtu) {
136     if (viewer->format == PETSC_VIEWER_DEFAULT) viewer->format = PETSC_VIEWER_VTK_VTU;
137     if (viewer->format != PETSC_VIEWER_VTK_VTU) SETERRQ2(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_INCOMP,"Cannot use file '%s' with format %s, should have '.vtu' extension",name,PetscViewerFormats[viewer->format]);
138   } else if (isvtr) {
139     if (viewer->format == PETSC_VIEWER_DEFAULT) viewer->format = PETSC_VIEWER_VTK_VTR;
140     if (viewer->format != PETSC_VIEWER_VTK_VTR) SETERRQ2(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_INCOMP,"Cannot use file '%s' with format %s, should have '.vtr' extension",name,PetscViewerFormats[viewer->format]);
141   } else SETERRQ1(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_UNKNOWN_TYPE,"File '%s' has unrecognized extension",name);
142   ierr = PetscStrallocpy(len ? name : "stdout",&vtk->filename);CHKERRQ(ierr);
143   PetscFunctionReturn(0);
144 }
145 
146 PetscErrorCode  PetscViewerFileGetName_VTK(PetscViewer viewer,const char **name)
147 {
148   PetscViewer_VTK *vtk = (PetscViewer_VTK*)viewer->data;
149   PetscFunctionBegin;
150   *name = vtk->filename;
151   PetscFunctionReturn(0);
152 }
153 
154 PetscErrorCode  PetscViewerFileSetMode_VTK(PetscViewer viewer,PetscFileMode type)
155 {
156   PetscViewer_VTK *vtk = (PetscViewer_VTK*)viewer->data;
157 
158   PetscFunctionBegin;
159   vtk->btype = type;
160   PetscFunctionReturn(0);
161 }
162 
163 PetscErrorCode  PetscViewerFileGetMode_VTK(PetscViewer viewer,PetscFileMode *type)
164 {
165   PetscViewer_VTK *vtk = (PetscViewer_VTK*)viewer->data;
166 
167   PetscFunctionBegin;
168   *type = vtk->btype;
169   PetscFunctionReturn(0);
170 }
171 
172 PetscErrorCode  PetscViewerVTKAddField_VTK(PetscViewer viewer,PetscObject dm,PetscErrorCode (*PetscViewerVTKWriteFunction)(PetscObject,PetscViewer),PetscViewerVTKFieldType fieldtype,PetscBool checkdm,PetscObject vec)
173 {
174   PetscViewer_VTK          *vtk = (PetscViewer_VTK*)viewer->data;
175   PetscViewerVTKObjectLink link, tail = vtk->link;
176   PetscErrorCode           ierr;
177 
178   PetscFunctionBegin;
179   if (vtk->dm) {
180     if (checkdm && dm != vtk->dm) SETERRQ(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_INCOMP,"Refusing to write a field from more than one grid to the same VTK file. Set checkdm = PETSC_FALSE to skip this check.");
181   } else {
182     ierr = PetscObjectReference(dm);CHKERRQ(ierr);
183     vtk->dm = dm;
184   }
185   vtk->write = PetscViewerVTKWriteFunction;
186   ierr       = PetscNew(&link);CHKERRQ(ierr);
187   link->ft   = fieldtype;
188   link->vec  = vec;
189   link->next = NULL;
190   /* Append to list */
191   if (tail) {
192     while (tail->next) tail = tail->next;
193     tail->next = link;
194   } else vtk->link = link;
195   PetscFunctionReturn(0);
196 }
197 
198 PetscErrorCode PetscViewerVTKGetDM_VTK(PetscViewer viewer,PetscObject *dm)
199 {
200   PetscViewer_VTK *vtk = (PetscViewer_VTK*)viewer->data;
201 
202   PetscFunctionBegin;
203   *dm = vtk->dm;
204   PetscFunctionReturn(0);
205 }
206 
207 /*MC
208    PETSCVIEWERVTK - A viewer that writes to a VTK file
209 
210 
211 .seealso:  PetscViewerVTKOpen(), PetscViewerHDF5Open(), PetscViewerStringSPrintf(), PetscViewerSocketOpen(), PetscViewerDrawOpen(), PETSCVIEWERSOCKET,
212            PetscViewerCreate(), PetscViewerASCIIOpen(), PetscViewerBinaryOpen(), PETSCVIEWERBINARY, PETSCVIEWERDRAW, PETSCVIEWERSTRING,
213            PetscViewerMatlabOpen(), VecView(), DMView(), PetscViewerMatlabPutArray(), PETSCVIEWERASCII, PETSCVIEWERMATLAB,
214            PetscViewerFileSetName(), PetscViewerFileSetMode(), PetscViewerFormat, PetscViewerType, PetscViewerSetType()
215 
216   Level: beginner
217 M*/
218 
219 PETSC_EXTERN PetscErrorCode PetscViewerCreate_VTK(PetscViewer v)
220 {
221   PetscViewer_VTK *vtk;
222   PetscErrorCode  ierr;
223 
224   PetscFunctionBegin;
225   ierr = PetscNewLog(v,&vtk);CHKERRQ(ierr);
226 
227   v->data         = (void*)vtk;
228   v->ops->destroy = PetscViewerDestroy_VTK;
229   v->ops->flush   = PetscViewerFlush_VTK;
230   vtk->btype      = (PetscFileMode) -1;
231   vtk->filename   = 0;
232 
233   ierr = PetscObjectComposeFunction((PetscObject)v,"PetscViewerFileSetName_C",PetscViewerFileSetName_VTK);CHKERRQ(ierr);
234   ierr = PetscObjectComposeFunction((PetscObject)v,"PetscViewerFileGetName_C",PetscViewerFileGetName_VTK);CHKERRQ(ierr);
235   ierr = PetscObjectComposeFunction((PetscObject)v,"PetscViewerFileSetMode_C",PetscViewerFileSetMode_VTK);CHKERRQ(ierr);
236   ierr = PetscObjectComposeFunction((PetscObject)v,"PetscViewerFileGetMode_C",PetscViewerFileGetMode_VTK);CHKERRQ(ierr);
237   ierr = PetscObjectComposeFunction((PetscObject)v,"PetscViewerVTKAddField_C",PetscViewerVTKAddField_VTK);CHKERRQ(ierr);
238   ierr = PetscObjectComposeFunction((PetscObject)v,"PetscViewerVTKGetDM_C",PetscViewerVTKGetDM_VTK);CHKERRQ(ierr);
239   PetscFunctionReturn(0);
240 }
241 
242 /*@C
243    PetscViewerVTKOpen - Opens a file for VTK output.
244 
245    Collective on MPI_Comm
246 
247    Input Parameters:
248 +  comm - MPI communicator
249 .  name - name of file
250 -  type - type of file
251 $    FILE_MODE_WRITE - create new file for binary output
252 $    FILE_MODE_READ - open existing file for binary input (not currently supported)
253 $    FILE_MODE_APPEND - open existing file for binary output (not currently supported)
254 
255    Output Parameter:
256 .  vtk - PetscViewer for VTK input/output to use with the specified file
257 
258    Level: beginner
259 
260    Note:
261    This PetscViewer should be destroyed with PetscViewerDestroy().
262 
263    Concepts: VTK files
264    Concepts: PetscViewer^creating
265 
266 .seealso: PetscViewerASCIIOpen(), PetscViewerPushFormat(), PetscViewerDestroy(),
267           VecView(), MatView(), VecLoad(), MatLoad(),
268           PetscFileMode, PetscViewer
269 @*/
270 PetscErrorCode PetscViewerVTKOpen(MPI_Comm comm,const char name[],PetscFileMode type,PetscViewer *vtk)
271 {
272   PetscErrorCode ierr;
273 
274   PetscFunctionBegin;
275   ierr = PetscViewerCreate(comm,vtk);CHKERRQ(ierr);
276   ierr = PetscViewerSetType(*vtk,PETSCVIEWERVTK);CHKERRQ(ierr);
277   ierr = PetscViewerFileSetMode(*vtk,type);CHKERRQ(ierr);
278   ierr = PetscViewerFileSetName(*vtk,name);CHKERRQ(ierr);
279   PetscFunctionReturn(0);
280 }
281 
282 /*@C
283    PetscViewerVTKFWrite - write binary data preceded by 32-bit int length (in bytes), does not do byte swapping.
284 
285    Logically collective on PetscViewer
286 
287    Input Parameters:
288 +  viewer - logically collective viewer, data written from rank 0
289 .  fp - file pointer valid on rank 0
290 .  data - data pointer valid on rank 0
291 .  n - number of data items
292 -  dtype - data type
293 
294    Level: developer
295 
296    Notes:
297     If PetscScalar is __float128 then the binary files are written in double precision
298 
299    Concepts: VTK files
300    Concepts: PetscViewer^creating
301 
302 .seealso: DMDAVTKWriteAll(), DMComplexVTKWriteAll(), PetscViewerPushFormat(), PetscViewerVTKOpen(), PetscBinaryWrite()
303 @*/
304 PetscErrorCode PetscViewerVTKFWrite(PetscViewer viewer,FILE *fp,const void *data,PetscInt n,MPI_Datatype dtype)
305 {
306   PetscErrorCode ierr;
307   PetscMPIInt    rank;
308   MPI_Datatype   vdtype=dtype;
309 #if defined(PETSC_USE_REAL___FLOAT128)
310   double         *tmp;
311   PetscInt       i;
312   PetscReal      *ttmp = (PetscReal*)data;
313 #endif
314 
315   PetscFunctionBegin;
316   if (n < 0) SETERRQ1(PetscObjectComm((PetscObject)viewer),PETSC_ERR_ARG_OUTOFRANGE,"Trying to write a negative amount of data %D",n);
317   if (!n) PetscFunctionReturn(0);
318   ierr = MPI_Comm_rank(PetscObjectComm((PetscObject)viewer),&rank);CHKERRQ(ierr);
319   if (!rank) {
320     size_t      count;
321     PetscMPIInt dsize;
322     PetscVTKInt bytes;
323 
324 #if defined(PETSC_USE_REAL___FLOAT128)
325     if (dtype == MPIU___FLOAT128) {
326       ierr = PetscMalloc1(n,&tmp);CHKERRQ(ierr);
327       for (i=0; i<n; i++) tmp[i] = ttmp[i];
328       data  = (void*) tmp;
329       vdtype = MPI_DOUBLE;
330     }
331 #endif
332     ierr  = MPI_Type_size(vdtype,&dsize);CHKERRQ(ierr);
333     bytes = PetscVTKIntCast(dsize*n);
334 
335     count = fwrite(&bytes,sizeof(int),1,fp);
336     if (count != 1) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_FILE_WRITE,"Error writing byte count");
337     count = fwrite(data,dsize,(size_t)n,fp);
338     if ((PetscInt)count != n) SETERRQ3(PETSC_COMM_SELF,PETSC_ERR_FILE_WRITE,"Wrote %D/%D array members of size %d",(PetscInt)count,n,dsize);
339 #if defined(PETSC_USE_REAL___FLOAT128)
340     if (dtype == MPIU___FLOAT128) {
341       ierr = PetscFree(tmp);CHKERRQ(ierr);
342     }
343 #endif
344   }
345   PetscFunctionReturn(0);
346 }
347