Collection of finite elements from the same family in multiple dimensions. This class is used to match the degrees of freedom of a FiniteElementSpace between elements, and to provide the finite element restriction from an element to its boundary. More...

#include <fe_coll.hpp>

Inheritance diagram for mfem::FiniteElementCollection:

[legend]

Collaboration diagram for mfem::FiniteElementCollection:

[legend]

Public Types
enum	{ CONTINUOUS, TANGENTIAL, NORMAL, DISCONTINUOUS }
	Enumeration for ContType: defines the continuity of the field across element interfaces. More...

Public Member Functions
virtual const FiniteElement *	FiniteElementForGeometry (Geometry::Type GeomType) const =0

virtual int	DofForGeometry (Geometry::Type GeomType) const =0

virtual const int *	DofOrderForOrientation (Geometry::Type GeomType, int Or) const =0
	Returns an array, say p, that maps a local permuted index i to a local base index: base_i = p[i]. More...

virtual const char *	Name () const

virtual int	GetContType () const =0

int	HasFaceDofs (Geometry::Type geom, int p) const

virtual const FiniteElement *	TraceFiniteElementForGeometry (Geometry::Type GeomType) const

virtual FiniteElementCollection *	GetTraceCollection () const

virtual	~FiniteElementCollection ()

void	SubDofOrder (Geometry::Type Geom, int SDim, int Info, Array< int > &dofs) const
	Get the local dofs for a given sub-manifold. More...

const FiniteElement *	GetFE (Geometry::Type geom, int p) const
	Variable order version of FiniteElementForGeometry(). More...

int	GetNumDof (Geometry::Type geom, int p) const
	Variable order version of DofForGeometry(). More...

const int *	GetDofOrdering (Geometry::Type geom, int p, int ori) const
	Variable order version of DofOrderForOrientation(). More...

int	GetOrder () const
	Return the order (polynomial degree) of the FE collection, corresponding to the order/degree returned by FiniteElement::GetOrder() of the highest-dimensional FiniteElements defined by the collection. More...

virtual FiniteElementCollection *	Clone (int p) const
	Instantiate a new collection of the same type with a different order. More...

Static Public Member Functions
static FiniteElementCollection *	New (const char *name)
	Factory method: return a newly allocated FiniteElementCollection according to the given name. More...

Protected Member Functions
	FiniteElementCollection ()

	FiniteElementCollection (int p)

void	InitVarOrder (int p) const

Static Protected Member Functions
template<Geometry::Type geom>
static void	GetNVE (int &nv, int &ne)

template<Geometry::Type geom, typename v_t >
static void	GetEdge (int &nv, v_t &v, int &ne, int &e, int &eo, const int edge_info)

template<Geometry::Type geom, Geometry::Type f_geom, typename v_t , typename e_t , typename eo_t >
static void	GetFace (int &nv, v_t &v, int &ne, e_t &e, eo_t &eo, int &nf, int &f, Geometry::Type &fg, int &fo, const int face_info)

Protected Attributes
const int	base_p
	Order as returned by GetOrder(). More...

Array< FiniteElementCollection * >	var_orders

Detailed Description

Collection of finite elements from the same family in multiple dimensions. This class is used to match the degrees of freedom of a FiniteElementSpace between elements, and to provide the finite element restriction from an element to its boundary.

Definition at line 26 of file fe_coll.hpp.

Member Enumeration Documentation

anonymous enum

Enumeration for ContType: defines the continuity of the field across element interfaces.

Enumerator
CONTINUOUS	Field is continuous across element interfaces.
TANGENTIAL	Tangential components of vector field.
NORMAL	Normal component of vector field.
DISCONTINUOUS	Field is discontinuous across element interfaces.

Definition at line 45 of file fe_coll.hpp.

Constructor & Destructor Documentation

mfem::FiniteElementCollection::~FiniteElementCollection ( )

virtual

Definition at line 313 of file fe_coll.cpp.

mfem::FiniteElementCollection::FiniteElementCollection ( )

inlineprotected

Definition at line 207 of file fe_coll.hpp.

mfem::FiniteElementCollection::FiniteElementCollection ( int p )

inlineprotected

Definition at line 208 of file fe_coll.hpp.

Member Function Documentation

FiniteElementCollection * mfem::FiniteElementCollection::Clone ( int p ) const

virtual

Instantiate a new collection of the same type with a different order.

