A 3-dimensional four-faced element. More...

#include <Tetrahedron.h>

Inheritance diagram for Nektar::NekMeshUtils::Tetrahedron:

Public Member Functions
NEKMESHUTILS_EXPORT	Tetrahedron (ElmtConfig pConf, std::vector< NodeSharedPtr > pNodeList, std::vector< int > pTagList)
	Create a tetrahedron element. More...

NEKMESHUTILS_EXPORT	Tetrahedron (const Tetrahedron &pSrc)

virtual NEKMESHUTILS_EXPORT	~Tetrahedron ()

virtual NEKMESHUTILS_EXPORT SpatialDomains::GeometrySharedPtr	GetGeom (int coordDim)
	Generate a Nektar++ geometry object for this element. More...

virtual NEKMESHUTILS_EXPORT void	GetCurvedNodes (std::vector< NodeSharedPtr > &nodeList) const
	get list of volume interior nodes More...

virtual NEKMESHUTILS_EXPORT StdRegions::Orientation	GetEdgeOrient (int edgeId, EdgeSharedPtr edge)
	Get the edge orientation of `edge` with respect to the local element, which lies at edge index `edgeId`. More...

virtual NEKMESHUTILS_EXPORT void	MakeOrder (int order, SpatialDomains::GeometrySharedPtr geom, LibUtilities::PointsType pType, int coordDim, int &id, bool justConfig=false)
	Insert interior (i.e. volume) points into this element to make the geometry an order `order` representation. More...

virtual NEKMESHUTILS_EXPORT int	GetFaceVertex (int i, int j)
	Returns the local index of vertex `j` of face `i`. More...

Public Member Functions inherited from Nektar::NekMeshUtils::Element
NEKMESHUTILS_EXPORT	Element (ElmtConfig pConf, unsigned int pNumNodes, unsigned int pGotNodes)

NEKMESHUTILS_EXPORT unsigned int	GetId () const
	Returns the ID of the element (or associated edge or face for boundary elements). More...

NEKMESHUTILS_EXPORT unsigned int	GetDim () const
	Returns the expansion dimension of the element. More...

NEKMESHUTILS_EXPORT ElmtConfig	GetConf () const
	Returns the configuration of the element. More...

NEKMESHUTILS_EXPORT LibUtilities::ShapeType	GetShapeType () const
	returns the shapetype More...

NEKMESHUTILS_EXPORT std::string	GetTag () const
	Returns the tag which defines the element shape. More...

NEKMESHUTILS_EXPORT NodeSharedPtr	GetVertex (unsigned int i) const
	Access a vertex node. More...

NEKMESHUTILS_EXPORT EdgeSharedPtr	GetEdge (unsigned int i) const
	Access an edge. More...

NEKMESHUTILS_EXPORT FaceSharedPtr	GetFace (unsigned int i) const
	Access a face. More...

NEKMESHUTILS_EXPORT std::vector< NodeSharedPtr >	GetVertexList () const
	Access the list of vertex nodes. More...

NEKMESHUTILS_EXPORT std::vector< EdgeSharedPtr >	GetEdgeList () const
	Access the list of edges. More...

NEKMESHUTILS_EXPORT std::vector< FaceSharedPtr >	GetFaceList () const
	Access the list of faces. More...

NEKMESHUTILS_EXPORT std::vector< NodeSharedPtr >	GetVolumeNodes () const
	Access the list of volume nodes. More...

NEKMESHUTILS_EXPORT void	SetVolumeNodes (std::vector< NodeSharedPtr > &nodes)

NEKMESHUTILS_EXPORT LibUtilities::PointsType	GetCurveType () const

NEKMESHUTILS_EXPORT void	SetCurveType (LibUtilities::PointsType cT)

NEKMESHUTILS_EXPORT unsigned int	GetNodeCount ()
	Returns the total number of nodes (vertices, edge nodes and face nodes and volume nodes). More...

NEKMESHUTILS_EXPORT std::vector< int >	GetTagList () const
	Access the list of tags associated with this element. More...

NEKMESHUTILS_EXPORT unsigned int	GetVertexCount () const
	Returns the number of vertices. More...

NEKMESHUTILS_EXPORT unsigned int	GetEdgeCount () const
	Returns the number of edges. More...

NEKMESHUTILS_EXPORT unsigned int	GetFaceCount () const
	Returns the number of faces. More...

NEKMESHUTILS_EXPORT void	SetId (unsigned int p)
	Change the ID of the element. More...

