dune-grid  2.4.1
Classes | Public Member Functions | Protected Member Functions | Static Protected Member Functions | List of all members
Dune::GeometryGrid< HostGrid, CoordFunction, Allocator > Class Template Reference

grid wrapper replacing the geometriesGeometryGrid wraps another DUNE grid and replaces its geometry by the generic geometries from dune-grid. These are linear (respectively n-linear) DUNE geometries interpolating some given corners. These corners are obtained by mapping the corners of the host grid's geometry (also called host geometry) by a coordinate function. More...

#include <dune/grid/geometrygrid/declaration.hh>

Classes

struct  Codim
 traits structure containing types for a codimension More...
 
struct  Partition
 Types for GridView. More...
 

Public Member Functions

const GlobalIdSetglobalIdSet () const
 
const LocalIdSetlocalIdSet () const
 
const LevelIndexSetlevelIndexSet (int level) const
 
const LeafIndexSetleafIndexSet () const
 
void globalRefine (int refCount)
 
bool mark (int refCount, const typename Codim< 0 >::Entity &entity)
 
int getMark (const typename Codim< 0 >::Entity &entity) const
 
bool preAdapt ()
 
bool adapt ()
 
void postAdapt ()
 
const CoordFunction & coordFunction () const
 
CoordFunction & coordFunction ()
 

Protected Member Functions

void * allocateStorage (std::size_t size) const
 
void deallocateStorage (void *p, std::size_t size) const
 

Static Protected Member Functions

template<int codim>
static const
HostGrid::template Codim
< codim >::Entity
getHostEntity (const typename Codim< codim >::Entity &entity)
 

Traits

typedef GridFamily::Traits Traits
 type of the grid traits More...
 

Iterator Types

typedef Traits::HierarchicIterator HierarchicIterator
 iterator over the grid hierarchy More...
 
typedef
Traits::LeafIntersectionIterator 
LeafIntersectionIterator
 iterator over intersections with other entities on the leaf level More...
 
typedef
Traits::LevelIntersectionIterator 
LevelIntersectionIterator
 iterator over intersections with other entities on the same level More...
 

Grid View Types

typedef Partition
< All_Partition >
::LevelGridView 
LevelGridView
 View types for All_Partition. More...
 
typedef Partition
< All_Partition >
::LeafGridView 
LeafGridView
 

Index and Id Set Types

typedef Traits::LeafIndexSet LeafIndexSet
 type of leaf index set More...
 
typedef Traits::LevelIndexSet LevelIndexSet
 type of level index set More...
 
typedef Traits::GlobalIdSet GlobalIdSet
 type of global id set More...
 
typedef Traits::LocalIdSet LocalIdSet
 type of local id set More...
 

Miscellaneous Types

typedef Traits::ctype ctype
 type of vector coordinates (e.g., double) More...
 
typedef
Traits::CollectiveCommunication 
CollectiveCommunication
 communicator with all other processes having some part of the grid More...
 

Construction and Destruction

 GeometryGrid (HostGrid &hostGrid, CoordFunction &coordFunction, const Allocator &allocator=Allocator())
 constructor More...
 
 GeometryGrid (HostGrid *hostGrid, CoordFunction *coordFunction, const Allocator &allocator=Allocator())
 constructor More...
 
 ~GeometryGrid ()
 destructor More...
 

Size Methods

int maxLevel () const
 obtain maximal grid level More...
 
int size (int level, int codim) const
 obtain number of entites on a level More...
 
int size (int codim) const
 obtain number of leaf entities More...
 
int size (int level, GeometryType type) const
 obtain number of entites on a level More...
 
int size (GeometryType type) const
 obtain number of leaf entities More...
 
size_t numBoundarySegments () const
 returns the number of boundary segments within the macro grid More...
 

Parallel Data Distribution and Communication Methods

int overlapSize (int codim) const
 obtain size of overlap region for the leaf grid More...
 
int ghostSize (int codim) const
 obtain size of ghost region for the leaf grid More...
 
int overlapSize (int level, int codim) const
 obtain size of overlap region for a grid level More...
 
int ghostSize (int level, int codim) const
 obtain size of ghost region for a grid level More...
 
