Reference documentation for deal.II version GIT 3801df8983 20220522 23:30:02+00:00

Classes  
class  Mapping< dim, spacedim > 
Abstract base class for mapping classes. More...  
Enumerations  
enum  MappingKind { mapping_none = 0x0000 , mapping_covariant = 0x0001 , mapping_contravariant = 0x0002 , mapping_covariant_gradient = 0x0003 , mapping_contravariant_gradient = 0x0004 , mapping_piola = 0x0100 , mapping_piola_gradient = 0x0101 , mapping_nedelec = 0x0200 , mapping_raviart_thomas = 0x0300 , mapping_bdm = mapping_raviart_thomas , mapping_covariant_hessian , mapping_contravariant_hessian , mapping_piola_hessian } 
The classes in this module are used to map from unit coordinates to the coordinates of a cell in real cell. Most commonly, one uses the MappingQ1 class that provides a Q1 (bi/trilinear) mapping (i.e. a mapping that is isoparametric for the usual Q1 elements). However, there are other classes that implement higherorder mappings as well to provide for curvilinear elements. These are discussed in the step11 and step12 tutorial programs.
The MappingQ1Eulerian class is an extension to the MappingQ1 class in that it accepts a vector that describes a displacement field for each position of the domain. This is used in Eulerian computations without the need to actually move vertices after each time step.
In addition, the MappingC1 class provides for a boundary of the computational domain that is not only curved, but also has a continuous derivative at the interface between two cells on the boundary.
Finally, the MappingCartesian class is an optimization for elements that are brickshaped and with edges parallel to the coordinate axes.
In the grand scheme of things, the pieces of this module interact with a variety of other parts of the library:
enum MappingKind 
The transformation kind used for the Mapping::transform() functions.
Special finite elements may need special Mapping from the reference cell to the actual mesh cell. In order to be most flexible, this enum provides an extensible interface for arbitrary transformations. Nevertheless, these must be implemented in the transform() functions of inheriting classes in order to work.
Enumerator  

mapping_none  No mapping, i.e., shape functions are not mapped from a reference cell but instead are defined right on the realspace cell. 
mapping_covariant  Covariant mapping (see Mapping::transform() for details). 
mapping_contravariant  Contravariant mapping (see Mapping::transform() for details). 
mapping_covariant_gradient  Mapping of the gradient of a covariant vector field (see Mapping::transform() for details). 
mapping_contravariant_gradient  Mapping of the gradient of a contravariant vector field (see Mapping::transform() for details). 
mapping_piola  The Piola transform usually used for Hdiv elements. Piola transform is the standard transformation of vector valued elements in H^{div}. It amounts to a contravariant transformation scaled by the inverse of the volume element. 
mapping_piola_gradient  Transformation for the gradient of a vector field corresponding to a mapping_piola transformation (see Mapping::transform() for details). 
mapping_nedelec  The mapping used for Nedelec elements. Curlconforming elements are mapped as covariant vectors. Nevertheless, we introduce a separate mapping kind, such that we can use the same flag for the vector and its gradient (see Mapping::transform() for details). 
mapping_raviart_thomas  The mapping used for RaviartThomas elements. 
mapping_bdm  The mapping used for BDM elements. 
mapping_covariant_hessian  The mappings for 2forms and third order tensors. These are mappings typpically applied to hessians transformed to the reference cell. Mapping of the hessian of a covariant vector field (see Mapping::transform() for details). 
mapping_contravariant_hessian  Mapping of the hessian of a contravariant vector field (see Mapping::transform() for details). 
mapping_piola_hessian  Mapping of the hessian of a piola vector field (see Mapping::transform() for details). 