Writer for the output of subsampled grid functions in the vtk format. More...

#include <dune/grid/io/file/vtk/subsamplingvtkwriter.hh>

Inheritance diagram for Dune::SubsamplingVTKWriter< GridView >:

Public Types
typedef Dune::VTKFunction< GridView >	VTKFunction

Public Member Functions
	SubsamplingVTKWriter (const GridView &gridView, Dune::RefinementIntervals intervals_, bool coerceToSimplex_=false, VTK::Precision coordPrecision=VTK::Precision::float32)
	Construct a SubsamplingVTKWriter working on a specific GridView. More...

void	addVertexData (const std::shared_ptr< const VTKFunction > &p)
	Add a grid function that lives on the vertices of the grid to the visualization. More...

template<typename F >
void	addVertexData (F &&f, VTK::FieldInfo vtkFieldInfo)
	Add a function by sampling it on the grid vertices. More...

template<class Container >
void	addVertexData (const Container &v, const std::string &name, int ncomps=1, VTK::Precision prec=VTK::Precision::float32)
	Add a grid function (represented by container) that lives on the vertices of the grid to the visualization output. More...

void	addCellData (const std::shared_ptr< const VTKFunction > &p)
	Add a grid function that lives on the cells of the grid to the visualization. More...

template<typename F >
void	addCellData (F &&f, VTK::FieldInfo vtkFieldInfo)
	Add a function by sampling it on the element centers. More...

template<class Container >
void	addCellData (const Container &v, const std::string &name, int ncomps=1, VTK::Precision prec=VTK::Precision::float32)
	Add a grid function (represented by container) that lives on the cells of the grid to the visualization. More...

void	clear ()
	clear list of registered functions More...

VTK::Precision	coordPrecision () const
	get the precision with which coordinates are written out More...

std::string	write (const std::string &name, VTK::OutputType type=VTK::ascii)
	write output (interface might change later) More...

std::string	pwrite (const std::string &name, const std::string &path, const std::string &extendpath, VTK::OutputType type=VTK::ascii)
	write output (interface might change later) More...

Protected Member Functions
virtual void	countEntities (int &nvertices_, int &ncells_, int &ncorners_)
	count the vertices, cells and corners More...

virtual void	writeCellData (VTK::VTUWriter &writer)
	write cell data More...

virtual void	writeVertexData (VTK::VTUWriter &writer)
	write vertex data More...

virtual void	writeGridPoints (VTK::VTUWriter &writer)
	write the positions of vertices More...

virtual void	writeGridCells (VTK::VTUWriter &writer)
	write the connectivity array More...

CornerIterator	cornerBegin () const

CornerIterator	cornerEnd () const

std::string	write (const std::string &name, VTK::OutputType type, const int commRank, const int commSize)
	write output (interface might change later) More...

std::string	pwrite (const std::string &name, const std::string &path, const std::string &extendpath, VTK::OutputType ot, const int commRank, const int commSize)
	write output; interface might change later More...

std::string	getParallelPieceName (const std::string &name, const std::string &path, int commRank, int commSize) const
	return name of a parallel piece file (or header name) More...

std::string	getParallelHeaderName (const std::string &name, const std::string &path, int commSize) const
	return name of a parallel header file More...

std::string	getSerialPieceName (const std::string &name, const std::string &path) const
	return name of a serial piece file More...

std::string	getFormatString () const

std::string	getTypeString () const

template<typename T >
std::tuple< std::string, std::string >	getDataNames (const T &data) const

template<typename Data , typename Iterator >
void	writeData (VTK::VTUWriter &writer, const Data &data, const Iterator begin, const Iterator end, int nentries)

bool	checkForPolyhedralCells () const

virtual void	writeCellFaces (VTK::VTUWriter &writer)
	write the connectivity array More...

template<class CornerIterator , class IndexSet , class T >
void	fillFaceVertices (CornerIterator it, const CornerIterator end, const IndexSet &indexSet, std::vector< T > &faces, std::vector< T > &faceOffsets)

Static Protected Member Functions
template<class Entity , class IndexSet , class T >
static void	fillFacesForElement (const Entity &element, const IndexSet &indexSet, const std::vector< T > &vertices, T &offset, std::vector< T > &faces, std::vector< T > &faceOffsets)

