Dune::Entity< cd, dim, GridImp, EntityImp > Class Template Reference

Wrapper class for entities. More...

#include <dune/grid/common/entity.hh>

Protected Member Functions
Implementation &	impl ()
	Return reference to the real implementation.
const Implementation &	impl () const
	Return const reference to the real implementation.

Exported types and constants
enum	{ codimension =cd }
enum	{ dimension =dim }
enum	{ mydimension =dim-cd }
typedef GridImp::template Codim< cd >::Geometry	Geometry
	The corresponding geometry type.
typedef GridImp::template Codim< cd >::EntitySeed	EntitySeed
	The corresponding entity seed (for storage of entities)
typedef GridImp::ctype ctype	DUNE_DEPRECATED_MSG("Use Geometry::ctype instead!")
	coordinate type of the Grid
static const int	DUNE_DEPRECATED_MSG ("Use Geometry::coorddimension instead!") dimensionworld
	Know the dimension of world.

Interface for the implementor
	Entity (const Entity &rhs)
Entity &	operator= (const Entity &rhs)
	Entity (const EntityImp< cd, dim, GridImp > &e)
	Copy constructor from EntityImp.

Methods shared by entities of all codimensions
int	level () const
	The level of this entity.
PartitionType	partitionType () const
	Partition type of this entity.
Geometry	geometry () const
	obtain geometric realization of the entity More...
GeometryType	type () const
	Return the name of the reference element. The type can be used to access the Dune::ReferenceElement.
EntitySeed	seed () const
	Return the entity seed which contains sufficient information to generate the entity again and uses as little memory as possible.

Detailed Description

template<int cd, int dim, class GridImp, template< int, int, class > class EntityImp>
class Dune::Entity< cd, dim, GridImp, EntityImp >

Wrapper class for entities.

Template Parameters

cd	Codimension of the entity
dim	Dimension of the grid
GridImp	Type that is a model of Dune::Grid
EntityImp	Class template that is a model of Dune::Entity

Engine Concept

This class wraps a object of type EntityImp and forwards all member function calls to corresponding members of this class. In that sense Entity defines the interface and EntityImp supplies the implementation. For various reasons we do not use an inheritance hierarchy and the Barton-Nackman trick here.

Specialization

The Entity class template is specialized for cd=0 (elements, Dune::Entity<0,dim,GridImp,EntityImp>). This case has an extended interface. The methods defined in the general template are provided by the specialization as well. We did not use inheritance because different implementations for different codimensions may be required and virtual functions had to be avoided.

View concept

Entities can not be created, assigned or otherwise modified outside the interface in the user code. They are only accessible by immutable iterators provided on the corresponding grid class.

The only way to modify the entities of a grid is through grid adaptation which consists of tagging entities (of codimension 0) for refinement and then calling the adapt() method on the grid.

Member Enumeration Documentation

anonymous enum

template<int cd, int dim, class GridImp , template< int, int, class > class EntityImp>

anonymous enum

Enumerator
codimension	Know your own codimension.

anonymous enum

template<int cd, int dim, class GridImp , template< int, int, class > class EntityImp>

anonymous enum

Enumerator
dimension	Know the grid dimension.

anonymous enum

template<int cd, int dim, class GridImp , template< int, int, class > class EntityImp>

anonymous enum

Enumerator
mydimension	Dimensionality of the reference element of the entity.

Constructor & Destructor Documentation

Entity()

template<int cd, int dim, class GridImp , template< int, int, class > class EntityImp>

Dune::Entity< cd, dim, GridImp, EntityImp >::Entity ( const Entity< cd, dim, GridImp, EntityImp > &  rhs )

inlineprotected

hide copy constructor

Member Function Documentation

geometry()

template<int cd, int dim, class GridImp , template< int, int, class > class EntityImp>

Geometry Dune::Entity< cd, dim, GridImp, EntityImp >::geometry ( ) const

inline

obtain geometric realization of the entity

Each entity provides an object of type Dune::Geometry< dimension-codimension, dimensionworld, ... > that represents the map from a reference element to world coordinates.

Note

Previously, the geometry was encapsulated in the entity object and a const reference was returned.

The returned geometry object is guaranteed to remain valid until the grid is modified (or deleted).

operator=()

template<int cd, int dim, class GridImp , template< int, int, class > class EntityImp>

Entity& Dune::Entity< cd, dim, GridImp, EntityImp >::operator= ( const Entity< cd, dim, GridImp, EntityImp > &  rhs )

inlineprotected

hide assignment operator

---

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

• dune/grid/common/entity.hh