writeFile.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) 2012-2018 OpenFOAM Foundation
9  Copyright (C) 2015-2019 OpenCFD Ltd.
10 -------------------------------------------------------------------------------
11 License
12  This file is part of OpenFOAM.
13 
14  OpenFOAM is free software: you can redistribute it and/or modify it
15  under the terms of the GNU General Public License as published by
16  the Free Software Foundation, either version 3 of the License, or
17  (at your option) any later version.
18 
19  OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
20  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
21  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22  for more details.
23 
24  You should have received a copy of the GNU General Public License
25  along with OpenFOAM. If not, see <http://www.gnu.org/licenses/>.
26 
27 \*---------------------------------------------------------------------------*/
28 
29 #include "writeFile.H"
30 #include "Time.H"
31 #include "polyMesh.H"
32 #include "IFstream.H"
33 #include "functionObject.H"
34 
35 // * * * * * * * * * * * * * * Static Data Members * * * * * * * * * * * * * //
36 
38 
39 
40 // * * * * * * * * * * * * Protected Member Functions * * * * * * * * * * * //
41 
43 {
44  os.setf(ios_base::scientific, ios_base::floatfield);
46  os.width(charWidth());
47 }
48 
49 
51 {
52  // Put in undecomposed case
53  // (Note: gives problems for distributed data running)
54 
55  fileName baseDir =
56  (
57  fileObr_.time().globalPath()
59  );
60 
61  // Append mesh name if not default region
62  if (isA<polyMesh>(fileObr_))
63  {
64  const polyMesh& mesh = refCast<const polyMesh>(fileObr_);
65  if (mesh.name() != polyMesh::defaultRegion)
66  {
67  baseDir /= mesh.name();
68  }
69  }
70 
71  baseDir.clean(); // Remove unneeded ".."
72 
73  return baseDir;
74 }
75 
76 
78 {
79  return baseFileDir()/prefix_/fileObr_.time().timeName();
80 }
81 
82 
84 (
85  const word& name,
86  scalar timeValue
87 ) const
88 {
89  autoPtr<OFstream> osPtr;
90 
91  if (Pstream::master() && writeToFile_)
92  {
93  if (useUserTime_)
94  {
95  timeValue = fileObr_.time().timeToUserTime(timeValue);
96  }
97 
98  const word timeName = Time::timeName(timeValue);
99 
100  fileName outputDir(baseFileDir()/prefix_/timeName);
101 
102  mkDir(outputDir);
103 
104  word fName(name);
105 
106  // Check if file already exists
107  IFstream is(outputDir/(fName + ".dat"));
108  if (is.good())
109  {
110  fName = fName + "_" + timeName;
111  }
112 
113  osPtr.reset(new OFstream(outputDir/(fName + ".dat")));
114 
115  if (!osPtr->good())
116  {
117  FatalIOErrorInFunction(osPtr()) << "Cannot open file"
118  << exit(FatalIOError);
119  }
120 
121  initStream(osPtr());
122  }
123 
124  return osPtr;
125 }
126 
127 
129 (
130  const word& name
131 ) const
132 {
133  return createFile(name, startTime_);
134 
135 }
136 
137 
139 {
140  fileName_ = fileName;
141  filePtr_ = createFile(fileName_);
142 }
143 
144 
146 (
147  const label offset
148 ) const
149 {
150  return setw(writePrecision_ + addChars + offset);
151 }
152 
153 
154 // * * * * * * * * * * * * * * * * Constructors * * * * * * * * * * * * * * //
155 
157 :
158  fileObr_(wf.fileObr_),
159  prefix_(wf.prefix_),
160  fileName_(wf.fileName_),
161  filePtr_(),
162  writePrecision_(wf.writePrecision_),
163  writeToFile_(wf.writeToFile_),
164  writtenHeader_(wf.writtenHeader_),
165  useUserTime_(wf.useUserTime_),
166  startTime_(wf.startTime_)
167 {}
168 
169 
171 (
172  const objectRegistry& obr,
173  const fileName& prefix,
174  const word& name,
175  const bool writeToFile
176 )
177 :
178  fileObr_(obr),
179  prefix_(prefix),
180  fileName_(name),
181  filePtr_(),
182  writePrecision_(IOstream::defaultPrecision()),
183  writeToFile_(writeToFile),
184  writtenHeader_(false),
185  useUserTime_(true),
186  startTime_(obr.time().startTime().value())
187 {}
188 
189 
191 (
192  const objectRegistry& obr,
193  const fileName& prefix,
194  const word& name,
195  const dictionary& dict,
196  const bool writeToFile
197 )
198 :
199  writeFile(obr, prefix, name, writeToFile)
200 {
201  read(dict);
202 
203  if (writeToFile_)
204  {
205  filePtr_ = createFile(fileName_);
206  }
207 }
208 
209 
210 // * * * * * * * * * * * * * * * Member Functions * * * * * * * * * * * * * //
211 
213 {
214  writePrecision_ =
215  dict.lookupOrDefault("writePrecision", IOstream::defaultPrecision());
216 
217  // Only write on master
218  writeToFile_ =
219  Pstream::master() && dict.lookupOrDefault("writeToFile", writeToFile_);
220 
221  // Use user time, e.g. CA deg in preference to seconds
222  useUserTime_ = dict.lookupOrDefault("useUserTime", true);
223 
224  return true;
225 }
226 
227 
229 {
230  if (!writeToFile_)
231  {
232  return Snull;
233  }
234 
235  if (!filePtr_.valid())
236  {
238  << "File pointer not allocated\n";
239  }
240 
241  return *filePtr_;
242 }
243 
244 
246 {
247  return writeToFile_;
248 }
249 
250 
252 {
253  return writePrecision_ + addChars;
254 }
255 
256 
258 (
259  Ostream& os,
260  const string& str
261 ) const
262 {
263  os << setw(1) << "#";
264 
265  if (str.size())
266  {
267  os << setw(1) << ' '
268  << setf(ios_base::left) << setw(charWidth() - 2) << str.c_str();
269  }
270 }
271 
272 
274 (
275  Ostream& os,
276  const string& str
277 ) const
278 {
279  os << tab << setw(charWidth()) << str.c_str();
280 }
281 
282 
284 (
285  Ostream& os,
286  const string& str
287 ) const
288 {
289  writeCommented(os, str);
290  os << nl;
291 }
292 
293 
295 {
296  const scalar timeValue =
297  (
298  useUserTime_
299  ? fileObr_.time().timeOutputValue()
300  : fileObr_.time().value()
301  );
302 
303  os << setw(charWidth()) << Time::timeName(timeValue);
304 }
305 
306 
308 {
309  writeHeader(os, "===");
310 }
311 
312 
313 // ************************************************************************* //
Foam::setf
Smanip< ios_base::fmtflags > setf(const ios_base::fmtflags flags)
Definition: IOmanip.H:169
Foam::autoPtr::reset
void reset(T *p=nullptr) noexcept
Delete managed object and set to new given pointer.
Definition: autoPtrI.H:158
writeFile.H
Foam::functionObjects::writeFile::writeCurrentTime
virtual void writeCurrentTime(Ostream &os) const
Write the current time to stream.
Definition: writeFile.C:294
Foam::word
A class for handling words, derived from Foam::string.
Definition: word.H:62
Foam::functionObjects::writeFile::file
virtual OFstream & file()
Return access to the file (if only 1)
Definition: writeFile.C:228
Foam::fileName
A class for handling file names.
Definition: fileName.H:69
Foam::polyMesh::defaultRegion
static word defaultRegion
Return the default region name.
Definition: polyMesh.H:312
Foam::IFstream
Input from file stream, using an ISstream.
Definition: IFstream.H:97
Foam::read
bool read(const char *buf, int32_t &val)
Same as readInt32.
Definition: int32.H:108
Foam::objectRegistry::time
const Time & time() const
Return time.
Definition: objectRegistry.H:186
Foam::functionObjects::writeFile::addChars
static label addChars
Additional characters for writing.
Definition: writeFile.H:133
Foam::functionObjects::writeFile::writePrecision_
label writePrecision_
Write precision.
Definition: writeFile.H:79
Foam::FatalIOError
IOerror FatalIOError
Foam::functionObjects::writeFile::baseFileDir
fileName baseFileDir() const
Return the base directory for output.
Definition: writeFile.C:50
Foam::dimensioned::value
const Type & value() const
Return const reference to value.
Definition: dimensionedType.C:404
Foam::writeHeader
static void writeHeader(Ostream &os, const word &fieldName)
Definition: rawSurfaceWriterImpl.C:49
polyMesh.H
Foam::polyMesh
Mesh consisting of general polyhedral cells.
Definition: polyMesh.H:77
Foam::Ostream::precision
virtual int precision() const =0
Get precision of output field.
Foam::functionObjects::writeFile::writeHeader
virtual void writeHeader(Ostream &os, const string &str) const
Write a commented header to stream.
Definition: writeFile.C:284
Foam::objectRegistry
Registry of regIOobjects.
Definition: objectRegistry.H:60
Foam::functionObjects::writeFile::writeBreak
virtual void writeBreak(Ostream &os) const
Write a break marker to the stream.
Definition: writeFile.C:307
Foam::functionObjects::writeFile::read
virtual bool read(const dictionary &dict)
Read.
Definition: writeFile.C:212
Foam::Time::timeName
virtual word timeName() const
Return current time name.
Definition: Time.C:774
Foam::label
intWM_LABEL_SIZE_t label
A label is an int32_t or int64_t as specified by the pre-processor macro WM_LABEL_SIZE.
Definition: label.H:62
Foam::functionObjects::writeFile::valueWidth
Omanip< int > valueWidth(const label offset=0) const
Return the value width when writing to stream with optional offset.
Definition: writeFile.C:146
Foam::name
word name(const complex &c)
Return string representation of complex.
Definition: complex.C:76
Foam::functionObject::outputPrefix
static word outputPrefix
Directory prefix.
Definition: functionObject.H:259
IFstream.H
timeName
word timeName
Definition: getTimeIndex.H:3
dict
dictionary dict
Definition: searchingEngine.H:14
Foam::dictionary
A list of keyword definitions, which are a keyword followed by a number of values (eg,...
Definition: dictionary.H:121
mesh
dynamicFvMesh & mesh
Definition: createDynamicFvMesh.H:6
Foam::functionObjects::writeFile::initStream
void initStream(Ostream &os) const
Initialise the output stream for writing.
Definition: writeFile.C:42
Foam::setw
Omanip< int > setw(const int i)
Definition: IOmanip.H:199
Foam::scientific
IOstream & scientific(IOstream &io)
Definition: IOstream.H:447
Foam::exit
errorManipArg< error, int > exit(error &err, const int errNo=1)
Definition: errorManip.H:130
Foam::OFstream
Output to file stream, using an OSstream.
Definition: OFstream.H:99
Foam::IOstream::setf
ios_base::fmtflags setf(const ios_base::fmtflags f)
Set flags of stream.
Definition: IOstream.H:361
Foam::UPstream::master
static bool master(const label communicator=0)
Am I the master process.
Definition: UPstream.H:438
Time.H
Foam::autoPtr< Foam::OFstream >
FatalErrorInFunction
#define FatalErrorInFunction
Report an error message using Foam::FatalError.
Definition: error.H:355
Foam::functionObjects::writeFile::writeCommented
virtual void writeCommented(Ostream &os, const string &str) const
Write a commented string to stream.
Definition: writeFile.C:258
Foam::tab
constexpr char tab
Definition: Ostream.H:371
Foam::nl
constexpr char nl
Definition: Ostream.H:372
Foam::IOstream::defaultPrecision
static unsigned int defaultPrecision()
Return the default precision.
Definition: IOstream.H:325
Foam::functionObjects::writeFile::createFile
virtual autoPtr< OFstream > createFile(const word &name, scalar timeValue) const
Return autoPtr to a new file for a given time.
Definition: writeFile.C:84
Foam::Omanip
An Ostream manipulator taking arguments.
Definition: IOmanip.H:50
Foam::functionObjects::writeFile::writeFile
writeFile(const objectRegistry &obr, const fileName &prefix, const word &name="undefined", const bool writeToFile=true)
Construct from objectRegistry, prefix, fileName.
Definition: writeFile.C:171
Foam::functionObjects::writeFile::resetFile
virtual void resetFile(const word &name)
Reset internal file pointer to new file with new name.
Definition: writeFile.C:138
Foam::fileName::clean
static bool clean(std::string &str)
Cleanup filename.
Definition: fileName.C:298
Foam::functionObjects::writeFile
functionObject base class for writing single files
Definition: writeFile.H:59
FatalIOErrorInFunction
#define FatalIOErrorInFunction(ios)
Report an error message using Foam::FatalIOError.
Definition: error.H:375
Foam::functionObjects::writeFile::writeToFile
virtual bool writeToFile() const
Flag to allow writing to file.
Definition: writeFile.C:245
Foam::Snull
OFstream Snull
Global predefined null output stream "/dev/null".
Foam::Ostream
An Ostream is an abstract base class for all output systems (streams, files, token lists,...
Definition: Ostream.H:56
Foam::IOstream::good
bool good() const
Return true if next operation might succeed.
Definition: IOstream.H:216
Foam::functionObjects::writeFile::baseTimeDir
fileName baseTimeDir() const
Return the base directory for the current time value.
Definition: writeFile.C:77
functionObject.H
Foam::mkDir
bool mkDir(const fileName &pathName, mode_t mode=0777)
Make a directory and return an error if it could not be created.
Definition: MSwindows.C:507
Foam::functionObjects::writeFile::charWidth
virtual label charWidth() const
Return width of character stream output.
Definition: writeFile.C:251
Foam::Time::startTime
virtual dimensionedScalar startTime() const
Return start time.
Definition: Time.C:851
Foam::functionObjects::writeFile::writeTabbed
virtual void writeTabbed(Ostream &os, const string &str) const
Write a tabbed string to stream.
Definition: writeFile.C:274
Foam::Ostream::width
virtual int width() const =0
Get width of output field.