Protected Attributes
GridView	gridView_

Detailed Description

template<class GridView>
class Dune::SubsamplingVTKWriter< GridView >

Writer for the output of subsampled grid functions in the vtk format.

Writes arbitrary grid functions (living on cells or vertices of a grid) to a file suitable for easy visualization with The Visualization Toolkit (VTK). In contrast to the regular VTKWriter, this Writer allows subsampling of the elements via VirtualRefinement. The SubSamplingVTKWriter always writes nonconforming data.

Member Typedef Documentation

◆ VTKFunction

template<class GridView >

typedef Dune::VTKFunction< GridView > Dune::VTKWriter< GridView >::VTKFunction

inherited

Constructor & Destructor Documentation

◆ SubsamplingVTKWriter()

template<class GridView >

Dune::SubsamplingVTKWriter< GridView >::SubsamplingVTKWriter	(	const GridView &	gridView,
		Dune::RefinementIntervals	intervals_,
		bool	coerceToSimplex_ = `false`,
		VTK::Precision	coordPrecision = `VTK::Precision::float32`
	)

inlineexplicit

Construct a SubsamplingVTKWriter working on a specific GridView.

Parameters

gridView	The gridView the grid functions live on. (E. g. a LevelGridView.)
intervals_	A wrapper for the number of refined intervals on one axis as returned by either refinementIntervals() or refinementLevels().
coerceToSimplex_	Set this to true to always triangulate elements into simplices, even where it's not necessary (i.e. for hypercubes).
coordPrecision	the precision in which to write out coordinates

The datamode is always nonconforming.

Member Function Documentation

◆ addCellData() [1/3]

template<class GridView >

template<class Container >

void Dune::VTKWriter< GridView >::addCellData	(	const Container &	v,
		const std::string &	name,
		int	ncomps = `1`,
		VTK::Precision	prec = `VTK::Precision::float32`
	)

inline

Add a grid function (represented by container) that lives on the cells of the grid to the visualization.

The container has to have random access via operator[] (e.g. std::vector). The value of the grid function for an arbitrary element will be accessed by calling operator[] with the index (corresponding to the index from the MGMC mapper on the grid view) of the element. For vector valued data all components for an element are assumed to be consecutive.

Parameters

v	The container with the values of the grid function for each cell.
name	A name to identify the grid function.
ncomps	Number of components (default is 1).

◆ addCellData() [2/3]

template<class GridView >

void Dune::VTKWriter< GridView >::addCellData ( const std::shared_ptr< const VTKFunction > & p )

inline

Add a grid function that lives on the cells of the grid to the visualization.

Parameters

p	std::shared_ptr to the function to visualize

◆ addCellData() [3/3]

template<class GridView >

template<typename F >

void Dune::VTKWriter< GridView >::addCellData	(	F &&	f,
		VTK::FieldInfo	vtkFieldInfo
	)

inline

Add a function by sampling it on the element centers.

Parameters

f	The function to be written to the file

The object f can be one of several things. Depending on what it is exactly, its object life-time is influenced in different ways:

If f has the method bind(), then a copy of f is stored, regardless of whether f is an l- or r-value.
If f can be localized by calling localFunction(f), then a copy of localFunction(f) is stored, but f is never stored, regardless of whether f is an l- or r-value.
If f supports neither bind() or localFunction(), then a copy of f is stored, regardless if f is an l- or r-value.

The previous paragraph actually refers to parts of the dune-functions interface, and you may want to read up on that if you want to write functions to VTK.

Deprecated:: f may also be a VTKFunction object, but you are strongly discouraged from using VTKFunctions.

◆ addVertexData() [1/3]

template<class GridView >

template<class Container >

void Dune::VTKWriter< GridView >::addVertexData	(	const Container &	v,
		const std::string &	name,
		int	ncomps = `1`,
		VTK::Precision	prec = `VTK::Precision::float32`
	)

inline

Add a grid function (represented by container) that lives on the vertices of the grid to the visualization output.

The container has to have random access via operator[] (e.g. std::vector). The value of the grid function for an arbitrary element will be accessed by calling operator[] with the index (corresponding to the index from the MGMC mapper on the grid view) of the vertex. For vector valued data all components for a vertex are assumed to be consecutive.

Parameters

v	The container with the values of the grid function for each vertex.
name	A name to identify the grid function.
ncomps	Number of components (default is 1).

◆ addVertexData() [2/3]

template<class GridView >

void Dune::VTKWriter< GridView >::addVertexData ( const std::shared_ptr< const VTKFunction > & p )

inline

Add a grid function that lives on the vertices of the grid to the visualization.

Parameters

p	std::shared_ptr to the function to visualize

◆ addVertexData() [3/3]

template<class GridView >

template<typename F >

void Dune::VTKWriter< GridView >::addVertexData	(	F &&	f,
		VTK::FieldInfo	vtkFieldInfo
	)

inline

Add a function by sampling it on the grid vertices.

Parameters

f	The function to be written to the file

The object f can be one of several things. Depending on what it is exactly, its object life-time is influenced in different ways:

If f has the method bind(), then a copy of f is stored, regardless of whether f is an l- or r-value.
If f can be localized by calling localFunction(f), then a copy of localFunction(f) is stored, but f is never stored, regardless of whether f is an l- or r-value.
If f supports neither bind() or localFunction(), then a copy of f is stored, regardless if f is an l- or r-value.

The previous paragraph actually refers to parts of the dune-functions interface, and you may want to read up on that if you want to write functions to VTK.

Deprecated:: f may also be a VTKFunction object, but you are strongly discouraged from using VTKFunctions.

◆ checkForPolyhedralCells()

template<class GridView >

bool Dune::VTKWriter< GridView >::checkForPolyhedralCells ( ) const

inlineprotectedinherited

◆ clear()

template<class GridView >

void Dune::VTKWriter< GridView >::clear ( )

inlineinherited

clear list of registered functions

◆ coordPrecision()

template<class GridView >

VTK::Precision Dune::VTKWriter< GridView >::coordPrecision ( ) const

inlineinherited

get the precision with which coordinates are written out

◆ cornerBegin()

template<class GridView >

CornerIterator Dune::VTKWriter< GridView >::cornerBegin ( ) const

inlineprotectedinherited

◆ cornerEnd()

template<class GridView >

CornerIterator Dune::VTKWriter< GridView >::cornerEnd ( ) const

inlineprotectedinherited

◆ countEntities()

template<class GridView >

void Dune::SubsamplingVTKWriter< GridView >::countEntities	(	int &	nvertices_,
		int &	ncells_,
		int &	ncorners_
	)

protectedvirtual

count the vertices, cells and corners

Reimplemented from Dune::VTKWriter< GridView >.

◆ fillFacesForElement()

template<class GridView >

template<class Entity , class IndexSet , class T >

static void Dune::VTKWriter< GridView >::fillFacesForElement	(	const Entity &	element,
		const IndexSet &	indexSet,
		const std::vector< T > &	vertices,
		T &	offset,
		std::vector< T > &	faces,
		std::vector< T > &	faceOffsets
	)

inlinestaticprotectedinherited

◆ fillFaceVertices()

template<class GridView >

template<class CornerIterator , class IndexSet , class T >

void Dune::VTKWriter< GridView >::fillFaceVertices	(	CornerIterator	it,
		const CornerIterator	end,
		const IndexSet &	indexSet,
		std::vector< T > &	faces,
		std::vector< T > &	faceOffsets
	)

inlineprotectedinherited

◆ getDataNames()

template<class GridView >

template<typename T >

std::tuple< std::string, std::string > Dune::VTKWriter< GridView >::getDataNames ( const T & data ) const

inlineprotectedinherited

◆ getFormatString()

template<class GridView >

std::string Dune::VTKWriter< GridView >::getFormatString ( ) const

inlineprotectedinherited

◆ getParallelHeaderName()

template<class GridView >

std::string Dune::VTKWriter< GridView >::getParallelHeaderName	(	const std::string &	name,
		const std::string &	path,
		int	commSize
	)		const

inlineprotectedinherited

return name of a parallel header file

Parameters