NEKMESHUTILS_EXPORT void	SetVertex (unsigned int p, NodeSharedPtr pNew, bool descend=true)
	Replace a vertex in the element. More...

NEKMESHUTILS_EXPORT void	SetEdge (unsigned int p, EdgeSharedPtr pNew, bool descend=true)
	Replace an edge in the element. More...

NEKMESHUTILS_EXPORT void	SetFace (unsigned int p, FaceSharedPtr pNew)
	Replace a face in the element. More...

NEKMESHUTILS_EXPORT void	SetEdgeLink (EdgeSharedPtr pLink)
	Set a correspondence between this element and an edge (2D boundary element). More...

NEKMESHUTILS_EXPORT EdgeSharedPtr	GetEdgeLink ()
	Get correspondence between this element and an edge. More...

NEKMESHUTILS_EXPORT void	SetFaceLink (FaceSharedPtr pLink)
	Set a correspondence between this element and a face (3D boundary element). More...

NEKMESHUTILS_EXPORT FaceSharedPtr	GetFaceLink ()
	Get correspondence between this element and a face. More...

NEKMESHUTILS_EXPORT void	SetBoundaryLink (int i, int j)
	Set a correspondence between edge or face i and its representative boundary element m->element[expDim-1][j]. More...

NEKMESHUTILS_EXPORT int	GetBoundaryLink (int i)
	Get the location of the boundary face/edge i for this element. More...

NEKMESHUTILS_EXPORT bool	HasBoundaryLinks ()
	Is this element connected to a boundary. More...

NEKMESHUTILS_EXPORT void	SetTagList (const std::vector< int > &tags)
	Set the list of tags associated with this element. More...

virtual NEKMESHUTILS_EXPORT std::string	GetXmlString ()
	Generate a list of vertices (1D), edges (2D), or faces (3D). More...

NEKMESHUTILS_EXPORT std::string	GetXmlCurveString ()
	Generates a string listing the coordinates of all nodes associated with this element. More...

NEKMESHUTILS_EXPORT int	GetMaxOrder ()
	Obtain the order of an element by looking at edges. More...

NEKMESHUTILS_EXPORT bool	IsDeformed ()
	Determines whether an element is deformed by inspecting whether there are any edge, face or volume interior nodes. More...

NEKMESHUTILS_EXPORT std::pair< Node, Node >	GetBoundingBox ()
	Returns the approximate bounding box of this element based on the coordinates of all vertices, edges and faces of the element. Note that this does not robustly take into account the curvature of the element. More...

NEKMESHUTILS_EXPORT void	Print ()

virtual NEKMESHUTILS_EXPORT Array< OneD, NekDouble >	Normal (bool inward=false)
	returns the normal to the element More...

Static Public Member Functions
static ElementSharedPtr	create (ElmtConfig pConf, std::vector< NodeSharedPtr > pNodeList, std::vector< int > pTagList)
	Creates an instance of this class. More...

static NEKMESHUTILS_EXPORT unsigned int	GetNumNodes (ElmtConfig pConf)
	Return the number of nodes defining a tetrahedron. More...

Public Attributes
int	m_orientationMap [4]

int	m_origVertMap [4]

Public Attributes inherited from Nektar::NekMeshUtils::Element
CADObjectSharedPtr	m_parentCAD

Static Public Attributes
static LibUtilities::ShapeType	m_type
	Element type. More...

Protected Member Functions
void	OrientTet ()
	Orient tetrahedron to align degenerate vertices. More...

Static Private Attributes
static int	m_edgeVertMap [6][2]
	Local vertices that make up each tetrahedral edge. More...

static int	m_faceVertMap [4][3]
	Local vertices that make up each tetrahedral face. More...

static int	m_faceEdgeMap [4][3]
	Local edges that make up each tetrahedral face. More...

Additional Inherited Members
Protected Attributes inherited from Nektar::NekMeshUtils::Element
unsigned int	m_id
	ID of the element. More...

unsigned int	m_dim
	Dimension of the element. More...

ElmtConfig	m_conf
	Contains configuration of the element. More...

std::string	m_tag
	Tag character describing the element. More...

std::vector< int >	m_taglist
	List of integers specifying properties of the element. More...

std::vector< NodeSharedPtr >	m_vertex
	List of element vertex nodes. More...

std::vector< EdgeSharedPtr >	m_edge
	List of element edges. More...

std::vector< FaceSharedPtr >	m_face
	List of element faces. More...

std::vector< NodeSharedPtr >	m_volumeNodes
	List of element volume nodes. More...

