vtkSurfaceWriter.C
Go to the documentation of this file.
1 /*---------------------------------------------------------------------------*\
2  ========= |
3  \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
4  \\ / O peration |
5  \\ / A nd | www.openfoam.com
6  \\/ M anipulation |
7 -------------------------------------------------------------------------------
8  Copyright (C) 2019-2020 OpenCFD Ltd.
9 -------------------------------------------------------------------------------
10 License
11  This file is part of OpenFOAM.
12 
13  OpenFOAM is free software: you can redistribute it and/or modify it
14  under the terms of the GNU General Public License as published by
15  the Free Software Foundation, either version 3 of the License, or
16  (at your option) any later version.
17 
18  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
19  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
20  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
21  for more details.
22 
23  You should have received a copy of the GNU General Public License
24  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
25 
26 \*---------------------------------------------------------------------------*/
27 
28 #include "vtkSurfaceWriter.H"
29 #include "foamVtkSurfaceWriter.H"
30 #include "surfaceWriterMethods.H"
32 
33 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
34 
35 namespace Foam
36 {
37 namespace surfaceWriters
38 {
39  defineTypeName(vtkWriter);
40  addToRunTimeSelectionTable(surfaceWriter, vtkWriter, word);
41  addToRunTimeSelectionTable(surfaceWriter, vtkWriter, wordDict);
42 
43  // Accept vtp ending as well
45  (
46  surfaceWriter,
47  vtkWriter,
48  word,
49  vtp
50  );
52  (
53  surfaceWriter,
54  vtkWriter,
55  wordDict,
56  vtp
57  );
58 }
59 }
60 
61 
62 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
63 
65 :
66  surfaceWriter(),
67  fmtType_(static_cast<unsigned>(vtk::formatType::INLINE_BASE64)),
68  precision_(IOstream::defaultPrecision()),
69  writer_(nullptr)
70 {}
71 
72 
74 (
75  const vtk::outputOptions& opts
76 )
77 :
78  surfaceWriter(),
79  fmtType_(static_cast<unsigned>(opts.fmt())),
80  precision_(opts.precision()),
81  writer_(nullptr)
82 {}
83 
84 
86 (
87  const dictionary& options
88 )
89 :
90  surfaceWriter(options),
91  fmtType_(static_cast<unsigned>(vtk::formatType::INLINE_BASE64)),
92  precision_
93  (
94  options.getOrDefault("precision", IOstream::defaultPrecision())
95  ),
96  writer_(nullptr)
97 {
98  // format: ascii | binary
99  // legacy: true | false
100 
102 
103  opts.ascii
104  (
106  == IOstream::formatEnum("format", options, IOstream::BINARY)
107  );
108 
109  opts.legacy(options.getOrDefault("legacy", false));
110 
111  // Convert back to raw data type
112  fmtType_ = static_cast<unsigned>(opts.fmt());
113 }
114 
115 
117 (
118  const meshedSurf& surf,
119  const fileName& outputPath,
120  bool parallel,
121  const dictionary& options
122 )
123 :
124  vtkWriter(options)
125 {
126  open(surf, outputPath, parallel);
127 }
128 
129 
131 (
132  const pointField& points,
133  const faceList& faces,
134  const fileName& outputPath,
135  bool parallel,
136  const dictionary& options
137 )
138 :
139  vtkWriter(options)
140 {
141  open(points, faces, outputPath, parallel);
142 }
143 
144 
145 // * * * * * * * * * * * * * * * * Destructor * * * * * * * * * * * * * * * //
146 
148 {
149  close();
150 }
151 
152 
153 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
154 
156 {
157  writer_.clear();
159 }
160 
161 
163 {
164  writer_.clear();
166 }
167 
168 
170 {
171  writer_.clear();
173 }
174 
175 
177 {
178  writer_.clear();
180 }
181 
182 
184 {
185  checkOpen();
186 
187  if (needsUpdate())
188  {
189  writer_.clear();
190  }
191  merge();
192 
193  // From raw unsigned values to vtk::outputOptions
194  vtk::outputOptions opts(static_cast<vtk::formatType>(fmtType_), precision_);
195 
196 
197  // Geometry: rootdir/<TIME>/surfaceName.{vtk|vtp}
198 
199  fileName outputFile = outputPath_;
200  if (useTimeDir() && !timeName().empty())
201  {
202  // Splice in time-directory
203  outputFile = outputPath_.path() / timeName() / outputPath_.name();
204  }
205  outputFile.ext(vtk::surfaceWriter::ext(opts));
206 
207  if (verbose_)
208  {
209  Info<< "Writing geometry to " << outputFile << endl;
210  }
211 
212  const meshedSurf& surf = surface();
213 
214  if (!writer_ && (Pstream::master() || !parallel_))
215  {
216  writer_.reset
217  (
219  (
220  surf.points(),
221  surf.faces(),
222  opts,
223  outputFile,
224  false // serial!
225  )
226  );
227 
228  if (this->hasTime())
229  {
230  // Time name in title
231  writer_->setTime(currTime_);
232  writer_->writeTimeValue();
233  }
234  else
235  {
236  // Surface name in title
237  writer_->beginFile(outputPath_.nameLessExt());
238  }
239 
240  writer_->writeGeometry();
241  }
242 
243  wroteGeom_ = true;
244  return outputFile;
245 }
246 
247 
248 // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
249 
250 template<class Type>
251 Foam::fileName Foam::surfaceWriters::vtkWriter::writeTemplate
252 (
253  const word& fieldName,
254  const Field<Type>& localValues
255 )
256 {
257  // Field: rootdir/<TIME>/surfaceName.{vtk|vtp}
258 
259  // Open file, writing geometry (if required)
260  fileName outputFile = this->write();
261 
262  if (verbose_)
263  {
264  Info<< "Writing field " << fieldName << " to " << outputFile << endl;
265  }
266 
267  // geometry merge() implicit
268  tmp<Field<Type>> tfield = mergeField(localValues);
269 
270  if (Pstream::master() || !parallel_)
271  {
272  if (this->isPointData())
273  {
274  writer_->beginPointData(nFields_);
275  }
276  else
277  {
278  writer_->beginCellData(nFields_);
279  }
280 
281  writer_->write(fieldName, tfield());
282  }
283 
284  wroteGeom_ = true;
285  return outputFile;
286 }
287 
288 
289 // Field writing methods
291 
292 
293 // ************************************************************************* //
Foam::vtk::outputOptions
Encapsulated combinations of output format options. This is primarily useful when defining the output...
Definition: foamVtkOutputOptions.H:59
Foam::Time
Class to control time during OpenFOAM simulations that is also the top-level objectRegistry.
Definition: Time.H:73
Foam::word
A class for handling words, derived from Foam::string.
Definition: word.H:62
Foam::surfaceWriter
Base class for surface writers.
Definition: surfaceWriter.H:111
Foam::fileName
A class for handling file names.
Definition: fileName.H:69
Foam::fileName::path
static std::string path(const std::string &str)
Return directory path name (part before last /)
Definition: fileNameI.H:186
Foam::tmp
A class for managing temporary objects.
Definition: PtrList.H:59
Foam::vtk::outputOptions::precision
unsigned precision() const
Return the ASCII write precision.
Definition: foamVtkOutputOptionsI.H:126
Foam::surfaceWriters::vtkWriter::write
virtual fileName write()
Write surface geometry to file.
Definition: vtkSurfaceWriter.C:183
Foam::meshedSurf::faces
virtual const faceList & faces() const =0
The faces used for the surface.
Foam::surfaceWriters::vtkWriter::close
virtual void close()
Finish output, clears backend.
Definition: vtkSurfaceWriter.C:155
Foam::IOstream
An IOstream is an abstract base class for all input/output systems; be they streams,...
Definition: IOstream.H:75
Foam::meshedSurf
Abstract definition of a meshed surface defined by faces and points.
Definition: meshedSurf.H:49
Foam::surfaceWriters::vtkWriter::beginTime
virtual void beginTime(const Time &t)
Begin time step. Clears existing backend.
Definition: vtkSurfaceWriter.C:162
Foam::surfaceWriters::defineTypeName
defineTypeName(boundaryDataWriter)
Foam::vtk::outputOptions::legacy
bool legacy() const
True if writer uses legacy file format.
Definition: foamVtkOutputOptionsI.H:88
Foam::endl
Ostream & endl(Ostream &os)
Add newline and flush stream.
Definition: Ostream.H:350
foamVtkSurfaceWriter.H
surfaceWriterMethods.H
Convenience macros for instantiating surfaceWriter methods.
Foam::vtk::outputOptions::fmt
formatType fmt() const
The output format type.
Definition: foamVtkOutputOptionsI.H:71
Foam::surfaceWriter::endTime
virtual void endTime()
End a time-step.
Definition: surfaceWriter.C:241
Foam::surfaceWriters::vtkWriter
A surfaceWriter for VTK legacy (.vtk) or XML (.vtp) format.
Definition: vtkSurfaceWriter.H:114
Foam::vtk::formatType
formatType
The output format type for file contents.
Definition: foamVtkCore.H:65
Foam::surfaceWriter::beginTime
virtual void beginTime(const Time &t)
Begin a time-step.
Definition: surfaceWriter.C:229
Foam::vtk::outputOptions::ascii
bool ascii() const
True if output format is ASCII.
Definition: foamVtkOutputOptionsI.H:120
Foam::Field< vector >
Foam::Info
messageStream Info
Information stream (uses stdout - output is on the master only)
Foam::surfaceWriters::vtkWriter::endTime
virtual void endTime()
End time step. Clears existing backend.
Definition: vtkSurfaceWriter.C:176
Foam::meshedSurf::points
virtual const pointField & points() const =0
The points used for the surface.
timeName
word timeName
Definition: getTimeIndex.H:3
Foam::dictionary
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition: dictionary.H:121
addToRunTimeSelectionTable.H
Macros for easy insertion into run-time selection tables.
Foam::vtk::formatType::INLINE_BASE64
XML inline base64, base64Formatter.
Foam::fileName::ext
word ext() const
Return file name extension (part after last .)
Definition: fileNameI.H:228
Foam::surfaceWriters::vtkWriter::~vtkWriter
virtual ~vtkWriter()
Destructor. Calls close()
Definition: vtkSurfaceWriter.C:147
Foam
Namespace for OpenFOAM.
Definition: atmBoundaryLayer.C:33
Foam::UPstream::master
static bool master(const label communicator=0)
Am I the master process.
Definition: UPstream.H:439
Foam::surfaceWriters::addToRunTimeSelectionTable
addToRunTimeSelectionTable(surfaceWriter, boundaryDataWriter, word)
Foam::IOstreamOption::BINARY
"binary"
Definition: IOstreamOption.H:73
Foam::IOstreamOption::ASCII
"ascii" (normal default)
Definition: IOstreamOption.H:72
Foam::IOstream::defaultPrecision
static unsigned int defaultPrecision()
Return the default precision.
Definition: IOstream.H:333
Foam::vtk::surfaceWriter
Write faces/points (optionally with fields) as a vtp file or a legacy vtk file.
Definition: foamVtkSurfaceWriter.H:68
Foam::IOstreamOption::formatEnum
static streamFormat formatEnum(const word &formatName, const streamFormat deflt=streamFormat::ASCII)
Definition: IOstreamOption.C:53
vtkSurfaceWriter.H
Foam::List< face >
points
const pointField & points
Definition: gmvOutputHeader.H:1
defineSurfaceWriterWriteFields
defineSurfaceWriterWriteFields(Foam::surfaceWriters::vtkWriter)
Foam::vtk::write
void write(vtk::formatter &fmt, const Type &val, const label n=1)
Component-wise write of a value (N times)
Definition: foamVtkOutputTemplates.C:35
Foam::instant
An instant of time. Contains the time value and name.
Definition: instant.H:52
Foam::surfaceWriter::close
virtual void close()
Finish output, performing any necessary cleanup.
Definition: surfaceWriter.C:306
Foam::dictionary::getOrDefault
T getOrDefault(const word &keyword, const T &deflt, enum keyType::option matchOpt=keyType::REGEX) const
Definition: dictionaryTemplates.C:122
Foam::surfaceWriters::vtkWriter::vtkWriter
vtkWriter()
Default construct.
Definition: vtkSurfaceWriter.C:64
Foam::vtk::fileWriter::ext
word ext() const
File extension for current format type.
Definition: foamVtkFileWriterI.H:68
Foam::surfaceWriters::addNamedToRunTimeSelectionTable
addNamedToRunTimeSelectionTable(surfaceWriter, vtkWriter, word, vtp)