name	Base name of the VTK output. This should be without any directory parts and without a filename extension.
path	Directory part of the resulting header name. May be empty, in which case the resulting name will not have a directory part. If non-empty, may or may not have a trailing '/'. If a trailing slash is missing, one is appended implicitly.
commSize	Number of processes writing a parallel vtk output.

◆ getParallelPieceName()

template<class GridView >

std::string Dune::VTKWriter< GridView >::getParallelPieceName	(	const std::string &	name,
		const std::string &	path,
		int	commRank,
		int	commSize
	)		const

inlineprotectedinherited

return name of a parallel piece file (or header name)

Parameters

name	Base name of the VTK output. This should be without any directory parts and without a filename extension.
path	Directory part of the resulting piece name. May be empty, in which case the resulting name will not have a directory part. If non-empty, may or may not have a trailing '/'. If a trailing slash is missing, one is appended implicitly.
commRank	Rank of the process to generate a piece name for. if (-1) then the header is created.
commSize	Number of processes writing a parallel vtk output.

◆ getSerialPieceName()

template<class GridView >

std::string Dune::VTKWriter< GridView >::getSerialPieceName	(	const std::string &	name,
		const std::string &	path
	)		const

inlineprotectedinherited

return name of a serial piece file

This is similar to getParallelPieceName, but skips the prefixes for commSize ("s####-") and commRank ("p####-").

Parameters

name	Base name of the VTK output. This should be without any directory parts and without a filename extension.
path	Directory part of the resulting piece name. May be empty, in which case the resulting name will not have a directory part. If non-empty, may or may not have a trailing '/'. If a trailing slash is missing, one is appended implicitly.

◆ getTypeString()

template<class GridView >

std::string Dune::VTKWriter< GridView >::getTypeString ( ) const

inlineprotectedinherited

◆ pwrite() [1/2]

template<class GridView >

std::string Dune::VTKWriter< GridView >::pwrite	(	const std::string &	name,
		const std::string &	path,
		const std::string &	extendpath,
		VTK::OutputType	ot,
		const int	commRank,
		const int	commSize
	)

inlineprotectedinherited

write output; interface might change later

Parameters

name	Base name of the output files. This should not contain any directory part and not filename extensions. It will be used both for each processes piece as well as the parallel collection file.
path	Directory where to put the parallel collection (.pvtu/.pvtp) file. If it is relative, it is taken realtive to the current directory.
extendpath	Directory where to put the piece file (.vtu/.vtp) of this process. If it is relative, it is taken relative to the directory denoted by path.
ot	How to encode the data in the file.
commRank	Rank of the current process.
commSize	Number of processes taking part in this write operation.

Note: Currently, extendpath may not be absolute unless path is absolute, because that would require the value of the current directory.

Exceptions

NotImplemented	Extendpath is absolute but path is relative.
IOError	Failed to open a file.

◆ pwrite() [2/2]

template<class GridView >

std::string Dune::VTKWriter< GridView >::pwrite	(	const std::string &	name,
		const std::string &	path,
		const std::string &	extendpath,
		VTK::OutputType	type = `VTK::ascii`
	)

inlineinherited

write output (interface might change later)

"pwrite" means "path write" (i.e. write somewhere else than the current directory). The "p" does not mean this method has a monopoly on parallel writing, the regular write(const std::string &, VTK::OutputType) method can do that just fine.

Parameters

name	Base name of the output files. This should not contain any directory part and not filename extensions. It will be used both for each processes piece as well as the parallel collection file.
path	Directory where to put the parallel collection (.pvtu/.pvtp) file. If it is relative, it is taken relative to the current directory.
extendpath	Directory where to put the piece file (.vtu/.vtp) of this process. If it is relative, it is taken relative to the directory denoted by path.
type	How to encode the data in the file.

Note: Currently, extendpath may not be absolute unless path is absolute, because that would require the value of the current directory.

Exceptions

NotImplemented	Extendpath is absolute but path is relative.
IOError	Failed to open a file.

◆ write() [1/2]

template<class GridView >

std::string Dune::VTKWriter< GridView >::write	(	const std::string &	name,
		VTK::OutputType	type,
		const int	commRank,
		const int	commSize
	)

inlineprotectedinherited

write output (interface might change later)

This method can be used in parallel as well as in serial programs. For serial runs (commSize=1) it chooses other names without the "s####-p####-" prefix for the .vtu/.vtp files and omits writing of the .pvtu/pvtp file however. For parallel runs (commSize > 1) it is the same as a call to pwrite() with name and path constructed from a given filename possibly containing a path, and extendpath="".

Parameters

name	Base name of the output files. This should not contain any directory part and no filename extensions.
type	How to encode the data in the file.
commRank	Rank of the current process.
commSize	Number of processes taking part in this write operation.

◆ write() [2/2]

template<class GridView >

std::string Dune::VTKWriter< GridView >::write	(	const std::string &	name,
		VTK::OutputType	type = `VTK::ascii`
	)

inlineinherited

write output (interface might change later)

This method can be used in parallel as well as in serial programs. For serial runs (commSize=1) it chooses other names without the "s####-p####-" prefix for the .vtu/.vtp files and omits writing of the .pvtu/pvtp file however. For parallel runs (commSize > 1) it is the same as a call to pwrite() with name and path constructed from a given filename possibly containing a path, and extendpath="".

Parameters

[in]	name	basic name to write (may not contain a path)
[in]	type	type of output (e.g,, ASCII) (optional)

◆ writeCellData()

template<class GridView >

void Dune::SubsamplingVTKWriter< GridView >::writeCellData ( VTK::VTUWriter & writer )

protectedvirtual

write cell data

Reimplemented from Dune::VTKWriter< GridView >.

◆ writeCellFaces()

template<class GridView >

virtual void Dune::VTKWriter< GridView >::writeCellFaces ( VTK::VTUWriter & writer )

inlineprotectedvirtualinherited

write the connectivity array

◆ writeData()

template<class GridView >

template<typename Data , typename Iterator >

void Dune::VTKWriter< GridView >::writeData	(	VTK::VTUWriter &	writer,
		const Data &	data,
		const Iterator	begin,
		const Iterator	end,
		int	nentries
	)

inlineprotectedinherited

◆ writeGridCells()

template<class GridView >

void Dune::SubsamplingVTKWriter< GridView >::writeGridCells ( VTK::VTUWriter & writer )

protectedvirtual

write the connectivity array

Reimplemented from Dune::VTKWriter< GridView >.

◆ writeGridPoints()

template<class GridView >

void Dune::SubsamplingVTKWriter< GridView >::writeGridPoints ( VTK::VTUWriter & writer )

protectedvirtual

write the positions of vertices

Reimplemented from Dune::VTKWriter< GridView >.

◆ writeVertexData()

template<class GridView >

void Dune::SubsamplingVTKWriter< GridView >::writeVertexData ( VTK::VTUWriter & writer )

protectedvirtual

write vertex data

Reimplemented from Dune::VTKWriter< GridView >.

Member Data Documentation

◆ gridView_

template<class GridView >

GridView Dune::VTKWriter< GridView >::gridView_

protectedinherited

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

subsamplingvtkwriter.hh

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ VTKFunction

Constructor & Destructor Documentation

◆ SubsamplingVTKWriter()

Member Function Documentation

◆ addCellData() [1/3]

◆ addCellData() [2/3]

◆ addCellData() [3/3]

◆ addVertexData() [1/3]

◆ addVertexData() [2/3]

◆ addVertexData() [3/3]

◆ checkForPolyhedralCells()

◆ clear()

◆ coordPrecision()

◆ cornerBegin()

◆ cornerEnd()

◆ countEntities()

◆ fillFacesForElement()

◆ fillFaceVertices()

◆ getDataNames()

◆ getFormatString()

◆ getParallelHeaderName()

◆ getParallelPieceName()

◆ getSerialPieceName()

◆ getTypeString()

◆ pwrite() [1/2]

◆ pwrite() [2/2]

◆ write() [1/2]

◆ write() [2/2]

◆ writeCellData()

◆ writeCellFaces()

◆ writeData()

◆ writeGridCells()

◆ writeGridPoints()

◆ writeVertexData()

Member Data Documentation

◆ gridView_