template<class DataHandle , class Data >
void communicate (CommDataHandleIF< DataHandle, Data > &dataHandle, InterfaceType interface, CommunicationDirection direction, int level) const
 communicate information on a grid level More...
 
template<class DataHandle , class Data >
void communicate (CommDataHandleIF< DataHandle, Data > &dataHandle, InterfaceType interface, CommunicationDirection direction) const
 communicate information on leaf entities More...
 
const CollectiveCommunicationcomm () const
 obtain CollectiveCommunication object More...
 
template<class EntitySeed >
Traits::template Codim
< EntitySeed::codimension >
::EntityPointer 
entityPointer (const EntitySeed &seed) const
 obtain EntityPointer from EntitySeed. More...
 
template<class EntitySeed >
Traits::template Codim
< EntitySeed::codimension >
::Entity 
entity (const EntitySeed &seed) const
 obtain Entity from EntitySeed. More...
 

Grid Views

template<PartitionIteratorType pitype>
Partition< pitype >::LevelGridView levelGridView (int level) const
 View for a grid level. More...
 
template<PartitionIteratorType pitype>
Partition< pitype >::LeafGridView leafGridView () const
 View for the leaf grid. More...
 
LevelGridView levelGridView (int level) const
 View for a grid level for All_Partition. More...
 
LeafGridView leafGridView () const
 View for the leaf grid for All_Partition. More...
 

Miscellaneous Methods

const HostGrid & hostGrid () const
 
HostGrid & hostGrid ()
 
void update ()
 update grid caches More...
 

Detailed Description

template<class HostGrid, class CoordFunction, class Allocator>
class Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >

grid wrapper replacing the geometries

GeometryGrid wraps another DUNE grid and replaces its geometry by the generic geometries from dune-grid. These are linear (respectively n-linear) DUNE geometries interpolating some given corners. These corners are obtained by mapping the corners of the host grid's geometry (also called host geometry) by a coordinate function.

An example of a coordinate function is given by the following code:

class ExampleFunction
: public Dune :: AnalyticalCoordFunction< double, 2, 3, ExampleFunction >
{
typedef ExampleFunction This;
public:
typedef Base :: DomainVector DomainVector;
typedef Base :: RangeVector RangeVector;
void evaluate ( const DomainVector &x, RangeVector &y ) const
{
y[ 0 ] = x[ 0 ];
y[ 1 ] = x[ 1 ];
y[ 2 ] = x[ 0 ] + x[ 1 ];
}
};
Note
A dune-fem Function can be used as a coordinate function. The evaluation of discrete functions would be very expensive, though.
Template Parameters
HostGridDUNE grid to be wrapped (called host grid)
CoordFunctioncoordinate function

Member Typedef Documentation

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::CollectiveCommunication Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::CollectiveCommunication

communicator with all other processes having some part of the grid

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::ctype Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::ctype

type of vector coordinates (e.g., double)

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::GlobalIdSet Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::GlobalIdSet

type of global id set

The id set assigns a unique identifier to each entity within the grid. This identifier is unique over all processes sharing this grid.

Note
Id's are neither consecutive nor necessarily of an integral type.

The global id set is a model of Dune::IdSet.

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::HierarchicIterator Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::HierarchicIterator

iterator over the grid hierarchy

template<class HostGrid , class CoordFunction , class Allocator >
typedef Partition< All_Partition >::LeafGridView Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LeafGridView
template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::LeafIndexSet Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LeafIndexSet

type of leaf index set

The index set assigns consecutive indices to the entities of the leaf grid. The indices are of integral type and can be used to access arrays.

The leaf index set is a model of Dune::IndexSet.

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::LeafIntersectionIterator Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LeafIntersectionIterator

iterator over intersections with other entities on the leaf level

template<class HostGrid , class CoordFunction , class Allocator >
typedef Partition< All_Partition >::LevelGridView Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LevelGridView

View types for All_Partition.

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::LevelIndexSet Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LevelIndexSet

type of level index set

The index set assigns consecutive indices to the entities of a grid level. The indices are of integral type and can be used to access arrays.

The level index set is a model of Dune::IndexSet.

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::LevelIntersectionIterator Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LevelIntersectionIterator

iterator over intersections with other entities on the same level

template<class HostGrid , class CoordFunction , class Allocator >
typedef Traits::LocalIdSet Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::LocalIdSet