Generally, the order parameter p is NOT the same as the parameter p used by some of the constructors of derived classes. Instead, this p represents the order of the new FE collection as it will be returned by its GetOrder() method.

Reimplemented in mfem::ND_FECollection, mfem::RT_FECollection, mfem::L2_FECollection, and mfem::H1_FECollection.

Definition at line 296 of file fe_coll.cpp.

virtual int mfem::FiniteElementCollection::DofForGeometry ( Geometry::Type GeomType ) const

pure virtual

virtual const int* mfem::FiniteElementCollection::DofOrderForOrientation	(	Geometry::Type	GeomType,
		int	Or
	)		const

pure virtual

Returns an array, say p, that maps a local permuted index i to a local base index: base_i = p[i].

virtual const FiniteElement* mfem::FiniteElementCollection::FiniteElementForGeometry ( Geometry::Type GeomType ) const

pure virtual

virtual int mfem::FiniteElementCollection::GetContType ( ) const

pure virtual

const int* mfem::FiniteElementCollection::GetDofOrdering	(	Geometry::Type	geom,
		int	p,
		int	ori
	)		const

inline

Variable order version of DofOrderForOrientation().

The order parameter p represents the order of the highest-dimensional FiniteElements the fixed-order collection we want to query. In general, this order is different from the order of the element corresponding to geom in that fixed-order collection.

Definition at line 185 of file fe_coll.hpp.

template<Geometry::Type geom, typename v_t >

void mfem::FiniteElementCollection::GetEdge	(	int &	nv,
		v_t &	v,
		int &	ne,
		int &	e,
		int &	eo,
		const int	edge_info
	)

inlinestaticprotected

Definition at line 332 of file fe_coll.cpp.

template<Geometry::Type geom, Geometry::Type f_geom, typename v_t , typename e_t , typename eo_t >

void mfem::FiniteElementCollection::GetFace	(	int &	nv,
		v_t &	v,
		int &	ne,
		e_t &	e,
		eo_t &	eo,
		int &	nf,
		int &	f,
		Geometry::Type &	fg,
		int &	fo,
		const int	face_info
	)

inlinestaticprotected

Definition at line 352 of file fe_coll.cpp.

const FiniteElement* mfem::FiniteElementCollection::GetFE	(	Geometry::Type	geom,
		int	p
	)		const

inline

Variable order version of FiniteElementForGeometry().

The order parameter p represents the order of the highest-dimensional FiniteElements the fixed-order collection we want to query. In general, this order is different from the order of the returned FiniteElement.

Definition at line 161 of file fe_coll.hpp.

int mfem::FiniteElementCollection::GetNumDof	(	Geometry::Type	geom,
		int	p
	)		const

inline

Variable order version of DofForGeometry().

The order parameter p represents the order of the highest-dimensional FiniteElements the fixed-order collection we want to query. In general, this order is different from the order of the element corresponding to geom in that fixed-order collection.

Definition at line 173 of file fe_coll.hpp.

template<Geometry::Type geom>

void mfem::FiniteElementCollection::GetNVE	(	int &	nv,
		int &	ne
	)

inlinestaticprotected

Definition at line 322 of file fe_coll.cpp.

int mfem::FiniteElementCollection::GetOrder ( ) const

inline

Return the order (polynomial degree) of the FE collection, corresponding to the order/degree returned by FiniteElement::GetOrder() of the highest-dimensional FiniteElements defined by the collection.

Definition at line 195 of file fe_coll.hpp.

FiniteElementCollection * mfem::FiniteElementCollection::GetTraceCollection ( ) const

virtual

Reimplemented in mfem::NURBSFECollection, mfem::RT_R2D_FECollection, mfem::ND_R2D_FECollection, mfem::RT_R1D_FECollection, mfem::ND_R1D_FECollection, mfem::ND_FECollection, mfem::RT_FECollection, and mfem::H1_FECollection.

Definition at line 45 of file fe_coll.cpp.

int mfem::FiniteElementCollection::HasFaceDofs	(	Geometry::Type	geom,
		int	p
	)		const

Definition at line 25 of file fe_coll.cpp.

void mfem::FiniteElementCollection::InitVarOrder ( int p ) const

protected

Definition at line 304 of file fe_coll.cpp.

virtual const char* mfem::FiniteElementCollection::Name ( ) const

inlinevirtual

Definition at line 61 of file fe_coll.hpp.

FiniteElementCollection * mfem::FiniteElementCollection::New ( const char * name )

static

Factory method: return a newly allocated FiniteElementCollection according to the given name.

FEC Name	Space	Order	BasisType	FiniteElement::MapT	Notes
H1_[DIM]_[ORDER]	H1	*	1	VALUE	H1 nodal elements
H1@[BTYPE]_[DIM]_[ORDER]	H1	*	*	VALUE	H1 nodal elements
H1Pos_[DIM]_[ORDER]	H1	*	1	VALUE	H1 nodal elements
H1Pos_Trace_[DIM]_[ORDER]	H^{1/2}	*	2	VALUE	H^{1/2}-conforming trace elements for H1 defined on the interface between mesh elements (faces,edges,vertices)
H1_Trace_[DIM]_[ORDER]	H^{1/2}	*	1	VALUE	H^{1/2}-conforming trace elements for H1 defined on the interface between mesh elements (faces,edges,vertices)
H1_Trace@[BTYPE]_[DIM]_[ORDER]	H^{1/2}	*	1	VALUE	H^{1/2}-conforming trace elements for H1 defined on the interface between mesh elements (faces,edges,vertices)
ND_[DIM]_[ORDER]	H(curl)	*	1 / 0	H_CURL	Nedelec vector elements
ND@[CBTYPE][OBTYPE]_[DIM]_[ORDER]	H(curl)	*	* / *	H_CURL	Nedelec vector elements
ND_Trace_[DIM]_[ORDER]	H^{1/2}	*	1 / 0	H_CURL	H^{1/2}-conforming trace elements for H(curl) defined on the interface between mesh elements (faces)
ND_Trace@[CBTYPE][OBTYPE]_[DIM]_[ORDER]	H^{1/2}	*	1 / 0	H_CURL	H^{1/2}-conforming trace elements for H(curl) defined on the interface between mesh elements (faces)
RT_[DIM]_[ORDER]	H(div)	*	1 / 0	H_DIV	Raviart-Thomas vector elements
RT@[CBTYPE][OBTYPE]_[DIM]_[ORDER]	H(div)	*	* / *	H_DIV	Raviart-Thomas vector elements
RT_Trace_[DIM]_[ORDER]	H^{1/2}	*	1 / 0	INTEGRAL	H^{1/2}-conforming trace elements for H(div) defined on the interface between mesh elements (faces)
RT_ValTrace_[DIM]_[ORDER]	H^{1/2}	*	1 / 0	VALUE	H^{1/2}-conforming trace elements for H(div) defined on the interface between mesh elements (faces)
RT_Trace@[BTYPE]_[DIM]_[ORDER]	H^{1/2}	*	1 / 0	INTEGRAL	H^{1/2}-conforming trace elements for H(div) defined on the interface between mesh elements (faces)
RT_ValTrace@[BTYPE]_[DIM]_[ORDER]	H^{1/2}	*	1 / 0	VALUE	H^{1/2}-conforming trace elements for H(div) defined on the interface between mesh elements (faces)
L2_[DIM]_[ORDER]	L2	*	0	VALUE	Discontinous L2 elements
L2_T[BTYPE]_[DIM]_[ORDER]	L2	*	0	VALUE	Discontinous L2 elements
L2Int_[DIM]_[ORDER]	L2	*	0	INTEGRAL	Discontinous L2 elements
L2Int_T[BTYPE]_[DIM]_[ORDER]	L2	*	0	INTEGRAL	Discontinous L2 elements
DG_Iface_[DIM]_[ORDER]	-	*	0	VALUE	Discontinuous elements on the interface between mesh elements (faces)
DG_Iface@[BTYPE]_[DIM]_[ORDER]	-	*	0	VALUE	Discontinuous elements on the interface between mesh elements (faces)
DG_IntIface_[DIM]_[ORDER]	-	*	0	INTEGRAL	Discontinuous elements on the interface between mesh elements (faces)
DG_IntIface@[BTYPE]_[DIM]_[ORDER]	-	*	0	INTEGRAL	Discontinuous elements on the interface between mesh elements (faces)
NURBS[ORDER]	-	*	-	VALUE	Non-Uniform Rational B-Splines (NURBS) elements
LinearNonConf3D	-	1	1	VALUE	Piecewise-linear nonconforming finite elements in 3D
CrouzeixRaviart	-	-	-	-	Crouzeix-Raviart nonconforming elements in 2D
Local_[FENAME]	-	-	-	-	Special collection that builds a local version out of the FENAME collection
-	-	-	-	-	-
Linear	H1	1	1	VALUE	Left in for backward compatibility, consider using H1_
Quadratic	H1	2	1	VALUE	Left in for backward compatibility, consider using H1_
QuadraticPos	H1	2	2	VALUE	Left in for backward compatibility, consider using H1_
Cubic	H1	2	1	VALUE	Left in for backward compatibility, consider using H1_
Const2D	L2	0	1	VALUE	Left in for backward compatibility, consider using L2_
Const3D	L2	0	1	VALUE	Left in for backward compatibility, consider using L2_
LinearDiscont2D	L2	1	1	VALUE	Left in for backward compatibility, consider using L2_
GaussLinearDiscont2D	L2	1	0	VALUE	Left in for backward compatibility, consider using L2_
P1OnQuad	H1	1	1	VALUE	Linear P1 element with 3 nodes on a square
QuadraticDiscont2D	L2	2	1	VALUE	Left in for backward compatibility, consider using L2_
QuadraticPosDiscont2D	L2	2	2	VALUE	Left in for backward compatibility, consider using L2_
GaussQuadraticDiscont2D	L2	2	0	VALUE	Left in for backward compatibility, consider using L2_
CubicDiscont2D	L2	3	1	VALUE	Left in for backward compatibility, consider using L2_
LinearDiscont3D	L2	1	1	VALUE	Left in for backward compatibility, consider using L2_
QuadraticDiscont3D	L2	2	1	VALUE	Left in for backward compatibility, consider using L2_
ND1_3D	H(Curl)	1	1 / 0	H_CURL	Left in for backward compatibility, consider using ND_
RT0_2D	H(Div)	1	1 / 0	H_DIV	Left in for backward compatibility, consider using RT_
RT1_2D	H(Div)	2	1 / 0	H_DIV	Left in for backward compatibility, consider using RT_
RT2_2D	H(Div)	3	1 / 0	H_DIV	Left in for backward compatibility, consider using RT_
RT0_3D	H(Div)	1	1 / 0	H_DIV	Left in for backward compatibility, consider using RT_
RT1_3D	H(Div)	2	1 / 0	H_DIV	Left in for backward compatibility, consider using RT_

