Simplifies writing multi-file VTK datasets. More...

#include <vtkmultiwriter.hh>

Inheritance diagram for Opm::VtkMultiWriter< GridView, vtkFormat >:

Public Types
using	Scalar = BaseOutputWriter::Scalar

using	Vector = BaseOutputWriter::Vector

using	Tensor = BaseOutputWriter::Tensor

using	ScalarBuffer = BaseOutputWriter::ScalarBuffer

using	VectorBuffer = BaseOutputWriter::VectorBuffer

using	TensorBuffer = BaseOutputWriter::TensorBuffer

using	VtkWriter = Dune::VTKWriter< GridView >

using	FunctionPtr = std::shared_ptr< Dune::VTKFunction< GridView > >

Public Member Functions
	VtkMultiWriter (bool asyncWriting, const GridView &gridView, const std::string &outputDir, const std::string &simName="", std::string multiFileName="")

	~VtkMultiWriter ()

int	curWriterNum () const
	Returns the number of the current VTK file. More...

void	gridChanged ()
	Updates the internal data structures after mesh refinement. More...

void	beginWrite (double t)
	Called whenever a new time step must be written. More...

ScalarBuffer *	allocateManagedScalarBuffer (size_t numEntities)
	Allocate a managed buffer for a scalar field. More...

VectorBuffer *	allocateManagedVectorBuffer (size_t numOuter, size_t numInner)
	Allocate a managed buffer for a vector field. More...

void	attachScalarVertexData (ScalarBuffer &buf, std::string name)
	Add a finished vertex centered vector field to the output. More...

void	attachScalarElementData (ScalarBuffer &buf, std::string name)
	Add a element centered quantity to the output. More...

void	attachVectorVertexData (VectorBuffer &buf, std::string name)
	Add a finished vertex centered vector field to the output. More...

void	attachTensorVertexData (TensorBuffer &buf, std::string name)
	Add a finished vertex-centered tensor field to the output. More...

void	attachVectorElementData (VectorBuffer &buf, std::string name)
	Add a element centered quantity to the output. More...

void	attachTensorElementData (TensorBuffer &buf, std::string name)
	Add a finished element-centered tensor field to the output. More...

void	endWrite (bool onlyDiscard=false)
	Finalizes the current writer. More...

template<class Restarter >
void	serialize (Restarter &res)
	Write the multi-writer's state to a restart file. More...

template<class Restarter >
void	deserialize (Restarter &res)
	Read the multi-writer's state from a restart file. More...

Detailed Description

template<class GridView, int vtkFormat>
class Opm::VtkMultiWriter< GridView, vtkFormat >

Simplifies writing multi-file VTK datasets.

This class automatically keeps the meta file up to date and simplifies writing datasets consisting of multiple files. (i.e. multiple time steps or grid refinements within a time step.)

Member Typedef Documentation

◆ FunctionPtr

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::FunctionPtr = std::shared_ptr< Dune::VTKFunction< GridView > >

◆ Scalar

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::Scalar = BaseOutputWriter::Scalar

◆ ScalarBuffer

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::ScalarBuffer = BaseOutputWriter::ScalarBuffer

◆ Tensor

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::Tensor = BaseOutputWriter::Tensor

◆ TensorBuffer

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::TensorBuffer = BaseOutputWriter::TensorBuffer

◆ Vector

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::Vector = BaseOutputWriter::Vector

◆ VectorBuffer

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::VectorBuffer = BaseOutputWriter::VectorBuffer

◆ VtkWriter

template<class GridView , int vtkFormat>

using Opm::VtkMultiWriter< GridView, vtkFormat >::VtkWriter = Dune::VTKWriter<GridView>

Constructor & Destructor Documentation

◆ VtkMultiWriter()

template<class GridView , int vtkFormat>

Opm::VtkMultiWriter< GridView, vtkFormat >::VtkMultiWriter	(	bool	asyncWriting,
		const GridView &	gridView,
		const std::string &	outputDir,
		const std::string &	simName = `""`,
		std::string	multiFileName = `""`
	)

inline

◆ ~VtkMultiWriter()

template<class GridView , int vtkFormat>

Opm::VtkMultiWriter< GridView, vtkFormat >::~VtkMultiWriter ( )

inline

References Opm::TaskletRunner::barrier().

Member Function Documentation

◆ allocateManagedScalarBuffer()

template<class GridView , int vtkFormat>

ScalarBuffer * Opm::VtkMultiWriter< GridView, vtkFormat >::allocateManagedScalarBuffer ( size_t numEntities )

inline

Allocate a managed buffer for a scalar field.

The buffer will be deleted automatically after the data has been written by to disk.

Referenced by Opm::FvBaseDiscretization< TypeTag >::addConvergenceVtkFields().

◆ allocateManagedVectorBuffer()

template<class GridView , int vtkFormat>

VectorBuffer * Opm::VtkMultiWriter< GridView, vtkFormat >::allocateManagedVectorBuffer	(	size_t	numOuter,
		size_t	numInner
	)

inline

Allocate a managed buffer for a vector field.

The buffer will be deleted automatically after the data has been written by to disk.

◆ attachScalarElementData()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::attachScalarElementData	(	ScalarBuffer &	buf,
		std::string	name
	)

inlinevirtual

Add a element centered quantity to the output.

If the buffer is managed by the VtkMultiWriter, it must have been created using createField() and may not be used by anywhere after calling this method. After the data is written to disk, it will be deleted automatically.

