specialization of the generic GridFactory for AlbertaGrid More...

#include <dune/grid/albertagrid/gridfactory.hh>

Inheritance diagram for Dune::GridFactory< AlbertaGrid< dim, dimworld > >:

Classes
struct	Codim
class	ProjectionFactory

Public Types
typedef AlbertaGrid< dim, dimworld >	Grid
	type of grid this factory is for
typedef Grid::ctype	ctype
	type of (scalar) coordinates
typedef FieldVector< ctype, dimensionworld >	WorldVector
	type of vector for world coordinates
typedef FieldMatrix< ctype, dimensionworld, dimensionworld >	WorldMatrix
	type of matrix from world coordinates to world coordinates
typedef DuneBoundaryProjection< dimensionworld >	DuneProjection
typedef std::shared_ptr< const DuneProjection >	DuneProjectionPtr
typedef Dune::BoundarySegment< dimension, dimensionworld >	BoundarySegment
using	Communication

Public Member Functions
	GridFactory ()
virtual	~GridFactory ()
virtual void	insertVertex (const WorldVector &pos)
	insert a vertex into the macro grid
virtual void	insertElement (const GeometryType &type, const std::vector< unsigned int > &vertices)
	insert an element into the macro grid
virtual void	insertBoundary (int element, int face, int id)
	mark a face as boundary (and assign a boundary id)
virtual void	insertBoundaryProjection (const GeometryType &type, const std::vector< unsigned int > &vertices, const DuneProjection *projection)
	insert a boundary projection into the macro grid
virtual void	insertBoundaryProjection (const DuneProjection *projection)
	insert a global (boundary) projection into the macro grid
virtual void	insertBoundarySegment (const std::vector< unsigned int > &vertices)
	insert a boundary segment into the macro grid
virtual void	insertBoundarySegment (const std::vector< unsigned int > &vertices, const std::shared_ptr< BoundarySegment > &boundarySegment)
	insert a shaped boundary segment into the macro grid
void	insertFaceTransformation (const WorldMatrix &matrix, const WorldVector &shift)
	add a face transformation (for periodic identification)
void	markLongestEdge ()
	mark the longest edge as refinemet edge
std::unique_ptr< Grid >	createGrid ()
	finalize grid creation and hand over the grid
bool	write (const std::string &filename)
	write out the macro triangulation in native grid file format
virtual unsigned int	insertionIndex (const typename Codim< 0 >::Entity &entity) const
virtual unsigned int	insertionIndex (const typename Codim< dimension >::Entity &entity) const
virtual unsigned int	insertionIndex (const typename Grid::LeafIntersection &intersection) const
virtual bool	wasInserted (const typename Grid::LeafIntersection &intersection) const
virtual void	insertBoundarySegment (const std::vector< unsigned int > &vertices, const std::shared_ptr< BoundarySegment< dimension, dimworld > > &boundarySegment)
	insert an arbitrarily shaped boundary segment
virtual void	insertElement (const GeometryType &type, const std::vector< unsigned int > &vertices, std::function< FieldVector< ctype, dimworld >(FieldVector< ctype, dimension >)> elementParametrization)
	Insert a parametrized element into the coarse grid.
virtual unsigned int	insertionIndex (const typename Codim< 0 >::Entity &entity) const
	obtain an element's insertion index
virtual unsigned int	insertionIndex (const typename Codim< dimension >::Entity &entity) const
	obtain a vertex' insertion index
virtual unsigned int	insertionIndex (const typename AlbertaGrid< dim, dimworld >::LeafIntersection &intersection) const
	obtain a boundary's insertion index
virtual bool	wasInserted (const typename AlbertaGrid< dim, dimworld >::LeafIntersection &intersection) const
	determine whether an intersection was inserted
Communication	comm () const
	Return the Communication used by the grid factory.
virtual void	insertVertex (const FieldVector< ctype, dimworld > &pos)=0
	Insert a vertex into the coarse grid.
virtual unsigned int	insertionIndex (const typename Codim< 0 >::Entity &entity) const
	obtain an element's insertion index

Static Public Member Functions
static void	destroyGrid (Grid *grid)
	destroy a grid previously obtain from this factory

Static Public Attributes
static const int	dimension = Grid::dimension
	dimension of the grid
static const int	dimensionworld = Grid::dimensionworld
	dimension of the world
static const bool	supportsBoundaryIds = true
	are boundary ids supported by this factory?
static const bool	supportPeriodicity = MacroData::supportPeriodicity
	is the factory able to create periodic meshes?

Static Protected Attributes
static const int	dimension
	dimension of the grid

Detailed Description

template<int dim, int dimworld>
class Dune::GridFactory< AlbertaGrid< dim, dimworld > >

specialization of the generic GridFactory for AlbertaGrid

The GridFactory for AlbertaGrid adds some extensions to the standard GridFactoryInterface. It provides the following additional features:

It allows to set boundary ids via insertBoundary. For ALBERTA 1.2, these boundary ids are ignored, though.
For ALBERTA 3.0 and above, you can add face transformation to identify faces. This allows the construction of periodic grids.
The grid can be written in ALBERTA's native format for macro triangulations via write (both ASCII and XDR format are supported).
On grid creation, a name can be assigned to the grid.
On grid creation, the grid can be reordered such that ALBERTA uses the longest edge as refinement edge during recursive bisection.

Member Typedef Documentation

◆ BoundarySegment

template<int dim, int dimworld>

typedef Dune::BoundarySegment< dimension, dimensionworld > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::BoundarySegment

◆ Communication

using Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::Communication

◆ ctype

template<int dim, int dimworld>

typedef Grid::ctype Dune::GridFactory< AlbertaGrid< dim, dimworld > >::ctype

type of (scalar) coordinates

◆ DuneProjection

template<int dim, int dimworld>

typedef DuneBoundaryProjection< dimensionworld > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::DuneProjection

◆ DuneProjectionPtr

template<int dim, int dimworld>

typedef std::shared_ptr< const DuneProjection > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::DuneProjectionPtr

◆ Grid

template<int dim, int dimworld>

typedef AlbertaGrid< dim, dimworld > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::Grid

type of grid this factory is for

◆ WorldMatrix

template<int dim, int dimworld>

typedef FieldMatrix< ctype, dimensionworld, dimensionworld > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::WorldMatrix

type of matrix from world coordinates to world coordinates

◆ WorldVector

template<int dim, int dimworld>

typedef FieldVector< ctype, dimensionworld > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::WorldVector

type of vector for world coordinates

Constructor & Destructor Documentation

◆ GridFactory()

template<int dim, int dimworld>

Dune::GridFactory< AlbertaGrid< dim, dimworld > >::GridFactory ( )

inline

default constructor

◆ ~GridFactory()

template<int dim, int dimworld>

Dune::GridFactory< AlbertaGrid< dim, dimworld > >::~GridFactory ( )

virtual

Member Function Documentation

◆ comm()

Communication Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::comm ( ) const

inline

Return the Communication used by the grid factory.

Defaults to the Communication induced by the process-local communicator.

◆ createGrid()

template<int dim, int dimworld>

std::unique_ptr< Grid > Dune::GridFactory< AlbertaGrid< dim, dimworld > >::createGrid ( )

inlinevirtual

finalize grid creation and hand over the grid

This version of createGrid is original to the AlbertaGrid grid factroy, allowing to specity a grid name.

Returns: a pointer to the newly created grid

Note: The caller takes responsibility of freeing the memory allocated for the grid.; ALBERTA's grid factory provides a static method for freeing the grid (destroyGrid).

Implements Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >.

◆ destroyGrid()

template<int dim, int dimworld>

void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::destroyGrid ( Grid * grid )

inlinestatic

destroy a grid previously obtain from this factory

Parameters

[in] grid pointer to the grid to destroy

◆ insertBoundary()

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertBoundary	(	int	element,
		int	face,
		int	id )

inlinevirtual

mark a face as boundary (and assign a boundary id)

◆ insertBoundaryProjection() [1/2]

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertBoundaryProjection ( const DuneProjection * projection )

inlinevirtual

insert a global (boundary) projection into the macro grid

◆ insertBoundaryProjection() [2/2]

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertBoundaryProjection	(	const GeometryType &	type,
		const std::vector< unsigned int > &	vertices,
		const DuneProjection *	projection )

inlinevirtual

insert a boundary projection into the macro grid

◆ insertBoundarySegment() [1/3]

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertBoundarySegment ( const std::vector< unsigned int > & vertices )

inlinevirtual

insert a boundary segment into the macro grid

Only influences the ordering of the boundary segments

Parameters

[in] vertices vertex indices of boundary face

Implements Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >.

◆ insertBoundarySegment() [2/3]

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertBoundarySegment	(	const std::vector< unsigned int > &	vertices,
		const std::shared_ptr< BoundarySegment > &	boundarySegment )

inlinevirtual

insert a shaped boundary segment into the macro grid

Parameters

[in]	vertices	vertex indices of boundary face
[in]	boundarySegment	geometric realization of shaped boundary

◆ insertBoundarySegment() [3/3]

	(	const std::vector< unsigned int > &	vertices,
		const std::shared_ptr< BoundarySegment< dimension, dimworld > > &	boundarySegment )

insert an arbitrarily shaped boundary segment

This method inserts a boundary segment into the coarse grid.

Parameters

[in]	vertices	the indices of the vertices of the segment
[in]	boundarySegment	user defined implementation of the boundary segment's geometry

◆ insertElement() [1/2]

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertElement	(	const GeometryType &	type,
		const std::vector< unsigned int > &	vertices )

inlinevirtual

insert an element into the macro grid

Parameters

[in]	type	GeometryType of the new element
[in]	vertices	indices of the element vertices (in DUNE numbering)

Implements Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >.

◆ insertElement() [2/2]

virtual void Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::insertElement	(	const GeometryType &	type,
		const std::vector< unsigned int > &	vertices,
		std::function< FieldVector< ctype, dimworld >(FieldVector< ctype, dimension >)>	elementParametrization )

inlinevirtual

Insert a parametrized element into the coarse grid.

Parameters

type	The GeometryType of the new element
vertices	The vertices of the new element, using the DUNE numbering
elementParametrization	A function prescribing the shape of this element

Make sure the inserted element is not inverted (this holds even for simplices). There are grids that can't handle inverted elements.

◆ insertFaceTransformation()

template<int dim, int dimworld>

void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertFaceTransformation	(	const WorldMatrix &	matrix,
		const WorldVector &	shift )

inline

add a face transformation (for periodic identification)

A face transformation is an affine mapping T from world coordinates to world coordinates. ALBERTA periodically identifies two faces f and g if T( f ) = g or T( g ) = f.

Parameters

[in]	matrix	matrix describing the linear part of T
[in]	shift	vector describing T( 0 )

Note: ALBERTA requires the matrix to be orthogonal.; ALBERTA automatically adds the inverse transformation.

◆ insertionIndex() [1/7]

virtual unsigned int Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename AlbertaGrid< dim, dimworld >::LeafIntersection & intersection ) const

inlinevirtual

obtain a boundary's insertion index

Data can be associated to the created macro grid using the insertion index of each entity that has been inserted during the grid creation process.

Between grid construction (createGrid) and the first grid modification, this method allows to obtain this insertion index from the grid factory. This way, data can be stored using the index maps provided by the grid.

Parameters

[in] intersection intersection whose insertion index is requested

Returns: insertion index of the intersection

Note: The insertion index can only be obtained for boundary intersections that were actually inserted (see also wasInserted).

◆ insertionIndex() [2/7]

template<int dim, int dimworld>

virtual unsigned int Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename Codim< 0 >::Entity & entity ) const

inlinevirtual

◆ insertionIndex() [3/7]

virtual unsigned int Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename Codim< 0 >::Entity & entity ) const

inlinevirtual

obtain an element's insertion index

Data can be associated to the created macro grid using the insertion index of each entity that has been inserted during the grid creation process.

Between grid construction (createGrid) and the first grid modification, this method allows to obtain this insertion index from the grid factory. This way, data can be stored using the index maps provided by the grid.

Parameters

[in] entity entity whose insertion index is requested

Returns: insertion index of the entity

◆ insertionIndex() [4/7]

template<int dim, int dimworld>

virtual unsigned int Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename Codim< dimension >::Entity & entity ) const

inlinevirtual

◆ insertionIndex() [5/7]

virtual unsigned int Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename Codim< dimension >::Entity & entity ) const

inlinevirtual

obtain a vertex' insertion index

Data can be associated to the created macro grid using the insertion index of each entity that has been inserted during the grid creation process.

Between grid construction (createGrid) and the first grid modification, this method allows to obtain this insertion index from the grid factory. This way, data can be stored using the index maps provided by the grid.

Parameters

[in] entity entity whose insertion index is requested

Returns: insertion index of the entity

◆ insertionIndex() [6/7]

template<int dim, int dimworld>

virtual unsigned int Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename Grid::LeafIntersection & intersection ) const

inlinevirtual

◆ insertionIndex() [7/7]

virtual unsigned int Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::insertionIndex ( const typename Codim< 0 >::Entity & entity ) const

inlinevirtualinherited

obtain an element's insertion index

Data can be associated to the created macro grid using the insertion index of each entity that has been inserted during the grid creation process.

Between grid construction (createGrid) and the first grid modification, this method allows to obtain this insertion index from the grid factory. This way, data can be stored using the index maps provided by the grid.

Parameters

[in] entity entity whose insertion index is requested

Returns: insertion index of the entity

◆ insertVertex() [1/2]

template<int dim, int dimworld>

virtual void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertVertex ( const WorldVector & pos )

inlinevirtual

insert a vertex into the macro grid

Parameters

[in] pos position of the vertex (in world coordinates)

◆ insertVertex() [2/2]

virtual void Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::insertVertex ( const FieldVector< ctype, dimworld > & pos )

pure virtualinherited

Insert a vertex into the coarse grid.

◆ markLongestEdge()

template<int dim, int dimworld>

void Dune::GridFactory< AlbertaGrid< dim, dimworld > >::markLongestEdge ( )

inline

mark the longest edge as refinemet edge

Marking the longest edge avoids cycles in the recursive bisection algorithm, if the longest edge of each element is unique. It also makes sure the angles degenerate least. It can, hoowever, produce more nonlocal refinements than necessary. Therefore this feature is disabled by default.

◆ wasInserted() [1/2]

virtual bool Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::wasInserted ( const typename AlbertaGrid< dim, dimworld >::LeafIntersection & intersection ) const

inlinevirtual

determine whether an intersection was inserted

This method allows checking whether an intersection was actually inserted into the grid factory.

Note: Not all boundary segments need to be inserted into the grid factory.; This method returns false for all interior intersections

Parameters

[in] intersection intersection in question

Returns: true, if the intersection was inserted

◆ wasInserted() [2/2]

template<int dim, int dimworld>

virtual bool Dune::GridFactory< AlbertaGrid< dim, dimworld > >::wasInserted ( const typename Grid::LeafIntersection & intersection ) const

inlinevirtual

◆ write()

template<int dim, int dimworld>

bool Dune::GridFactory< AlbertaGrid< dim, dimworld > >::write ( const std::string & filename )

inline

write out the macro triangulation in native grid file format

Parameters

[in] filename name of the file to write to

Returns: true on success

Member Data Documentation

◆ dimension [1/2]

template<int dim, int dimworld>

const int Dune::GridFactory< AlbertaGrid< dim, dimworld > >::dimension = Grid::dimension

static

dimension of the grid

◆ dimension [2/2]

const int Dune::GridFactoryInterface< AlbertaGrid< dim, dimworld > >::dimension

staticprotected

dimension of the grid

◆ dimensionworld

template<int dim, int dimworld>

const int Dune::GridFactory< AlbertaGrid< dim, dimworld > >::dimensionworld = Grid::dimensionworld

static

dimension of the world

◆ supportPeriodicity

template<int dim, int dimworld>

const bool Dune::GridFactory< AlbertaGrid< dim, dimworld > >::supportPeriodicity = MacroData::supportPeriodicity

static

is the factory able to create periodic meshes?

◆ supportsBoundaryIds

template<int dim, int dimworld>

const bool Dune::GridFactory< AlbertaGrid< dim, dimworld > >::supportsBoundaryIds = true

static

are boundary ids supported by this factory?

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

albertagrid/gridfactory.hh

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Static Protected Attributes

Detailed Description

Member Typedef Documentation

◆ BoundarySegment

◆ Communication

◆ ctype

◆ DuneProjection

◆ DuneProjectionPtr

◆ Grid

◆ WorldMatrix

◆ WorldVector

Constructor & Destructor Documentation

◆ GridFactory()

◆ ~GridFactory()

Member Function Documentation

◆ comm()

◆ createGrid()

◆ destroyGrid()

◆ insertBoundary()

◆ insertBoundaryProjection() [1/2]

◆ insertBoundaryProjection() [2/2]

◆ insertBoundarySegment() [1/3]

◆ insertBoundarySegment() [2/3]

◆ insertBoundarySegment() [3/3]

◆ insertElement() [1/2]

◆ insertElement() [2/2]

◆ insertFaceTransformation()

◆ insertionIndex() [1/7]

◆ insertionIndex() [2/7]

◆ insertionIndex() [3/7]

◆ insertionIndex() [4/7]

◆ insertionIndex() [5/7]

◆ insertionIndex() [6/7]

◆ insertionIndex() [7/7]

◆ insertVertex() [1/2]

◆ insertVertex() [2/2]

◆ markLongestEdge()

◆ wasInserted() [1/2]

◆ wasInserted() [2/2]

◆ write()

Member Data Documentation

◆ dimension [1/2]

◆ dimension [2/2]

◆ dimensionworld

◆ supportPeriodicity

◆ supportsBoundaryIds