coordSetWriter Class Reference

Write as points/lines, optionally with fields, as a vtp file or a legacy vtk file. More...

Inheritance diagram for coordSetWriter:
[legend]
Collaboration diagram for coordSetWriter:
[legend]

Public Types

enum  elemOutputType { NO_ELEMENTS = 0 , DEFAULT_ELEMENTS = 1 , POINT_ELEMENTS = 2 , LINE_ELEMENTS = 3 }
 Types of element output. More...
 

Public Member Functions

 coordSetWriter (const UPtrList< const pointField > &pts, const vtk::outputOptions opts=vtk::formatType::INLINE_BASE64)
 Construct from components (default format INLINE_BASE64) More...
 
 coordSetWriter (const UPtrList< const pointField > &pts, const fileName &file, bool paralel=false)
 
 coordSetWriter (const UPtrList< const pointField > &pts, const vtk::outputOptions opts, const fileName &file, bool paralel=false)
 Construct from components and open the file for writing. More...
 
virtual ~coordSetWriter ()=default
 Destructor. More...
 
void setElementType (const elemOutputType elemOutput)
 Define preferred element type. More...
 
virtual bool open (const fileName &file, bool parallel=false)
 Open file for writing. Non-parallel only. More...
 
virtual void setTime (const instant &inst)
 Define a time name/value for the output. More...
 
virtual bool beginFile (std::string title="")
 Write file header (non-collective) More...
 
virtual bool writeGeometry ()
 Write patch topology. More...
 
void writeTimeValue ()
 Write the currently set time as "TimeValue" FieldData. More...
 
void piece (const UPtrList< const pointField > &points)
 Reset point references to begin a new piece. More...
 
bool writeProcIDs ()
 
template<class Type >
void writePointData (const word &fieldName, const UPtrList< const Field< Type > > &fieldPtrs)
 Write primitive field of PointData. More...
 
- Public Member Functions inherited from polyWriter
 polyWriter (const vtk::outputOptions opts=vtk::formatType::INLINE_BASE64)
 Construct from components (default format INLINE_BASE64) More...
 
 polyWriter (const fileName &file, bool parallel=Pstream::parRun())
 
 polyWriter (const vtk::outputOptions opts, const fileName &file, bool parallel=Pstream::parRun())
 Construct from components and open the file for writing. More...
 
virtual ~polyWriter ()=default
 Destructor. More...
 
virtual bool writeGeometry ()
 Dummy write mesh topology method - Fatal if called. More...
 
bool writeLineGeometry (const pointField &points, const edgeList &edges)
 
bool writePolyGeometry (const pointField &points, const faceList &faces)
 
virtual bool beginCellData (label nFields=0)
 Begin CellData output section for specified number of fields. More...
 
virtual bool beginPointData (label nFields=0)
 Begin PointData for specified number of fields. More...
 
template<class Type >
void write (const word &fieldName, const UList< Type > &field)
 Write primitive field of CellData (Poly or Line) or PointData values. More...
 
template<class Type >
void writeCellData (const word &fieldName, const UList< Type > &field)
 Write primitive field of CellData. More...
 
template<class Type >
void writePointData (const word &fieldName, const UList< Type > &field)
 Write primitive field of PointData. More...
 
- Public Member Functions inherited from fileWriter
 fileWriter (const vtk::fileTag contentType, const vtk::outputOptions opts)
 Construct from components. More...
 
virtual ~fileWriter ()
 Destructor. More...
 
vtk::fileTag contentType () const noexcept
 The content type. More...
 
vtk::outputOptions opts () const noexcept
 The output options in use. More...
 
word ext () const
 File extension for current format type. More...
 
bool legacy () const noexcept
 Commonly used query. More...
 
bool parallel () const noexcept
 Parallel output requested? More...
 
const wordstate () const
 The output state in printable format. More...
 
const fileNameoutput () const noexcept
 The current output file name. More...
 
virtual bool open (const fileName &file, bool parallel=Pstream::parRun())
 Open file for writing (creates parent directory). More...
 
void close ()
 End the file contents and close the file after writing. More...
 
virtual bool beginFile (std::string title="")
 Write file header (non-collective) More...
 
bool beginFieldData (label nFields=0)
 Begin FieldData output section for specified number of fields. More...
 
virtual bool writeGeometry ()=0
 Write mesh topology. More...
 
virtual bool beginCellData (label nFields=0)=0
 Begin CellData output section for specified number of fields. More...
 