LibUtilities::PointsType	m_curveType
	Volume curve type. More...

EdgeSharedPtr	m_edgeLink
	Pointer to the corresponding edge if element is a 2D boundary. More...

FaceSharedPtr	m_faceLink
	Pointer to the corresponding face if element is a 3D boundary. More...

std::map< int, int >	m_boundaryLinks
	Array mapping faces/edges to the location of the appropriate boundary elements in m->element. More...

SpatialDomains::GeometrySharedPtr	m_geom
	Nektar++ geometry object for this element. More...

Detailed Description

A 3-dimensional four-faced element.

Definition at line 49 of file Tetrahedron.h.

Constructor & Destructor Documentation

◆ Tetrahedron() [1/2]

Nektar::NekMeshUtils::Tetrahedron::Tetrahedron	(	ElmtConfig	pConf,
		std::vector< NodeSharedPtr >	pNodeList,
		std::vector< int >	pTagList
	)

Create a tetrahedron element.

Definition at line 74 of file Tetrahedron.cpp.

     : Element(pConf, GetNumNodes(pConf), pNodeList.size())
 {
     m_tag     = "A";
     m_dim     = 3;
     m_taglist = pTagList;
     int n     = m_conf.m_order - 1;
 
     m_vertex.resize(4);
     // Add vertices
     for (int i = 0; i < 4; ++i)
     {
         m_vertex[i] = pNodeList[i];
     }
 
     // Reorient the tet to ensure collapsed coordinates align between
     // adjacent elements.
     if (m_conf.m_reorient)
     {
         OrientTet();
     }
     else
     {
         // If we didn't need to orient the tet then set up the
         // orientation map as the identity mapping.
         for (int i = 0; i < 4; ++i)
         {
             m_orientationMap[i] = i;
         }
     }
 
     // Create edges (with corresponding set of edge points). Apply orientation
     // logic to get the right interior points for each edge.
     m_edge.resize(6);
     for (int i = 0; i < 6; ++i)
     {
         std::vector<NodeSharedPtr> edgeNodes(n);
 
         int origEdge = -1;
         bool rev = false;
         for (int j = 0; j < 6; ++j)
         {
             if (m_edgeVertMap[i][0] == m_origVertMap[m_edgeVertMap[j][0]] &&
                 m_edgeVertMap[i][1] == m_origVertMap[m_edgeVertMap[j][1]])
             {
                 origEdge = j;
                 break;
             }
             else if (m_edgeVertMap[i][0] == m_origVertMap[m_edgeVertMap[j][1]] &&
                      m_edgeVertMap[i][1] == m_origVertMap[m_edgeVertMap[j][0]])
             {
                 origEdge = j;
                 rev = true;
                 break;
             }
         }
 
         for (int j = 0; j < n; ++j)
         {
             edgeNodes[j] = pNodeList[4 + origEdge * n + j];
         }
         if (rev)
         {
             m_edge[i] = std::make_shared<Edge>(
                 m_vertex[m_edgeVertMap[i][1]],
                 m_vertex[m_edgeVertMap[i][0]],
                 edgeNodes,
                 m_conf.m_edgeCurveType);
         }
         else
         {
             m_edge[i] = std::make_shared<Edge>(
                 m_vertex[m_edgeVertMap[i][0]],
                 m_vertex[m_edgeVertMap[i][1]],
                 edgeNodes,
                 m_conf.m_edgeCurveType);
         }
     }
 
     m_face.resize(4);
 
     // Create faces
     for (int j = 0; j < 4; ++j)
     {
         vector<NodeSharedPtr> faceVertices(3);
         vector<EdgeSharedPtr> faceEdges(3);
         vector<NodeSharedPtr> faceNodes;
 
         for (int k = 0; k < 3; ++k)
         {
             faceVertices[k] = m_vertex[m_faceVertMap[j][k]];
             faceEdges[k] = m_edge[m_faceEdgeMap[j][k]];
         }
 
         // When face curvature is supplied, it may have been the case
         // that our tetrahedron was reoriented. In this case, faces have
         // different vertex IDs and so we have to rotate the face
         // curvature so that the two align appropriately.
         if (m_conf.m_faceNodes)
         {
             const int nFaceNodes = n * (n - 1) / 2;
 
             // Get the vertex IDs of whatever face we are processing.
             vector<int> faceVertIds(3);
             faceVertIds[0] = faceVertices[0]->m_id;
             faceVertIds[1] = faceVertices[1]->m_id;
             faceVertIds[2] = faceVertices[2]->m_id;
 
             // Find out the original face number as we were given it in
             // the constructor using the orientation map.
             int origFace = -1;
             for (int i = 0; i < 4; ++i)
             {
                 if (m_orientationMap[i] == j)
                 {
                     origFace = i;
                     break;
                 }
             }
 
             ASSERTL0(origFace >= 0, "Couldn't find face");
 
             // Now get the face nodes for the original face.
             int N = 4 + 6 * n + origFace * nFaceNodes;
             for (int i = 0; i < nFaceNodes; ++i)
             {
                 faceNodes.push_back(pNodeList[N + i]);
             }
 
             // Find the original face vertex IDs.
             vector<int> origFaceIds(3);
             origFaceIds[0] = pNodeList[m_faceVertMap[origFace][0]]->m_id;
             origFaceIds[1] = pNodeList[m_faceVertMap[origFace][1]]->m_id;
             origFaceIds[2] = pNodeList[m_faceVertMap[origFace][2]]->m_id;
 
             // Construct a HOTriangle object which performs the
             // orientation magically for us.
             HOTriangle<NodeSharedPtr> hoTri(origFaceIds, faceNodes);
             hoTri.Align(faceVertIds);
 
             // Copy the face nodes back again.
             faceNodes = hoTri.surfVerts;
         }
 
         m_face[j] = std::make_shared<Face>(
             faceVertices, faceNodes, faceEdges, m_conf.m_faceCurveType);
     }
 
     if (m_conf.m_volumeNodes)
     {
         const int nFaceNodes = n * (n - 1) / 2;
         for (int i = 4 + 6 * n + 4 * nFaceNodes; i < pNodeList.size(); ++i)
         {
             m_volumeNodes.push_back(pNodeList[i]);
         }
     }
 }