type of local id set

The id set assigns a unique identifier to each entity within the grid. This identifier needs only to be unique over this process.

Though the local id set may be identical to the global id set, it is often implemented more efficiently.

Note
Ids are neither consecutive nor necessarily of an integral type.
Local ids need not be compatible with global ids. Also, no mapping from local ids to global ones needs to exist.

The global id set is a model of Dune::IdSet.

template<class HostGrid , class CoordFunction , class Allocator >
typedef GridFamily::Traits Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::Traits

type of the grid traits

Constructor & Destructor Documentation

template<class HostGrid , class CoordFunction , class Allocator >
Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::GeometryGrid ( HostGrid &  hostGrid,
CoordFunction &  coordFunction,
const Allocator &  allocator = Allocator() 
)
inline

constructor

The references to host grid and coordinate function are stored in the grid. Therefore, they must remain valid until the grid is destroyed.

Parameters
[in]hostGridreference to the grid to wrap
[in]coordFunctionreference to the coordinate function
[in]allocatorstorage allocator
template<class HostGrid , class CoordFunction , class Allocator >
Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::GeometryGrid ( HostGrid *  hostGrid,
CoordFunction *  coordFunction,
const Allocator &  allocator = Allocator() 
)
inline

constructor

The grid takes ownership of the pointers to host grid and coordinate function. They will be deleted when the grid is destroyed.

Parameters
[in]hostGridpointer to the grid to wrap
[in]coordFunctionpointer to the coordinate function
[in]allocatorstorage allocator
template<class HostGrid , class CoordFunction , class Allocator >
Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::~GeometryGrid ( )
inline

destructor

Member Function Documentation

template<class HostGrid , class CoordFunction , class Allocator >
bool Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::adapt ( )
inline
template<class HostGrid , class CoordFunction , class Allocator >
void* Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::allocateStorage ( std::size_t  size) const
inlineprotected
template<class HostGrid , class CoordFunction , class Allocator >
const CollectiveCommunication& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::comm ( ) const
inline

obtain CollectiveCommunication object

The CollectiveCommunication object should be used to globally communicate information between all processes sharing this grid.

Note
The CollectiveCommunication object returned is identical to the one returned by the host grid.

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::hostGrid().

template<class HostGrid , class CoordFunction , class Allocator >
template<class DataHandle , class Data >
void Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::communicate ( CommDataHandleIF< DataHandle, Data > &  dataHandle,
InterfaceType  interface,
CommunicationDirection  direction,
int  level 
) const
inline

communicate information on a grid level

Parameters
dataHandlecommunication data handle (user defined)
[in]interfacecommunication interface (one of InteriorBorder_InteriorBorder_Interface, InteriorBorder_All_Interface, Overlap_OverlapFront_Interface, Overlap_All_Interface, All_All_Interface)
[in]directioncommunication direction (one of ForwardCommunication or BackwardCommunication)
[in]levelgrid level to communicate

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView().

template<class HostGrid , class CoordFunction , class Allocator >
template<class DataHandle , class Data >
void Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::communicate ( CommDataHandleIF< DataHandle, Data > &  dataHandle,
InterfaceType  interface,
CommunicationDirection  direction 
) const
inline

communicate information on leaf entities

Parameters
dataHandlecommunication data handle (user defined)
[in]interfacecommunication interface (one of InteriorBorder_InteriorBorder_Interface, InteriorBorder_All_Interface, Overlap_OverlapFront_Interface, Overlap_All_Interface, All_All_Interface)
[in]directioncommunication direction (one of ForwardCommunication, BackwardCommunication)

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView().

template<class HostGrid , class CoordFunction , class Allocator >
const CoordFunction& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::coordFunction ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
CoordFunction& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::coordFunction ( )
inline
template<class HostGrid , class CoordFunction , class Allocator >
void Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::deallocateStorage ( void *  p,
std::size_t  size 
) const
inlineprotected
template<class HostGrid , class CoordFunction , class Allocator >
template<class EntitySeed >
Traits::template Codim< EntitySeed::codimension >::Entity Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::entity ( const EntitySeed seed) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
template<class EntitySeed >
Traits::template Codim< EntitySeed::codimension >::EntityPointer Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::entityPointer ( const EntitySeed seed) const
inline

obtain EntityPointer from EntitySeed.

