Dune Core Modules (2.10.0)
Provide a generic factory class for unstructured grids. More...
#include <dune/grid/common/gridfactory.hh>
Public Member Functions | |
GridFactory () | |
Default constructor. | |
virtual void | insertVertex (const FieldVector< ctype, dimworld > &pos) |
Insert a vertex into the coarse grid. | |
virtual void | insertElement (const GeometryType &type, const std::vector< unsigned int > &vertices) |
Insert an element into the coarse grid. More... | |
virtual void | insertBoundarySegment (const std::vector< unsigned int > &vertices) |
insert a boundary segment More... | |
virtual std::unique_ptr< GridType > | createGrid () |
Finalize grid creation and hand over the grid. More... | |
virtual void | insertBoundarySegment (const std::vector< unsigned int > &vertices)=0 |
insert a boundary segment More... | |
virtual void | insertBoundarySegment (const std::vector< unsigned int > &vertices, const std::shared_ptr< BoundarySegment< dimension, dimworld > > &boundarySegment) |
insert an arbitrarily shaped boundary segment More... | |
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. More... | |
virtual unsigned int | insertionIndex (const typename Codim< 0 >::Entity &entity) const |
obtain an element's insertion index More... | |
virtual unsigned int | insertionIndex (const typename Codim< dimension >::Entity &entity) const |
obtain a vertex' insertion index More... | |
virtual unsigned int | insertionIndex (const typename GridType::LeafIntersection &intersection) const |
obtain a boundary's insertion index More... | |
virtual bool | wasInserted (const typename GridType::LeafIntersection &intersection) const |
determine whether an intersection was inserted More... | |
Communication | comm () const |
Return the Communication used by the grid factory. More... | |
Static Protected Attributes | |
static const int | dimension = GridType::dimension |
dimension of the grid | |
Detailed Description
class Dune::GridFactory< GridType >
Provide a generic factory class for unstructured grids.
This is the unspecialized class, which does nothing. All work is done in the specializations for the different grid types.
See GridFactoryInterface for an example how to use this class.
Member Function Documentation
◆ comm()
|
inlineinherited |
Return the Communication used by the grid factory.
Defaults to the Communication induced by the process-local communicator.
References Dune::MPIHelper::getLocalCommunicator().
Referenced by Dune::StructuredGridFactory< GridType >::createCubeGrid(), Dune::StructuredGridFactory< AlbertaGrid< dim, dimworld > >::createSimplexGrid(), and Dune::StructuredGridFactory< GridType >::createSimplexGrid().
◆ createGrid()
|
inlinevirtual |
Finalize grid creation and hand over the grid.
The receiver takes responsibility of the memory allocated for the grid
Implements Dune::GridFactoryInterface< GridType >.
References DUNE_THROW.
Referenced by Dune::StructuredGridFactory< GridType >::createCubeGrid(), Dune::StructuredGridFactory< AlbertaGrid< dim, dimworld > >::createSimplexGrid(), Dune::StructuredGridFactory< GridType >::createSimplexGrid(), Dune::StarCDReader< GridType >::read(), and Dune::GmshReader< GridType >::read().
◆ insertBoundarySegment() [1/3]
|
inlinevirtual |
insert a boundary segment
This method inserts a boundary segment into the coarse grid. Using this method has two advantages over not using it:
- The boundary segment gets an insertion index.
- The grid factory can verify that this is actually a boundary segment
- Note
- You are not forced to insert all boundary segments. The grid factory will find the remaining boundary segments itself.
- Parameters
-
[in] vertices the indices of the vertices of the segment
Implements Dune::GridFactoryInterface< GridType >.
References DUNE_THROW.
Referenced by Dune::GmshReaderParser< GridType >::pass2HandleElement().
◆ insertBoundarySegment() [2/3]
|
virtual |
insert a boundary segment
This method inserts a boundary segment into the coarse grid. Using this method has two advantages over not using it:
- The boundary segment gets an insertion index.
- The grid factory can verify that this is actually a boundary segment
- Note
- You are not forced to insert all boundary segments. The grid factory will find the remaining boundary segments itself.
- Parameters
-
[in] vertices the indices of the vertices of the segment
Implements Dune::GridFactoryInterface< GridType >.
◆ insertBoundarySegment() [3/3]
|
inlinevirtual |
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
Reimplemented from Dune::GridFactoryInterface< GridType >.
◆ insertElement() [1/2]
|
inlinevirtual |
Insert an element into the coarse grid.
- Parameters
-
type The GeometryType of the new element vertices The vertices of the new element, using the DUNE numbering
Make sure the inserted element is not inverted (this holds even for simplices). There are grids that can't handle inverted tets.
Implements Dune::GridFactoryInterface< GridType >.
References DUNE_THROW.
Referenced by Dune::StructuredGridFactory< GridType >::createCubeGrid(), Dune::StructuredGridFactory< GridType >::createSimplexGrid(), Dune::GmshReaderParser< GridType >::pass2HandleElement(), and Dune::StarCDReader< GridType >::read().
◆ insertElement() [2/2]
|
inlinevirtualinherited |
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.
References DUNE_THROW.
◆ insertionIndex() [1/3]
|
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
Reimplemented in Dune::GridFactory< AlbertaGrid< dim, dimworld > >, and Dune::GridFactory< UGGrid< dimworld > >.
References DUNE_THROW.
Referenced by Dune::GridFactory< AlbertaGrid< dim, dimworld > >::insertionIndex(), and Dune::GridFactory< UGGrid< dimworld > >::wasInserted().
◆ insertionIndex() [2/3]
|
inlinevirtualinherited |
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
Reimplemented in Dune::GridFactory< AlbertaGrid< dim, dimworld > >, and Dune::GridFactory< UGGrid< dimworld > >.
References DUNE_THROW.
◆ insertionIndex() [3/3]
|
inlinevirtualinherited |
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).
References DUNE_THROW.
◆ wasInserted()
|
inlinevirtualinherited |
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
References DUNE_THROW.
The documentation for this class was generated from the following file:
- dune/grid/common/gridfactory.hh