Dune Core Modules (2.6.0)

Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim > Class Template Reference

A geometry implementation for axis-aligned hypercubes. More...

#include <dune/geometry/axisalignedcubegeometry.hh>

Public Types

enum  
 Dimension of the cube element.
 
enum  
 Dimension of the world space that the cube element is embedded in.
 
typedef CoordType ctype
 Type used for single coordinate coefficients.
 
typedef FieldVector< ctype, dim > LocalCoordinate
 Type used for a vector of element coordinates.
 
typedef FieldVector< ctype, coorddim > GlobalCoordinate
 Type used for a vector of world coordinates.
 
typedef std::conditional< dim==coorddim, DiagonalMatrix< ctype, dim >, FieldMatrix< ctype, dim, coorddim > >::type JacobianTransposed
 Return type of jacobianTransposed. More...
 
typedef std::conditional< dim==coorddim, DiagonalMatrix< ctype, dim >, FieldMatrix< ctype, coorddim, dim > >::type JacobianInverseTransposed
 Return type of jacobianInverseTransposed. More...
 

Public Member Functions

 AxisAlignedCubeGeometry (const Dune::FieldVector< ctype, coorddim > lower, const Dune::FieldVector< ctype, coorddim > upper)
 Constructor from a lower left and an upper right corner. More...
 
 AxisAlignedCubeGeometry (const Dune::FieldVector< ctype, coorddim > lower, const Dune::FieldVector< ctype, coorddim > upper, const std::bitset< coorddim > &axes)
 Constructor from a lower left and an upper right corner. More...
 
 AxisAlignedCubeGeometry (const Dune::FieldVector< ctype, coorddim > lower)
 Constructor from a single point only. More...
 
AxisAlignedCubeGeometryoperator= (const AxisAlignedCubeGeometry &other)
 Assignment operator.
 
GeometryType type () const
 Type of the cube. Here: a hypercube of the correct dimension.
 
GlobalCoordinate global (const LocalCoordinate &local) const
 Map a point in local (element) coordinates to world coordinates.
 
LocalCoordinate local (const GlobalCoordinate &global) const
 Map a point in global (world) coordinates to element coordinates.
 
JacobianTransposed jacobianTransposed (DUNE_UNUSED const LocalCoordinate &local) const
 Jacobian transposed of the transformation from local to global coordinates.
 
JacobianInverseTransposed jacobianInverseTransposed (DUNE_UNUSED const LocalCoordinate &local) const
 Jacobian transposed of the transformation from local to global coordinates.
 
ctype integrationElement (DUNE_UNUSED const LocalCoordinate &local) const
 Return the integration element, i.e., the determinant term in the integral transformation formula.
 
GlobalCoordinate center () const
 Return center of mass of the element.
 
int corners () const
 Return the number of corners of the element.
 
GlobalCoordinate corner (int k) const
 Return world coordinates of the k-th corner of the element.
 
ctype volume () const
 Return the element volume.
 
bool affine () const
 Return if the element is affine. Here: yes.
 

Detailed Description

template<class CoordType, unsigned int dim, unsigned int coorddim>
class Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim >

A geometry implementation for axis-aligned hypercubes.

This code is much faster than a generic implementation for hexahedral elements. All methods use the fact that a geometry for axis-aligned cubes is basically just a(n affine) scaling in the coordinate directions.

If dim < coorddim then local coordinates need to be suitably mapped to global ones. AxisAlignedCubeGeometry uses a special std::bitset 'axes' for this. 'axes' has coorddim entries, of which precisely 'dim' need to be set. Each set entry marks a local coordinate, i.e., a coordinate in which the cube has extension. The cube is flat in all other directions. Its coordinates in these directions is taking from the array called 'lower', which specifies the lower left corner of the hypercube.

In the case of dim==coorddim, the code goes into overdrive. Then special code path's are taken (statically) which omit the conditionals needed to sort out the embedding of local into global coordinates. Aggressive compiler/scheduler optimization becomes possible. Additionally, the types returned by the methods jacobianTransposed and jacobianInverseTransposed are dedicated types for diagonal matrices (DiagonalMatrix).

Template Parameters
CoordTypeType used for single coordinate coefficients
dimDimension of the cube
coorddimDimension of the space that the cube lives in

Member Typedef Documentation

◆ JacobianInverseTransposed

template<class CoordType , unsigned int dim, unsigned int coorddim>
typedef std::conditional<dim==coorddim, DiagonalMatrix<ctype,dim>, FieldMatrix<ctype,coorddim,dim> >::type Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim >::JacobianInverseTransposed

Return type of jacobianInverseTransposed.

This is a fast DiagonalMatrix if dim==coorddim, and a FieldMatrix otherwise. The FieldMatrix will never contain more than one entry per column, hence it could be replaced by something more efficient.

◆ JacobianTransposed

template<class CoordType , unsigned int dim, unsigned int coorddim>
typedef std::conditional<dim==coorddim, DiagonalMatrix<ctype,dim>, FieldMatrix<ctype,dim,coorddim> >::type Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim >::JacobianTransposed

Return type of jacobianTransposed.

This is a fast DiagonalMatrix if dim==coorddim, and a FieldMatrix otherwise. The FieldMatrix will never contain more than one entry per row, hence it could be replaced by something more efficient.

Constructor & Destructor Documentation

◆ AxisAlignedCubeGeometry() [1/3]

template<class CoordType , unsigned int dim, unsigned int coorddim>
Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim >::AxisAlignedCubeGeometry ( const Dune::FieldVector< ctype, coorddim >  lower,
const Dune::FieldVector< ctype, coorddim >  upper 
)
inline

Constructor from a lower left and an upper right corner.

Note
Only for dim==coorddim

◆ AxisAlignedCubeGeometry() [2/3]

template<class CoordType , unsigned int dim, unsigned int coorddim>
Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim >::AxisAlignedCubeGeometry ( const Dune::FieldVector< ctype, coorddim >  lower,
const Dune::FieldVector< ctype, coorddim >  upper,
const std::bitset< coorddim > &  axes 
)
inline

Constructor from a lower left and an upper right corner.

Parameters
lowerCoordinates for the lower left corner.
upperCoordinates for the upper right corner.
axesEach bit set to 'true' here corresponds to a local coordinate axis. In other words, precisely 'dim' bits must be set here.

◆ AxisAlignedCubeGeometry() [3/3]

template<class CoordType , unsigned int dim, unsigned int coorddim>
Dune::AxisAlignedCubeGeometry< CoordType, dim, coorddim >::AxisAlignedCubeGeometry ( const Dune::FieldVector< ctype, coorddim >  lower)
inline

Constructor from a single point only.

Note
Only for dim==0

The documentation for this class was generated from the following file:
Creative Commons License   |  Legal Statements / Impressum  |  Hosted by TU Dresden  |  generated with Hugo v0.80.0 (Mar 28, 23:30, 2024)