Deprecated:
"entityPointer() is deprecated and will be removed after the release of dune-grid 2.4. Use entity() instead to directly obtain an Entity object."

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::entity().

template<class HostGrid , class CoordFunction , class Allocator >
template<int codim>
static const HostGrid::template Codim< codim >::Entity& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::getHostEntity ( const typename Codim< codim >::Entity entity)
inlinestaticprotected
template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::getMark ( const typename Codim< 0 >::Entity entity) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::ghostSize ( int  codim) const
inline

obtain size of ghost region for the leaf grid

Parameters
[in]codimcodimension for with the information is desired

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView().

template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::ghostSize ( int  level,
int  codim 
) const
inline

obtain size of ghost region for a grid level

Parameters
[in]levelgrid level (0, ..., maxLevel())
[in]codimcodimension (0, ..., dimension)

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView().

template<class HostGrid , class CoordFunction , class Allocator >
const GlobalIdSet& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::globalIdSet ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
void Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::globalRefine ( int  refCount)
inline
template<class HostGrid , class CoordFunction , class Allocator >
const HostGrid& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::hostGrid ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
HostGrid& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::hostGrid ( )
inline
template<class HostGrid , class CoordFunction , class Allocator >
template<PartitionIteratorType pitype>
Partition< pitype >::LeafGridView Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
LeafGridView Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
const LeafIndexSet& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafIndexSet ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
template<PartitionIteratorType pitype>
Partition< pitype >::LevelGridView Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView ( int  level) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
LevelGridView Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView ( int  level) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
const LevelIndexSet& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelIndexSet ( int  level) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
const LocalIdSet& Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::localIdSet ( ) const
inline
template<class HostGrid , class CoordFunction , class Allocator >
bool Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::mark ( int  refCount,
const typename Codim< 0 >::Entity entity 
)
inline
template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::maxLevel ( ) const
inline

obtain maximal grid level

Grid levels are numbered 0, ..., L, where L is the value returned by this method.

Returns
maximal grid level

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::hostGrid().

Referenced by Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelIndexSet(), and Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::update().

template<class HostGrid , class CoordFunction , class Allocator >
size_t Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::numBoundarySegments ( ) const
inline

returns the number of boundary segments within the macro grid

Returns
number of boundary segments within the macro grid

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::hostGrid().

template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::overlapSize ( int  codim) const
inline

obtain size of overlap region for the leaf grid

Parameters
[in]codimcodimension for with the information is desired

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView().

template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::overlapSize ( int  level,
int  codim 
) const
inline

obtain size of overlap region for a grid level

Parameters
[in]levelgrid level (0, ..., maxLevel())
[in]codimcodimension (0, ..., dimension)

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView().

template<class HostGrid , class CoordFunction , class Allocator >
void Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::postAdapt ( )
inline
template<class HostGrid , class CoordFunction , class Allocator >
bool Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::preAdapt ( )
inline
template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::size ( int  level,
int  codim 
) const
inline

obtain number of entites on a level

Parameters
[in]levellevel to consider
[in]codimcodimension to consider
Returns
number of entities of codimension codim on grid level level.

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView().

template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::size ( int  codim) const
inline

obtain number of leaf entities

Parameters
[in]codimcodimension to consider
Returns
number of leaf entities of codimension codim

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView().

template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::size ( int  level,
GeometryType  type 
) const
inline

obtain number of entites on a level

Parameters
[in]levellevel to consider
[in]typegeometry type to consider
Returns
number of entities with a geometry of type type on grid level level.

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::levelGridView().

template<class HostGrid , class CoordFunction , class Allocator >
int Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::size ( GeometryType  type) const
inline

obtain number of leaf entities

Returns
number of leaf entities with a geometry of type type

References Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::leafGridView().

template<class HostGrid , class CoordFunction , class Allocator >
void Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::update ( )
inline

update grid caches

This method has to be called whenever the underlying host grid changes.

Note
If you adapt the host grid through this geometry grid's adaptation or load balancing methods, update is automatically called.

References Dune::GeoGrid::AdaptCoordFunction< CoordFunctionInterface >::adapt(), and Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::maxLevel().

Referenced by Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::adapt(), and Dune::GeometryGrid< HostGrid, CoordFunction, Allocator >::globalRefine().


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