◆ Tetrahedron() [2/2]

NEKMESHUTILS_EXPORT Nektar::NekMeshUtils::Tetrahedron::Tetrahedron ( const Tetrahedron & pSrc )

◆ ~Tetrahedron()

virtual NEKMESHUTILS_EXPORT Nektar::NekMeshUtils::Tetrahedron::~Tetrahedron ( )

inlinevirtual

Definition at line 66 of file Tetrahedron.h.

References GetCurvedNodes(), GetEdgeOrient(), GetGeom(), GetNumNodes(), MakeOrder(), and NEKMESHUTILS_EXPORT.

67 {

68 }

Member Function Documentation

◆ create()

static ElementSharedPtr Nektar::NekMeshUtils::Tetrahedron::create	(	ElmtConfig	pConf,
		std::vector< NodeSharedPtr >	pNodeList,
		std::vector< int >	pTagList
	)

inlinestatic

Creates an instance of this class.

Definition at line 53 of file Tetrahedron.h.

     {
         return std::make_shared<Tetrahedron>(pConf, pNodeList, pTagList);
     }

◆ GetCurvedNodes()

void Nektar::NekMeshUtils::Tetrahedron::GetCurvedNodes ( std::vector< NodeSharedPtr > & nodeList ) const

virtual

get list of volume interior nodes

Reimplemented from Nektar::NekMeshUtils::Element.

Definition at line 359 of file Tetrahedron.cpp.

References Nektar::NekMeshUtils::HOTriangle< T >::Align(), CellMLToNektar.pycml::copy(), Nektar::NekMeshUtils::Element::m_edge, Nektar::NekMeshUtils::Element::m_face, Nektar::NekMeshUtils::Element::m_id, Nektar::NekMeshUtils::Element::m_vertex, Nektar::NekMeshUtils::Element::m_volumeNodes, and Nektar::NekMeshUtils::HOTriangle< T >::surfVerts.