Tag	Description
[DIM]	Dimension of the elements (1D, 2D, 3D)
[ORDER]	Approximation order of the elements (P0, P1, P2, ...)
[BTYPE]	BasisType of the element (0-GaussLegendre, 1 - GaussLobatto, 2-Bernstein, 3-OpenUniform, 4-CloseUniform, 5-OpenHalfUniform)
[OBTYPE]	Open BasisType of the element for elements which have both types
[CBTYPE]	Closed BasisType of the element for elements which have both types

[FENAME] Is a special case for the Local FEC which generates a local version of a given FEC. It is selected from one of (BiCubic2DFiniteElement, Quad_Q3, Nedelec1HexFiniteElement, Hex_ND1, H1_[DIM]_[ORDER],H1Pos_[DIM]_[ORDER], L2_[DIM]_[ORDER] )

Definition at line 51 of file fe_coll.cpp.

void mfem::FiniteElementCollection::SubDofOrder	(	Geometry::Type	Geom,
		int	SDim,
		int	Info,
		Array< int > &	dofs
	)		const

Get the local dofs for a given sub-manifold.

Return the local dofs for a SDim-dimensional sub-manifold (0D - vertex, 1D

edge, 2D - face) including those on its boundary. The local index of the sub-manifold (inside Geom) and its orientation are given by the parameter Info = 64 * SubIndex + SubOrientation. Naturally, it is assumed that 0 <= SDim <= Dim(Geom).

Definition at line 397 of file fe_coll.cpp.

virtual const FiniteElement* mfem::FiniteElementCollection::TraceFiniteElementForGeometry ( Geometry::Type GeomType ) const

inlinevirtual

Reimplemented in mfem::L2_FECollection.

Definition at line 67 of file fe_coll.hpp.

Member Data Documentation

const int mfem::FiniteElementCollection::base_p

protected

Order as returned by GetOrder().

Definition at line 205 of file fe_coll.hpp.

Array<FiniteElementCollection*> mfem::FiniteElementCollection::var_orders

mutableprotected

Definition at line 212 of file fe_coll.hpp.

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

fem/fe_coll.hpp
fem/fe_coll.cpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation