Defines a face between two finite elements in two-dimensions (i.e., an interval). More...

#include <ptems/finiteelement.hpp>

Inheritance diagram for ptems::FEFace< 2 >:

Collaboration diagram for ptems::FEFace< 2 >:

Public Types
typedef LegacyRandomAccessIterator< const std::size_t >	iterator
	Type for an iterator over the list of vertex indices for the face. More...

typedef iterator	const_iterator
	Type for a const iterator over the list of vertex indices for the face. More...

typedef std::reverse_iterator< iterator >	reverse_iterator
	Type for an iterator over the list of vertex indices for the face, iterating in reverse. More...

typedef std::reverse_iterator< reverse_iterator >	const_reverse_iterator
	Type for a const iterator over the list of vertex indices for the face, iterating in reverse. More...

Public Member Functions
std::shared_ptr< FiniteElement< 2 > >	Left () const
	Pointer to "left" neighbour of the face. More...

std::shared_ptr< FiniteElement< 2 > >	Right () const
	Pointer to "right" neighbour of the face; or null if the face is on the boundary. More...

bool	IsInterior () const
	Gets if the face represents an interior face (has right neighbour) More...

bool	IsBoundary () const
	Gets if the face represents a boundary face (no right neighbour) More...

void	Right (const std::shared_ptr< FiniteElement< 2 > > &right)
	Sets the right neighbour of the face. More...

const std::size_t &	operator[] (std::size_t i) const
	Returns the global index of the ith vertex of the face. More...

const std::size_t &	VertexIndex (std::size_t i) const
	Returns the global index of the ith vertex of the face. More...

std::size_t	VertexCount () const
	Gets the number of vertices in the face. More...

iterator	begin () const
	Gets the begin iterator for iterating over the vertex indices of the face. More...

iterator	end () const
	Gets the end iterator for iterating over the vertex indices of the face. More...

const_iterator	cbegin () const
	Gets the const begin iterator for iterating over the vertex indices of the face. More...

const_iterator	cend () const
	Gets the const end iterator for iterating over the vertex indices of the face. More...

reverse_iterator	rbegin () const
	Gets the begin iterator for iterating over the vertex indices of the face in reverse. More...

reverse_iterator	rend () const
	Gets the end iterator for iterating over the vertex indices of the face in reverse. More...

const_reverse_iterator	crbegin () const
	Gets the const begin iterator for iterating over the vertex indices of the face in reverse. More...

const_reverse_iterator	crend () const
	Gets the const end iterator for iterating over the vertex indices of the face in reverse. More...

double	Diameter () const
	Gets the diameter of the face. More...

double	Volume () const
	Gets the volume of the face. More...

Vector< 2 >	Normal () const
	Gets the normal to the face. More...

bool	IsEqual (const std::shared_ptr< FEFace< 2 >> &rhs) const
	Checks if the specified face is equal to this face (has same vertices), even if vertices are in different order (e.g., Normal() may be different). More...

bool	IsEqual (const FEFace< 2 > &rhs) const
	Checks if the specified face is equal to this face (has same vertices), even if vertices are in different order (e.g., Normal() may be different). More...

Vector< 2 >	Barycentre () const
	Gets the barycentre of the face. More...

const std::array< ReferenceMapping< 1, 2 >, 1 > &	ReferenceMappings () const
	Gets the mapping between the local coordinates for the left element and the reference interval for the face. More...

Vector< 2 >	LocalToGlobal (const Vector< 1 > &pt)
	Converts a local point on the element (value in interval \([0,1]\)) into a global point. More...

template<typename ALGO >
QuadraturePoints< 1 >	ComputeQuadraturePoints (ALGO algorithm, std::size_t order)
	Computes the quadrature points for the face. More...

T	shared_from_this (T... args)

T	weak_from_this (T... args)

Friends
class	FiniteElement< 2 >

class	FEMesh< 2 >

Detailed Description

Defines a face between two finite elements in two-dimensions (i.e., an interval).

Warning: Object of this type (or derived) MUST be constructed and stored in a shared_ptr.

Member Typedef Documentation

◆ const_iterator

typedef iterator ptems::FEFace< 2 >::const_iterator

Type for a const iterator over the list of vertex indices for the face.

◆ const_reverse_iterator

typedef std::reverse_iterator<reverse_iterator> ptems::FEFace< 2 >::const_reverse_iterator

Type for a const iterator over the list of vertex indices for the face, iterating in reverse.

◆ iterator

typedef LegacyRandomAccessIterator< const std::size_t > ptems::FEFace< 2 >::iterator

Type for an iterator over the list of vertex indices for the face.

◆ reverse_iterator

typedef std::reverse_iterator<iterator> ptems::FEFace< 2 >::reverse_iterator

Type for an iterator over the list of vertex indices for the face, iterating in reverse.

Member Function Documentation

◆ Barycentre()

Vector< 2 > ptems::FEFace< 2 >::Barycentre ( ) const

inline

Gets the barycentre of the face.

Returns: Face barycentre

◆ begin()

iterator ptems::FEFace< 2 >::begin ( ) const

inline

Gets the begin iterator for iterating over the vertex indices of the face.

◆ cbegin()

const_iterator ptems::FEFace< 2 >::cbegin ( ) const

inline

Gets the const begin iterator for iterating over the vertex indices of the face.

◆ cend()

const_iterator ptems::FEFace< 2 >::cend ( ) const

inline

Gets the const end iterator for iterating over the vertex indices of the face.

◆ ComputeQuadraturePoints()

template<typename ALGO >

QuadraturePoints< 1 > ptems::FEFace< 2 >::ComputeQuadraturePoints	(	ALGO	algorithm,
		std::size_t	order
	)

Computes the quadrature points for the face.

The points are in local face coordinates, and weights are for the global integration.

Template Parameters

ALGO	Type of an algorithm for generating quadrature points on a reference element

Parameters

algorithm	An algorithm for generating quadrature points on a reference element
order	The order of the quadrature

Returns: The set of quadrature points to use in local element coordinates (local to reference face)

◆ crbegin()

const_reverse_iterator ptems::FEFace< 2 >::crbegin ( ) const

inline

Gets the const begin iterator for iterating over the vertex indices of the face in reverse.

◆ crend()

const_reverse_iterator ptems::FEFace< 2 >::crend ( ) const

inline

Gets the const end iterator for iterating over the vertex indices of the face in reverse.

◆ Diameter()

double ptems::FEFace< 2 >::Diameter ( ) const

inline

Gets the diameter of the face.

Returns: The face diameter.

◆ end()

iterator ptems::FEFace< 2 >::end ( ) const

inline

Gets the end iterator for iterating over the vertex indices of the face.

◆ IsBoundary()

bool ptems::FEFace< 2 >::IsBoundary ( ) const

inline

Gets if the face represents a boundary face (no right neighbour)

Note: Opposite of IsInterior();

Returns: true If boundary, false otherwise

◆ IsEqual() [1/2]

bool ptems::FEFace< 2 >::IsEqual ( const FEFace< 2 > & rhs ) const

inline

Checks if the specified face is equal to this face (has same vertices), even if vertices are in different order (e.g., Normal() may be different).

Parameters

rhs	The face to check if equal to this

Returns: true if the faces represent the same face, regardless of orientation; false otherwise

◆ IsEqual() [2/2]

bool ptems::FEFace< 2 >::IsEqual ( const std::shared_ptr< FEFace< 2 >> & rhs ) const

inline

Checks if the specified face is equal to this face (has same vertices), even if vertices are in different order (e.g., Normal() may be different).

Parameters

rhs	The face to check if equal to this

Returns: true if the faces represent the same face, regardless of orientation; false otherwise

◆ IsInterior()

bool ptems::FEFace< 2 >::IsInterior ( ) const

inline

Gets if the face represents an interior face (has right neighbour)

Note: Opposite of IsBoundary();

Returns: true If interior, false otherwise

◆ Left()

std::shared_ptr< FiniteElement<2> > ptems::FEFace< 2 >::Left ( ) const

inline

Pointer to "left" neighbour of the face.

◆ LocalToGlobal()

Vector<2> ptems::FEFace< 2 >::LocalToGlobal ( const Vector< 1 > & pt )

inline

Converts a local point on the element (value in interval \([0,1]\)) into a global point.

Parameters

pt	The local point to map

Returns: The global point

◆ Normal()

Vector<2> ptems::FEFace< 2 >::Normal ( ) const

inline

Gets the normal to the face.

The normal is the outward normal w.r.t. the left neighbour, and the inward normal w.r.t the right neighbour.

Returns: The normal w.r.t. the left neighbour.

◆ operator[]()

const std::size_t& ptems::FEFace< 2 >::operator[] ( std::size_t i ) const

inline

Returns the global index of the ith vertex of the face.

Parameters

i	The index of the vertex to get.

Exceptions

std::out_of_range If i is not less than VertexCount()

Returns: Index of the vertex on the mesh

◆ rbegin()

reverse_iterator ptems::FEFace< 2 >::rbegin ( ) const

inline

Gets the begin iterator for iterating over the vertex indices of the face in reverse.

◆ ReferenceMappings()

const std::array<ReferenceMapping<1,2>,1>& ptems::FEFace< 2 >::ReferenceMappings ( ) const

inline

Gets the mapping between the local coordinates for the left element and the reference interval for the face.

Returns: Mapping to reference interval

◆ rend()

reverse_iterator ptems::FEFace< 2 >::rend ( ) const

inline

Gets the end iterator for iterating over the vertex indices of the face in reverse.

◆ Right() [1/2]

std::shared_ptr< FiniteElement<2> > ptems::FEFace< 2 >::Right ( ) const

inline

Pointer to "right" neighbour of the face; or null if the face is on the boundary.

◆ Right() [2/2]

void ptems::FEFace< 2 >::Right ( const std::shared_ptr< FiniteElement< 2 > > & right )

inline

Sets the right neighbour of the face.

Parameters

right The right hand neighbour, or null for no neighbour.

◆ VertexCount()

std::size_t ptems::FEFace< 2 >::VertexCount ( ) const

inline

Gets the number of vertices in the face.

Returns: Number of vertices in the face.

◆ VertexIndex()

const std::size_t& ptems::FEFace< 2 >::VertexIndex ( std::size_t i ) const

inline

Returns the global index of the ith vertex of the face.

Parameters

i	The index of the vertex to get.

Exceptions

std::out_of_range If i is not less than VertexCount()

Returns: Index of the vertex on the mesh

◆ Volume()

double ptems::FEFace< 2 >::Volume ( ) const

inline

Gets the volume of the face.

Returns: Face volume

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

ptems/finiteelement.hpp

Public Types

Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ const_iterator

◆ const_reverse_iterator

◆ iterator

◆ reverse_iterator

Member Function Documentation

◆ Barycentre()

◆ begin()

◆ cbegin()

◆ cend()

◆ ComputeQuadraturePoints()

◆ crbegin()

◆ crend()

◆ Diameter()

◆ end()

◆ IsBoundary()

◆ IsEqual() [1/2]

◆ IsEqual() [2/2]

◆ IsInterior()

◆ Left()

◆ LocalToGlobal()

◆ Normal()

◆ operator[]()

◆ rbegin()

◆ ReferenceMappings()

◆ rend()

◆ Right() [1/2]

◆ Right() [2/2]

◆ VertexCount()

◆ VertexIndex()

◆ Volume()