Referenced by ~Tetrahedron().

 {
     int n = m_edge[0]->GetNodeCount();
     nodeList.resize(n*(n+1)*(n+2)/6);
 
     nodeList[0] = m_vertex[0];
     nodeList[1] = m_vertex[1];
     nodeList[2] = m_vertex[2];
     nodeList[3] = m_vertex[3];
     int k = 4;
 
     for(int i = 0; i < 6; i++)
     {
         bool reverseEdge = false;
         if(i < 3)
         {
             reverseEdge = m_edge[i]->m_n1 == m_vertex[i];
         }
         else
         {
             reverseEdge = m_edge[i]->m_n1 == m_vertex[i-3];
         }
 
         if (reverseEdge)
         {
             for(int j = 0; j < n-2; j++)
             {
                 nodeList[k++] = m_edge[i]->m_edgeNodes[j];
             }
         }
         else
         {
             for(int j = n-3; j >= 0; j--)
             {
                 nodeList[k++] = m_edge[i]->m_edgeNodes[j];
             }
         }
     }
 
     vector<vector<int> > ts;
     vector<int> t(3);
     t[0] = m_vertex[0]->m_id;
     t[1] = m_vertex[1]->m_id;
     t[2] = m_vertex[2]->m_id;
     ts.push_back(t);
     t[0] = m_vertex[0]->m_id;
     t[1] = m_vertex[1]->m_id;
     t[2] = m_vertex[3]->m_id;
     ts.push_back(t);
     t[0] = m_vertex[1]->m_id;
     t[1] = m_vertex[2]->m_id;
     t[2] = m_vertex[3]->m_id;
     ts.push_back(t);
     t[0] = m_vertex[0]->m_id;
     t[1] = m_vertex[2]->m_id;
     t[2] = m_vertex[3]->m_id;
     ts.push_back(t);
 
     for(int i = 0; i < 4; i++)
     {
         vector<int> fcid;
         fcid.push_back(m_face[i]->m_vertexList[0]->m_id);
         fcid.push_back(m_face[i]->m_vertexList[1]->m_id);
         fcid.push_back(m_face[i]->m_vertexList[2]->m_id);
 
         HOTriangle<NodeSharedPtr> hot(fcid, m_face[i]->m_faceNodes);
 
         hot.Align(ts[i]);
 
         std::copy(hot.surfVerts.begin(),
                   hot.surfVerts.end(),
                   nodeList.begin() + k);
         k+= hot.surfVerts.size();
     }
 
     std::copy(m_volumeNodes.begin(),
               m_volumeNodes.end(),
               nodeList.begin() + k);
 }

◆ GetEdgeOrient()

StdRegions::Orientation Nektar::NekMeshUtils::Tetrahedron::GetEdgeOrient	(	int	edgeId,
		EdgeSharedPtr	edge
	)

virtual

Get the edge orientation of edge with respect to the local element, which lies at edge index edgeId.

Reimplemented from Nektar::NekMeshUtils::Element.

Definition at line 252 of file Tetrahedron.cpp.

References ASSERTL1, Nektar::StdRegions::eBackwards, Nektar::StdRegions::eForwards, Nektar::StdRegions::eNoOrientation, m_edgeVertMap, and Nektar::NekMeshUtils::Element::m_vertex.

Referenced by ~Tetrahedron().

 {
     if (edge->m_n1 == m_vertex[m_edgeVertMap[edgeId][0]])
     {
         return StdRegions::eForwards;
     }
     else if (edge->m_n1 == m_vertex[m_edgeVertMap[edgeId][1]])
     {
         return StdRegions::eBackwards;
     }
     else
     {
         ASSERTL1(false, "Edge is not connected to this quadrilateral.");
     }
 
     return StdRegions::eNoOrientation;
 }

◆ GetFaceVertex()

virtual NEKMESHUTILS_EXPORT int Nektar::NekMeshUtils::Tetrahedron::GetFaceVertex	(	int	i,
		int	j
	)

inlinevirtual

Returns the local index of vertex j of face i.

Reimplemented from Nektar::NekMeshUtils::Element.

Definition at line 85 of file Tetrahedron.h.

References m_faceVertMap.

     {
         return m_faceVertMap[i][j];
     }

◆ GetGeom()

SpatialDomains::GeometrySharedPtr Nektar::NekMeshUtils::Tetrahedron::GetGeom ( int coordDim )

virtual

Generate a Nektar++ geometry object for this element.

Reimplemented from Nektar::NekMeshUtils::Element.

Definition at line 234 of file Tetrahedron.cpp.

References Nektar::MemoryManager< DataType >::AllocateSharedPtr(), Nektar::NekMeshUtils::Element::m_face, and Nektar::NekMeshUtils::Element::m_id.

Referenced by ~Tetrahedron().

 {
     SpatialDomains::TriGeomSharedPtr tfaces[4];
     SpatialDomains::TetGeomSharedPtr ret;
 
     for (int i = 0; i < 4; ++i)
     {
         tfaces[i] = std::dynamic_pointer_cast<SpatialDomains::TriGeom>(
             m_face[i]->GetGeom(coordDim));
     }
 
     ret = MemoryManager<SpatialDomains::TetGeom>::AllocateSharedPtr(
         m_id, tfaces);
     ret->Setup();
 
     return ret;
 }

◆ GetNumNodes()

unsigned int Nektar::NekMeshUtils::Tetrahedron::GetNumNodes ( ElmtConfig pConf )

static

Return the number of nodes defining a tetrahedron.

Definition at line 348 of file Tetrahedron.cpp.

References Nektar::NekMeshUtils::ElmtConfig::m_faceNodes, Nektar::NekMeshUtils::ElmtConfig::m_order, and Nektar::NekMeshUtils::ElmtConfig::m_volumeNodes.

Referenced by Nektar::Utilities::InputGmsh::GetNnodes(), and ~Tetrahedron().

 {
     int n = pConf.m_order;
     if (pConf.m_volumeNodes && pConf.m_faceNodes)
         return (n + 1) * (n + 2) * (n + 3) / 6;
     else if (!pConf.m_volumeNodes && pConf.m_faceNodes)
         return 4 * (n + 1) * (n + 2) / 2 - 6 * (n + 1) + 4;
     else
         return 6 * (n + 1) - 8;
 }

◆ MakeOrder()

void Nektar::NekMeshUtils::Tetrahedron::MakeOrder	(	int	order,
		SpatialDomains::GeometrySharedPtr	geom,
		LibUtilities::PointsType	edgeType,
		int	coordDim,
		int &	id,
		bool	justConfig = `false`
	)

virtual

Insert interior (i.e. volume) points into this element to make the geometry an order order representation.

Parameters

order	The desired polynomial order.
geom	The geometry object used to describe the curvature mapping.
edgeType	The points distribution to use on the volume.
coordDim	The coordinate (i.e. space) dimension.
id	Counter which should be incremented to supply consistent vertex IDs.
justConfig	If true, then the configuration Element::m_conf will be updated but no nodes will be generated. This is used when considering boundary elements, which just require copying of face or edge interior nodes.

Reimplemented from Nektar::NekMeshUtils::Element.

Definition at line 271 of file Tetrahedron.cpp.

References Nektar::MemoryManager< DataType >::AllocateSharedPtr(), ASSERTL1, Nektar::LibUtilities::PointsKey::GetPointsDim(), Nektar::NekMeshUtils::Element::m_conf, Nektar::NekMeshUtils::Element::m_curveType, Nektar::NekMeshUtils::ElmtConfig::m_faceNodes, Nektar::NekMeshUtils::ElmtConfig::m_order, Nektar::NekMeshUtils::ElmtConfig::m_volumeNodes, Nektar::NekMeshUtils::Element::m_volumeNodes, and Nektar::LibUtilities::PointsManager().

Referenced by ~Tetrahedron().

 {
     m_conf.m_order = order;
     m_curveType    = pType;
     m_volumeNodes.clear();
 
     if (order == 1 || order == 2)
     {
         m_conf.m_volumeNodes = m_conf.m_faceNodes = false;
         return;
     }
     else if (order == 2)
     {
         m_conf.m_faceNodes   = true;
         m_conf.m_volumeNodes = false;
         return;
     }
     else if (order == 3)
     {
         m_conf.m_volumeNodes = false;
         return;
     }
 
     m_conf.m_faceNodes   = true;
     m_conf.m_volumeNodes = true;
 
     if (justConfig)
     {
         return;
     }
 
     int nPoints = order + 1;
     StdRegions::StdExpansionSharedPtr xmap = geom->GetXmap();
 
     Array<OneD, NekDouble> px, py, pz;
     LibUtilities::PointsKey pKey(nPoints, pType);
     ASSERTL1(pKey.GetPointsDim() == 3, "Points distribution must be 3D");
     LibUtilities::PointsManager()[pKey]->GetPoints(px, py, pz);
 
     Array<OneD, Array<OneD, NekDouble> > phys(coordDim);
 
     for (int i = 0; i < coordDim; ++i)
     {
         phys[i] = Array<OneD, NekDouble>(xmap->GetTotPoints());
         xmap->BwdTrans(geom->GetCoeffs(i), phys[i]);
     }
 
     const int nTetPts    = nPoints * (nPoints + 1) * (nPoints + 2) / 6;
     const int nTetIntPts = (nPoints - 4) * (nPoints - 3) * (nPoints - 2) / 6;
     m_volumeNodes.resize(nTetIntPts);
 
     for (int i = nTetPts - nTetIntPts, cnt = 0; i < nTetPts; ++i, ++cnt)
     {
         Array<OneD, NekDouble> xp(3);
         xp[0] = px[i];
         xp[1] = py[i];
         xp[2] = pz[i];
 
         Array<OneD, NekDouble> x(3, 0.0);
         for (int j = 0; j < coordDim; ++j)
         {
             x[j] = xmap->PhysEvaluate(xp, phys[j]);
         }
 
         m_volumeNodes[cnt] = MemoryManager<Node>::AllocateSharedPtr(
             id++, x[0], x[1], x[2]);
     }
 }

◆ OrientTet()

void Nektar::NekMeshUtils::Tetrahedron::OrientTet ( )

protected

Orient tetrahedron to align degenerate vertices.

Orientation of tetrahedral elements is required so that the singular vertices of triangular faces (which occur as a part of the collapsed co-ordinate system) align. The algorithm is based on that used in T. Warburton's thesis and in the original Nektar source.

First the vertices are ordered with the highest global vertex at the top degenerate point, and the base degenerate point has second lowest ID. These vertices are swapped if the element is incorrectly oriented.

Definition at line 465 of file Tetrahedron.cpp.

References CG_Iterations::ax, m_faceVertMap, Nektar::NekMeshUtils::Element::m_id, m_orientationMap, m_origVertMap, Nektar::NekMeshUtils::Element::m_vertex, and Nektar::NekMeshUtils::sort3().

Referenced by Tetrahedron().

 {
     // Create a copy of the original vertex ordering. This is used to
     // construct a mapping, #orientationMap, which maps the original
     // face ordering to the new face ordering.
     int orig_faces[4][3];
     for (int i = 0; i < 4; ++i)
     {
         int v0id = m_vertex[m_faceVertMap[i][0]]->m_id;
         int v1id = m_vertex[m_faceVertMap[i][1]]->m_id;
         int v2id = m_vertex[m_faceVertMap[i][2]]->m_id;
         sort3(v0id, v1id, v2id);
         orig_faces[i][0] = v0id;
         orig_faces[i][1] = v1id;
         orig_faces[i][2] = v2id;
     }
 
     // Store a copy of the original vertex ordering so we can create a
     // permutation map later.
     vector<NodeSharedPtr> origVert = m_vertex;
 
     // Order vertices with highest global vertex at top degenerate
     // point. Place second highest global vertex at base degenerate
     // point.
     sort(m_vertex.begin(), m_vertex.end());
 
     // Calculate a.(b x c) if negative, reverse order of
     // non-degenerate points to correctly orientate the tet.
 
     NekDouble ax = m_vertex[1]->m_x - m_vertex[0]->m_x;
     NekDouble ay = m_vertex[1]->m_y - m_vertex[0]->m_y;
     NekDouble az = m_vertex[1]->m_z - m_vertex[0]->m_z;
     NekDouble bx = m_vertex[2]->m_x - m_vertex[0]->m_x;
     NekDouble by = m_vertex[2]->m_y - m_vertex[0]->m_y;
     NekDouble bz = m_vertex[2]->m_z - m_vertex[0]->m_z;
     NekDouble cx = m_vertex[3]->m_x - m_vertex[0]->m_x;
     NekDouble cy = m_vertex[3]->m_y - m_vertex[0]->m_y;
     NekDouble cz = m_vertex[3]->m_z - m_vertex[0]->m_z;
 
     NekDouble nx   = (ay * bz - az * by);
     NekDouble ny   = (az * bx - ax * bz);
     NekDouble nz   = (ax * by - ay * bx);
     NekDouble nmag = sqrt(nx * nx + ny * ny + nz * nz);
     nx /= nmag;
     ny /= nmag;
     nz /= nmag;
 
     NekDouble area = 0.5 * nmag;
 
     // distance of top vertex from base
     NekDouble dist = cx * nx + cy * ny + cz * nz;
 
     if (fabs(dist) / area <= 1e-4 )
     {
         cerr << "Warning: degenerate tetrahedron, 3rd vertex is = " << dist
              << " from face" << endl;
     }
 
     if (dist < 0)
     {
         swap(m_vertex[0], m_vertex[1]);
     }
 
     nx   = (ay * cz - az * cy);
     ny   = (az * cx - ax * cz);
     nz   = (ax * cy - ay * cx);
     nmag = sqrt(nx * nx + ny * ny + nz * nz);
     nx /= nmag;
     ny /= nmag;
     nz /= nmag;
 
     area = 0.5 * nmag;
 
     // distance of top vertex from base
     dist = bx * nx + by * ny + bz * nz;
 
     if (fabs(dist) / area <= 1e-4)
     {
         cerr << "Warning: degenerate tetrahedron, 2nd vertex is = " << dist
              << " from face" << endl;
     }
 
     nx   = (by * cz - bz * cy);
     ny   = (bz * cx - bx * cz);
     nz   = (bx * cy - by * cx);
     nmag = sqrt(nx * nx + ny * ny + nz * nz);
     nx /= nmag;
     ny /= nmag;
     nz /= nmag;
 
     area = 0.5 * nmag;
 
     // distance of top vertex from base
     dist = ax * nx + ay * ny + az * nz;
 
     if (fabs(dist) / area <= 1e-4)
     {
         cerr << "Warning: degenerate tetrahedron, 1st vertex is = " << dist
              << " from face" << endl;
     }
 
     // Search for the face in the original set of face nodes. Then use
     // this to construct the #orientationMap.
     for (int i = 0; i < 4; ++i)
     {
         int v0id = m_vertex[m_faceVertMap[i][0]]->m_id;
         int v1id = m_vertex[m_faceVertMap[i][1]]->m_id;
         int v2id = m_vertex[m_faceVertMap[i][2]]->m_id;
         sort3(v0id, v1id, v2id);
 
         for (int j = 0; j < 4; ++j)
         {
             if (v0id == orig_faces[j][0] && v1id == orig_faces[j][1] &&
                 v2id == orig_faces[j][2])
             {
                 m_orientationMap[j] = i;
                 break;
             }
         }
 
         for (int j = 0; j < 4; ++j)
         {
             if (m_vertex[i]->m_id == origVert[j]->m_id)
             {
                 m_origVertMap[j] = i;
                 break;
             }
         }
     }
 }

