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

Template specialization of Dune::Entity for Elements (codim==0) More...

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

Classes
struct	Codim
	EntityPointer types of the different codimensions. More...

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 =0 }
enum	{ dimension =dim }
enum	{ mydimension =dim }
typedef GridImp::template Codim< 0 >::Geometry	Geometry
	The geometry type of this entity.
typedef GridImp::template Codim< 0 >::EntitySeed	EntitySeed
	The corresponding entity seed (for storage of entities)
typedef GridImp::template Codim< 0 >::LocalGeometry	LocalGeometry
	The geometry type of this entity when the geometry is expressed embedded in the father element. More...
typedef GridImp::template Codim< 0 >::EntityPointer	EntityPointer
	The codim==0 EntityPointer type.
typedef GridImp::HierarchicIterator	HierarchicIterator
	The HierarchicIterator type.

Exported types and constants
enum	{ codimension =cd }
enum	{ dimension =dim }
enum	{ mydimension =dim-cd }

Interface for the implementor
	Entity (const EntityImp< 0, dim, GridImp > &e)
	Copy constructor from EntityImp.
	Entity (EntityImp< 0, dim, GridImp > &&e)
	Move constructor from EntityImp.

Methods shared by entities of all codimensions
int	level () const
	The level of this entity. More...
PartitionType	partitionType () const
	Partition type of this entity. More...
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.
bool	operator== (const Entity &other) const
	Compares two entities for equality.
bool	operator!= (const Entity &other) const
	Compares two entities for inequality.
template<typename ItImp >
bool	operator== (const Dune::EntityPointer< GridImp, ItImp > &other) const
	Compares an Entity with an EntityPointer for equality. More...
template<typename ItImp >
bool	operator!= (const Dune::EntityPointer< GridImp, ItImp > &other) const
	Compares an Entity with an EntityPointer for equality. More...
	Entity ()
	Entity (const Entity &other)
	Copy constructor from an existing entity.
	Entity (Entity &&other)
	Move constructor from an existing entity.
Entity &	operator= (const Entity &other)
	Copy assignment operator from an existing entity.
Entity &	operator= (Entity &&other)
	Move assignment operator from an existing entity.
const Entity &	operator* () const DUNE_DEPRECATED_MSG("This is now an Entity instead of an EntityPointer. You do not have to dereference it anymore!")
	Dereference Entity to itself for backwards compatibility with EntityPointer. More...
const Entity *	operator-> () const DUNE_DEPRECATED_MSG("This is now an Entity instead of an EntityPointer. You do not have to dereference it anymore!")
	Dereference Entity to itself for backwards compatibility with EntityPointer. More...

Extended interface of entities of codimension 0
template<int codim>
int	DUNE_DEPRECATED_MSG ("Use subEntities(unsigned int) instead!") count() const
	Number of subentities with codimension cc. More...
unsigned int	subEntities (unsigned int codim) const
	Number of subentities with codimension codim. More...
template<int codim>
Codim< codim >::Entity	subEntity (int i) const
	Obtain a subentity. More...
Entity	father () const
	Inter-level access to father entity on the next-coarser grid. The given entity resulted directly from a subdivision of its father entity. The behaviour for elements on the macro grid, that is when hasFather() is false, is undefined. More...
bool	hasFather () const
	Return true if entity has a father entity which can be accessed using the father() method.
bool	isLeaf () const
	Returns true if the entity is contained in the leaf grid.
bool	isRegular () const
	Returns true if element is of regular type in red/green type refinement. In bisection or hanging node refinement this is always true.
LocalGeometry	geometryInFather () const
	Provides information how this element has been subdivided from its father element. More...
HierarchicIterator	hbegin (int maxLevel) const
	Inter-level access to elements that resulted from (recursive) subdivision of this element. More...
HierarchicIterator	hend (int maxLevel) const
	Returns iterator to one past the last son element. More...
bool	isNew () const
	Returns true, if the entity has been created during the last call to adapt()
bool	mightVanish () const
	Returns true, if entity might disappear during the next call to adapt(). If the method returns false, the entity is guaranteed to still be present after adaptation.
bool	hasBoundaryIntersections () const
	Returns true, if entity has intersections with boundary.

Intersection Range
Iterator range for intersections .
template<typename GV , typename Entity >
IteratorRange<... >	intersections (const GV &gv, const Entity &e)
	Iterates over all Intersections of an Entity with respect to the given GridView. More...

Hierarchic Entity range
Iterator range for hierarchic access to the more-refined entities that result from the subdivision of a given element.
template<typename Entity >
IteratorRange<... >	descendantElements (const Entity &e, int maxLevel)
	Iterates over all descendant elements of the given element up to a maximum level. More...

Detailed Description

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

Template specialization of Dune::Entity for Elements (codim==0)

Template Parameters

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

See also

Dune::Entity (general version) for the full documentation

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

Member Typedef Documentation

LocalGeometry

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

typedef GridImp::template Codim<0>::LocalGeometry Dune::Entity< 0, dim, GridImp, EntityImp >::LocalGeometry

The geometry type of this entity when the geometry is expressed embedded in the father element.

This differs from Geometry in particular when dim != dimworld, but even when dim == dimworld the implementation may choose to use a different type here.

Member Enumeration Documentation

anonymous enum

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

anonymous enum

inherited

Enumerator
codimension	Know your own codimension.

anonymous enum

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

anonymous enum

inherited

Enumerator
dimension	Know the grid dimension.

anonymous enum

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

anonymous enum

inherited

Enumerator
mydimension	Dimensionality of the reference element of the entity.

anonymous enum

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

anonymous enum

Enumerator
codimension	Know your own codimension.

anonymous enum

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

anonymous enum

Enumerator
dimension	Know the grid's dimension.

anonymous enum

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

anonymous enum

Enumerator
mydimension	Know dimension of the entity.

Member Function Documentation

DUNE_DEPRECATED_MSG()

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

template<int codim>

int Dune::Entity< 0, dim, GridImp, EntityImp >::DUNE_DEPRECATED_MSG ( "Use subEntities(unsigned int) instead!"  ) const

inline

Number of subentities with codimension cc.

Strictly speaking this method is redundant, because the same information can be obtained from the corresponding reference element. It is here for efficiency reasons only.

Deprecated:

This method will be removed after the release of dune-grid-2.4. Please use the method subEntities instead.

father()

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

Entity Dune::Entity< 0, dim, GridImp, EntityImp >::father ( ) const

inline

Inter-level access to father entity on the next-coarser grid. The given entity resulted directly from a subdivision of its father entity. The behaviour for elements on the macro grid, that is when hasFather() is false, is undefined.

Note

If the partitionType of the Entity is GhostEntity, it is not guaranteed that this method is working or implemented in general. For some grids it might be available, though.

geometry()

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

Geometry Dune::Entity< 0, 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).

geometryInFather()

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

LocalGeometry Dune::Entity< 0, dim, GridImp, EntityImp >::geometryInFather ( ) const

inline

Provides information how this element has been subdivided from its father element.

The returned LocalGeometry is a model of Dune::Geometry<dimension,dimension,...>, mapping the reference element of the given entity to the reference element of its father.

This information is sufficient to interpolate all degrees of freedom in the conforming case. Nonconforming may require access to neighbors of the father and calculations with local coordinates. The on-the-fly case is somewhat inefficient since degrees of freedom may be visited several times. If we store interpolation matrices, this is tolerable. We assume that on-the-fly implementation of interpolation is only done for simple discretizations.

Note

For ghost entities, this method is not guaranteed to be implemented.

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).

hbegin()

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

HierarchicIterator Dune::Entity< 0, dim, GridImp, EntityImp >::hbegin ( int  maxLevel ) const

inline

Inter-level access to elements that resulted from (recursive) subdivision of this element.

Parameters

[in]

maxLevel

Iterator does not stop at elements with level greater than maxlevel.

Returns

Iterator to the first son (level is not greater than maxlevel)

Note

If the partitionType of the Entity is GhostEntity, it is not guaranteed that this method is working or implemented in general. For some grids it might be available, though.

hend()

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

HierarchicIterator Dune::Entity< 0, dim, GridImp, EntityImp >::hend ( int  maxLevel ) const

inline

Returns iterator to one past the last son element.

Note

If the partitionType of the Entity is GhostEntity, it is not guaranteed that this method is working or implemented in general. For some grids it might be available, though.

level()

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

int Dune::Entity< 0, dim, GridImp, EntityImp >::level ( ) const

inline

The level of this entity.

operator!=()

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

template<typename ItImp >

bool Dune::Entity< 0, dim, GridImp, EntityImp >::operator!= ( const Dune::EntityPointer< GridImp, ItImp > &  other ) const

inline

Compares an Entity with an EntityPointer for equality.

Deprecated:

This method only exists for backwards compatibility during the 2.4 release cycle and will be removed after dune-grid-2.4 is released.

operator*()

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

const Entity & Dune::Entity< 0, dim, GridImp, EntityImp >::operator* ( ) const

inline

Dereference Entity to itself for backwards compatibility with EntityPointer.

Deprecated:

This method only exists to provide backwards compatibility for dune-grid-2.4. It will be removed after the release of dune-grid-2.4.

operator->()

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

const Entity * Dune::Entity< 0, dim, GridImp, EntityImp >::operator-> ( ) const

inline

Dereference Entity to itself for backwards compatibility with EntityPointer.

Deprecated:

This method only exists to provide backwards compatibility for dune-grid-2.4. It will be removed after the release of dune-grid-2.4.

operator==()

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

template<typename ItImp >

bool Dune::Entity< 0, dim, GridImp, EntityImp >::operator== ( const Dune::EntityPointer< GridImp, ItImp > &  other ) const

inline

Compares an Entity with an EntityPointer for equality.

Deprecated:

This method only exists for backwards compatibility during the 2.4 release cycle and will be removed after dune-grid-2.4 is released.

partitionType()

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

PartitionType Dune::Entity< 0, dim, GridImp, EntityImp >::partitionType ( ) const

inline

Partition type of this entity.

subEntities()

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

unsigned int Dune::Entity< 0, dim, GridImp, EntityImp >::subEntities ( unsigned int  codim ) const

inline

Number of subentities with codimension codim.

Strictly speaking this method is redundant, because the same information can be obtained from the corresponding reference element. It is here for efficiency reasons only.

subEntity()

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

template<int codim>

Codim< codim >::Entity Dune::Entity< 0, dim, GridImp, EntityImp >::subEntity ( int  i ) const

inline

Obtain a subentity.

Template Parameters

codim

codimension of the desired subentity

Parameters

[in]

i

number of the subentity (in generic numbering)

Returns

the specified subentity

Note

The subentities are numbered 0, ..., subEntities( codim )-1

---

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

• dune/grid/common/entity.hh