If the buffer is not managed by the MultiWriter, the buffer must exist at least until the call to endWrite() finishes.

In both cases, modifying the buffer between the call to this method and endWrite() results in undefined behaviour.

Implements Opm::BaseOutputWriter.

◆ attachScalarVertexData()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::attachScalarVertexData	(	ScalarBuffer &	buf,
		std::string	name
	)

inlinevirtual

Add a finished vertex centered vector field to the output.

If the buffer is managed by the VtkMultiWriter, it must have been created using allocateManagedBuffer() and may not be used anywhere after calling this method. After the data is written to disk, it will be deleted automatically.

If the buffer is not managed by the MultiWriter, the buffer must exist at least until the call to endWrite() finishes.

In both cases, modifying the buffer between the call to this method and endWrite() results in undefined behavior.

Implements Opm::BaseOutputWriter.

◆ attachTensorElementData()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::attachTensorElementData	(	TensorBuffer &	buf,
		std::string	name
	)

inlinevirtual

Add a finished element-centered tensor field to the output.

Implements Opm::BaseOutputWriter.

◆ attachTensorVertexData()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::attachTensorVertexData	(	TensorBuffer &	buf,
		std::string	name
	)

inlinevirtual

Add a finished vertex-centered tensor field to the output.

Implements Opm::BaseOutputWriter.

◆ attachVectorElementData()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::attachVectorElementData	(	VectorBuffer &	buf,
		std::string	name
	)

inlinevirtual

Add a element centered quantity to the output.

If the buffer is managed by the VtkMultiWriter, it must have been created using createField() and may not be used by anywhere after calling this method. After the data is written to disk, it will be deleted automatically.

If the buffer is not managed by the MultiWriter, the buffer must exist at least until the call to endWrite() finishes.

In both cases, modifying the buffer between the call to this method and endWrite() results in undefined behaviour.

Implements Opm::BaseOutputWriter.

◆ attachVectorVertexData()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::attachVectorVertexData	(	VectorBuffer &	buf,
		std::string	name
	)

inlinevirtual

Add a finished vertex centered vector field to the output.

If the buffer is managed by the VtkMultiWriter, it must have been created using allocateManagedBuffer() and may not be used anywhere after calling this method. After the data is written to disk, it will be deleted automatically.

If the buffer is not managed by the MultiWriter, the buffer must exist at least until the call to endWrite() finishes.

In both cases, modifying the buffer between the call to this method and endWrite() results in undefined behavior.

Implements Opm::BaseOutputWriter.

◆ beginWrite()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::beginWrite ( double t )

inlinevirtual

Called whenever a new time step must be written.

Implements Opm::BaseOutputWriter.

References Opm::TaskletRunner::barrier().

Referenced by Opm::FvBaseNewtonConvergenceWriter< TypeTag >::beginIteration(), and Opm::FvBaseProblem< TypeTag >::writeOutput().

◆ curWriterNum()

template<class GridView , int vtkFormat>

int Opm::VtkMultiWriter< GridView, vtkFormat >::curWriterNum ( ) const

inline

Returns the number of the current VTK file.

◆ deserialize()

template<class GridView , int vtkFormat>

template<class Restarter >

void Opm::VtkMultiWriter< GridView, vtkFormat >::deserialize ( Restarter & res )

inline

Read the multi-writer's state from a restart file.

Referenced by Opm::FvBaseProblem< TypeTag >::deserialize().

◆ endWrite()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::endWrite ( bool onlyDiscard = false )

inlinevirtual

Finalizes the current writer.

This means that everything will be written to disk, except if the onlyDiscard argument is true. In this case only all managed buffers are deleted, but no output is written.

Implements Opm::BaseOutputWriter.

References Opm::TaskletRunner::dispatch().

Referenced by Opm::FvBaseNewtonConvergenceWriter< TypeTag >::endIteration(), and Opm::FvBaseProblem< TypeTag >::writeOutput().

◆ gridChanged()

template<class GridView , int vtkFormat>

void Opm::VtkMultiWriter< GridView, vtkFormat >::gridChanged ( )

inline

Updates the internal data structures after mesh refinement.

If the grid changes between two calls of beginWrite(), this method must be called before the second beginWrite()!

Referenced by Opm::FvBaseProblem< TypeTag >::gridChanged().

◆ serialize()

template<class GridView , int vtkFormat>

template<class Restarter >

void Opm::VtkMultiWriter< GridView, vtkFormat >::serialize ( Restarter & res )

inline

Write the multi-writer's state to a restart file.

Referenced by Opm::FvBaseProblem< TypeTag >::serialize().

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

vtkmultiwriter.hh

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ FunctionPtr

◆ Scalar

◆ ScalarBuffer

◆ Tensor

◆ TensorBuffer

◆ Vector

◆ VectorBuffer

◆ VtkWriter

Constructor & Destructor Documentation

◆ VtkMultiWriter()

◆ ~VtkMultiWriter()

Member Function Documentation

◆ allocateManagedScalarBuffer()

◆ allocateManagedVectorBuffer()

◆ attachScalarElementData()

◆ attachScalarVertexData()

◆ attachTensorElementData()

◆ attachTensorVertexData()

◆ attachVectorElementData()

◆ attachVectorVertexData()

◆ beginWrite()

◆ curWriterNum()

◆ deserialize()

◆ endWrite()

◆ gridChanged()

◆ serialize()