Member Data Documentation

◆ m_edgeVertMap

int Nektar::NekMeshUtils::Tetrahedron::m_edgeVertMap

staticprivate

Initial value:

= {
    {0, 1}, {1, 2}, {0, 2}, {0, 3}, {1, 3}, {2, 3}
}

Local vertices that make up each tetrahedral edge.

Definition at line 97 of file Tetrahedron.h.

Referenced by GetEdgeOrient(), and Tetrahedron().

◆ m_faceEdgeMap

int Nektar::NekMeshUtils::Tetrahedron::m_faceEdgeMap

staticprivate

Initial value:

= {
    {0, 1, 2}, {0, 4, 3}, {1, 5, 4}, {2, 5, 3}
}

Local edges that make up each tetrahedral face.

Definition at line 99 of file Tetrahedron.h.

Referenced by Tetrahedron().

◆ m_faceVertMap

int Nektar::NekMeshUtils::Tetrahedron::m_faceVertMap

staticprivate

Initial value:

= {
    {0, 1, 2}, {0, 1, 3}, {1, 2, 3}, {0, 2, 3}
}

Local vertices that make up each tetrahedral face.

Definition at line 98 of file Tetrahedron.h.

Referenced by GetFaceVertex(), OrientTet(), and Tetrahedron().

◆ m_orientationMap

int Nektar::NekMeshUtils::Tetrahedron::m_orientationMap[4]

Definition at line 90 of file Tetrahedron.h.

Referenced by OrientTet(), Nektar::Utilities::InputNek::Process(), and Tetrahedron().

◆ m_origVertMap

int Nektar::NekMeshUtils::Tetrahedron::m_origVertMap[4]

Definition at line 91 of file Tetrahedron.h.

Referenced by OrientTet(), and Tetrahedron().

◆ m_type

LibUtilities::ShapeType Nektar::NekMeshUtils::Tetrahedron::m_type

static

Initial value:

=
    GetElementFactory().RegisterCreatorFunction(
        LibUtilities::eTetrahedron, Tetrahedron::create, "Tetrahedron")

Element type.

Definition at line 60 of file Tetrahedron.h.

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Protected Member Functions

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Tetrahedron() [1/2]

◆ Tetrahedron() [2/2]

◆ ~Tetrahedron()

Member Function Documentation

◆ create()

◆ GetCurvedNodes()

◆ GetEdgeOrient()

◆ GetFaceVertex()

◆ GetGeom()

◆ GetNumNodes()

◆ MakeOrder()

◆ OrientTet()

Member Data Documentation

◆ m_edgeVertMap

◆ m_faceEdgeMap

◆ m_faceVertMap

◆ m_orientationMap

◆ m_origVertMap

◆ m_type