virtual bool beginPointData (label nFields=0)=0
 Begin PointData for specified number of fields. More...
 
label nCellData () const noexcept
 Return the number of CellData written for the Piece thus far. More...
 
label nPointData () const noexcept
 Return the number of PointData written for the Piece thus far. More...
 
bool endFieldData ()
 Explicitly end FieldData output and switch to DECLARED state. More...
 
bool endCellData ()
 Explicitly end CellData output and switch to PIECE state. More...
 
bool endPointData ()
 Explicitly end PointData output and switch to PIECE state. More...
 
void writeTimeValue (scalar timeValue)
 Write "TimeValue" FieldData (name as per Catalyst output) More...
 

Additional Inherited Members

- Static Public Member Functions inherited from polyWriter
static word ext (vtk::outputOptions opts)
 File extension for given output type. More...
 
- Protected Types inherited from fileWriter
enum  outputState : uint8_t {
  CLOSED = 0 , OPENED , DECLARED , FIELD_DATA ,
  PIECE , CELL_DATA , POINT_DATA
}
 Internal tracking of the output state. More...
 
- Protected Member Functions inherited from polyWriter
template<class Type >
void writeUniformValue (const label nCellValues, const word &fieldName, const Type &val)
 Write a uniform field of Cell (Poly or Line) or Point values. More...
 
- Protected Member Functions inherited from fileWriter
void checkFormatterValidity () const
 Verify that formatter in either allocated or not required. More...
 
OstreamreportBadState (Ostream &, outputState expected) const
 Generate message reporting bad writer state. More...
 
OstreamreportBadState (Ostream &, outputState, outputState) const
 Generate message reporting bad writer state. More...
 
std::ofstream & os () noexcept
 The backend ostream in use. More...
 
vtk::formatterformat ()
 The VTK formatter in use. FatalError for off-processor. More...
 
bool isState (outputState test) const noexcept
 True if output state corresponds to the test state. More...
 
bool notState (outputState test) const noexcept
 True if output state does not correspond to the test state. More...
 
template<class Type >
void beginDataArray (const word &fieldName, const label nValues)
 Start of a field or DataArray output (legacy or non-legacy). More...
 
void endDataArray ()
 Flush formatter and end of DataArray output (non-legacy) More...
 
void beginPoints (const label nPoints)
 Start of a POINTS DataArray. More...
 
void endPoints ()
 End of a POINTS DataArray. More...
 
bool enter_Piece ()
 Trigger change state to Piece. Resets nCellData_, nPointData_. More...
 
bool endPiece ()
 Explicitly end Piece output and switch to DECLARED state. More...
 
bool enter_CellData (label nEntries, label nFields)
 Trigger change state to CellData. More...
 
bool enter_PointData (label nEntries, label nFields)
 Trigger change state to PointData. More...
 
bool exit_File ()
 Emit file footer (end data, end piece, end file) More...
 
template<class Type >
void writeUniform (const word &fieldName, const Type &val, const label nValues)
 Write uniform field content. More...
 
template<class Type >
void writeBasicField (const word &fieldName, const UList< Type > &field)
 Write basic (primitive) field content. More...
 
bool writeProcIDs (const label nValues)
 Write nValues of processor ids as CellData (no-op in serial) More...
 
 fileWriter (const fileWriter &)=delete
 No copy construct. More...
 
void operator= (const fileWriter &)=delete
 No copy assignment. More...
 
- Protected Attributes inherited from polyWriter
label numberOfPoints_
 The number of field points for the current Piece. More...
 
label numberOfCells_
 The number of field cells (edges or faces) for the current Piece. More...
 
label nLocalPoints_
 Local number of points. More...
 
label nLocalVerts_
 Local number of vertices (points) More...
 
label nLocalLines_
 Local number of lines (edges) More...
 
label nLocalPolys_
 Local number of polys (faces) More...
 
- Protected Attributes inherited from fileWriter
outputState state_
 The output state. More...
 
vtk::fileTag contentType_
 The content type (PolyData, UnstructuredGrid ...) More...
 
bool parallel_
 Parallel writing (via master) More...
 
vtk::outputOptions opts_
 Requested output options. More...
 
label nCellData_
 The number of CellData written for the Piece thus far. More...
 
label nPointData_
 The number of PointData written for the Piece thus far. More...
 
fileName outputFile_
 The output file name. More...
 
autoPtr< vtk::formatterformat_
 The VTK formatter in use (only valid on master process) More...
 
std::ofstream os_
 The backend ostream in use (only opened on master process) More...
 
- Static Protected Attributes inherited from fileWriter
static const Enum< outputStatestateNames
 Names for the output state (for messages, not for file output). More...
 

Detailed Description

Write as points/lines, optionally with fields, as a vtp file or a legacy vtk file.

The file output states are managed by the Foam::vtk::fileWriter class. FieldData (eg, TimeValue) must appear before any geometry pieces.

Note
Non-parallel only
Source files

Definition at line 62 of file foamVtkCoordSetWriter.H.

Member Enumeration Documentation

◆ elemOutputType

Types of element output.

Enumerator
NO_ELEMENTS 
DEFAULT_ELEMENTS 
POINT_ELEMENTS 
LINE_ELEMENTS 

Definition at line 71 of file foamVtkCoordSetWriter.H.

Constructor & Destructor Documentation

◆ coordSetWriter() [1/3]

Construct from components (default format INLINE_BASE64)

Definition at line 431 of file foamVtkCoordSetWriter.C.

◆ coordSetWriter() [2/3]

coordSetWriter ( const UPtrList< const pointField > &  pts,
const fileName file,
bool  paralel = false 
)

Construct from components (default format INLINE_BASE64), and open the file for writing.

The file name is with/without an extension.

Definition at line 445 of file foamVtkCoordSetWriter.C.

References coordSetWriter::open(), and fileWriter::parallel().

Here is the call graph for this function:

◆ coordSetWriter() [3/3]

coordSetWriter ( const UPtrList< const pointField > &  pts,
const vtk::outputOptions  opts,
const fileName file,
bool  paralel = false 
)

Construct from components and open the file for writing.

The file name is with/without an extension.

Definition at line 458 of file foamVtkCoordSetWriter.C.

References coordSetWriter::open(), and fileWriter::parallel().

Here is the call graph for this function:

◆ ~coordSetWriter()

virtual ~coordSetWriter ( )
virtualdefault

Destructor.

Member Function Documentation

◆ setElementType()

void setElementType ( const elemOutputType  elemOutput)

Define preferred element type.

Definition at line 474 of file foamVtkCoordSetWriter.C.

◆ open()

bool open ( const fileName file,
bool  parallel = false 
)
virtual

Open file for writing. Non-parallel only.

Reimplemented from fileWriter.

Definition at line 483 of file foamVtkCoordSetWriter.C.

References Decorators< OpenChar, CloseChar, SepChar >::open.

Referenced by coordSetWriter::coordSetWriter().

Here is the caller graph for this function:

◆ setTime()

void setTime ( const instant inst)
virtual

Define a time name/value for the output.

Definition at line 493 of file foamVtkCoordSetWriter.C.

◆ beginFile()

bool beginFile ( std::string  title = "")
virtual

Write file header (non-collective)

Note
Expected calling states: (OPENED).

Reimplemented from fileWriter.

Definition at line 499 of file foamVtkCoordSetWriter.C.

References fileWriter::beginFile().

Here is the call graph for this function:

◆ writeGeometry()

bool writeGeometry ( )
virtual

Write patch topology.

Also writes the file header if not previously written.

Note
Must be called prior to writing CellData or PointData

Reimplemented from polyWriter.

Definition at line 519 of file foamVtkCoordSetWriter.C.

◆ writeTimeValue()

void writeTimeValue ( )

Write the currently set time as "TimeValue" FieldData.

Definition at line 547 of file foamVtkCoordSetWriter.C.

References lineWriter::writeTimeValue().

Here is the call graph for this function:

◆ piece()

void piece ( const UPtrList< const pointField > &  points)

Reset point references to begin a new piece.

Definition at line 556 of file foamVtkCoordSetWriter.C.

References points.

◆ writeProcIDs()

bool writeProcIDs ( )

Write processor ids for each line as CellData (no-op in serial)

Definition at line 567 of file foamVtkCoordSetWriter.C.

◆ writePointData()

void writePointData ( const word fieldName,
const UPtrList< const Field< Type > > &  fieldPtrs 
)

Write primitive field of PointData.

Definition at line 31 of file foamVtkCoordSetWriterTemplates.C.

References fileWriter::endDataArray(), Foam::endl(), Foam::exit(), Foam::FatalError, FatalErrorInFunction, field(), fileWriter::format(), fileWriter::isState(), Foam::nl, fileWriter::nPointData_, fileWriter::POINT_DATA, fileWriter::reportBadState(), and Foam::vtk::writeList().

Here is the call graph for this function:

The documentation for this class was generated from the following files: