MeshLib::Element Class Reference

Detailed Description

Virtual base class for mesh elements.

Definition at line 35 of file Element.h.

#include <Element.h>

Inheritance diagram for MeshLib::Element:

Collaboration diagram for MeshLib::Element:

Public Member Functions
std::optional< unsigned >	addNeighbor (Element *e)
	Tries to add an element e as neighbour to this element. If the elements really are neighbours, the element is added to the neighbour-list and the face id of the neighbour connected to this element is returned. Otherwise the maximum value of the value type is returned.
virtual double	getContent () const =0
	Returns the length, area or volume of a 1D, 2D or 3D element.
virtual const Node *	getNode (unsigned idx) const =0
virtual Node *	getNode (unsigned idx)=0
virtual void	setNode (unsigned idx, Node *node)=0
virtual Node *const *	getNodes () const =0
	Get array of element nodes.
constexpr std::span< Node *const >	nodes () const
	Span of element's nodes, their pointers actually.
virtual constexpr unsigned	getDimension () const =0
	Get dimension of the mesh element.
virtual const Element *	getEdge (unsigned i) const =0
	Returns the i-th edge of the element.
virtual const Element *	getFace (unsigned i) const =0
	Returns the i-th face of the element.
virtual const Element *	getBoundary (unsigned i) const =0
std::size_t	getID () const
	Returns the ID of the element.
virtual unsigned	getNumberOfBoundaries () const =0
virtual unsigned	getNumberOfEdges () const =0
	Get the number of edges for this element.
virtual unsigned	getNumberOfFaces () const =0
	Get the number of faces for this element.
virtual const Element *	getNeighbor (unsigned i) const =0
	Get the specified neighbor.
virtual unsigned	getNumberOfNeighbors () const =0
	Get the number of neighbors for this element.
virtual unsigned	getNumberOfBaseNodes () const =0
virtual unsigned	getNumberOfNodes () const =0
virtual MeshElemType	getGeomType () const =0
virtual CellType	getCellType () const =0
virtual bool	isBoundaryElement () const
virtual bool	isEdge (unsigned i, unsigned j) const =0
	Returns true if these two indices form an edge and false otherwise.
virtual bool	isPntInElement (MathLib::Point3d const &pnt, double eps=std::numeric_limits< double >::epsilon()) const =0
virtual ElementErrorCode	validate () const =0
virtual	~Element ()
	Destructor.
virtual Element *	clone () const =0
virtual Element *	clone (Node **nodes, std::size_t id) const =0
virtual double	computeVolume ()=0
virtual unsigned	identifyFace (Node const *nodes[3]) const =0
	Returns the ID of a face given an array of nodes.
virtual bool	testElementNodeOrder () const =0
virtual Node *	getEdgeNode (unsigned edge_id, unsigned node_id) const =0
	Return a specific edge node.

Public Attributes
unsigned	space_dimension_ = 3u
	Dimension of the space, where the element exists.

Protected Member Functions
	Element (std::size_t id)
void	setID (std::size_t id)
	Sets the element ID.
void	setNeighbor (Element *neighbor, unsigned const face_id)

Protected Attributes
std::size_t	_id
Element **	_neighbors

Friends
class	Mesh
std::ostream &	operator<< (std::ostream &os, Element const &e)

Constructor & Destructor Documentation

~Element()

MeshLib::Element::~Element ( )

virtual

Destructor.

Definition at line 27 of file Element.cpp.

{
    delete[] this->_neighbors;
}

References _neighbors.

Element()

MeshLib::Element::Element ( std::size_t id )

explicitprotected

Constructor for a generic mesh element without an array of mesh nodes.

Parameters

id	element id

Definition at line 25 of file Element.cpp.

: _id(id), _neighbors(nullptr) {}

Member Function Documentation

addNeighbor()

std::optional< unsigned > MeshLib::Element::addNeighbor

(

Element *

e

)

Tries to add an element e as neighbour to this element. If the elements really are neighbours, the element is added to the neighbour-list and the face id of the neighbour connected to this element is returned. Otherwise the maximum value of the value type is returned.

Definition at line 42 of file Element.cpp.

{
    const unsigned dim(this->getDimension());
    if (e == this || e == nullptr || e->getDimension() != dim)
    {
        return std::optional<unsigned>();
    }
 
    if (areNeighbors(this, e))
    {
        return std::optional<unsigned>();
    }
 
    Node const* face_nodes[3];
    const unsigned nNodes(this->getNumberOfBaseNodes());
    const unsigned eNodes(e->getNumberOfBaseNodes());
    const Node* const* e_nodes = e->getNodes();
    unsigned count(0);
    for (unsigned i(0); i < nNodes; i++)
    {
        for (unsigned j(0); j < eNodes; j++)
        {
            if (getNode(i) == e_nodes[j])
            {
                face_nodes[count] = getNode(i);
                // increment shared nodes counter and check if enough nodes are
                // similar to be sure e is a neighbour of this
                if ((++count) >= dim)
                {
                    auto const this_face_id = this->identifyFace(face_nodes);
                    if (this_face_id == std::numeric_limits<unsigned>::max())
                    {
                        OGS_FATAL(
                            "Could not find face of {} for the face nodes [{}, "
                            "{}, {}].",
                            *this, *face_nodes[0], *face_nodes[1],
                            *face_nodes[2]);
                    }
                    _neighbors[this_face_id] = e;
                    auto const neighbors_face_id = e->identifyFace(face_nodes);
                    if (neighbors_face_id ==
                        std::numeric_limits<unsigned>::max())
                    {
                        OGS_FATAL(
                            "Could not find face of the neighbour {} for the "
                            "face nodes [{}, {}, {}].\n"
                            "For the {} the face id {} was identified.",
                            *e, *face_nodes[0], *face_nodes[1], *face_nodes[2],
                            *this, this_face_id);
                    }
                    return neighbors_face_id;
                }
            }
        }
    }
 
    return std::optional<unsigned>();
}

References _neighbors, MeshLib::areNeighbors(), getDimension(), getNode(), getNodes(), getNumberOfBaseNodes(), identifyFace(), and OGS_FATAL.

clone() [1/2]

virtual Element * MeshLib::Element::clone ( ) const

pure virtual

Method clone is a pure virtual method in the abstract base class Element. It has to be implemented in the derived classes (for instance in class Hex).

Returns

an exact copy of the object

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::cloneElements().

clone() [2/2]

virtual Element * MeshLib::Element::clone ( Node ** nodes, std::size_t id ) const

pure virtual

Constructs a new object polymorphically. This is similar to clone, but accepts new nodes and id.

Precondition

The length of the nodes vector is equal to the derived element's total number of nodes.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

computeVolume()

virtual double MeshLib::Element::computeVolume ( )

pure virtual

Computes the length / area / volumen of this element. This is automatically done at initialisation time but can be repeated by calling this function at any time.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

getBoundary()

virtual const Element * MeshLib::Element::getBoundary ( unsigned i ) const

pure virtual

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshToolsLib::createSurfaceElementsFromElement().

getCellType()

virtual CellType MeshLib::Element::getCellType ( ) const

pure virtual

Get the type of the element in context of the finite element method.

Returns

a value of the enum FEMElemType::type

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::calculateNormalizedSurfaceNormal(), MeshToolsLib::computeElementVolumeNumerically(), ProcessLib::computeShapeMatrix(), MeshLib::copyElement(), createQuadraticElement(), MeshLib::getBulkElementPoint(), ApplicationUtils::getElementIntegerVariables(), and MeshToolsLib::getNumberOfElementIntegrationPoints().

getContent()

virtual double MeshLib::Element::getContent ( ) const

pure virtual

Returns the length, area or volume of a 1D, 2D or 3D element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshToolsLib::SizeDifferenceMetric::calculateQuality(), MeshLib::hasZeroVolume(), and ElementTreeModel::setElement().

getDimension()

virtual constexpr unsigned MeshLib::Element::getDimension ( ) const

constexprpure virtual

Get dimension of the mesh element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::CoordinateSystem::CoordinateSystem(), MeshLib::ElementCoordinatesMappingLocal::ElementCoordinatesMappingLocal(), ProcessLib::HeatTransportBHE::HeatTransportBHELocalAssemblerBHE< ShapeFunction, BHEType >::HeatTransportBHELocalAssemblerBHE(), ProcessLib::LIE::HydroMechanics::HydroMechanicsLocalAssemblerFracture< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::HydroMechanicsLocalAssemblerFracture(), ProcessLib::LiquidFlow::LiquidFlowLocalAssembler< ShapeFunction, GlobalDim >::LiquidFlowLocalAssembler(), ProcessLib::LIE::SmallDeformation::SmallDeformationLocalAssemblerFracture< ShapeFunction, DisplacementDim >::SmallDeformationLocalAssemblerFracture(), addNeighbor(), MeshToolsLib::ElementSizeMetric::calc2dOr3dQuality(), MeshLib::calculateNormalizedSurfaceNormal(), MeshToolsLib::SizeDifferenceMetric::calculateQuality(), NumLib::detail::computeMappingMatrices(), ProcessLib::computeShapeMatrix(), MeshToolsLib::createFlippedElement(), ProcessLib::LIE::HydroMechanics::createHydroMechanicsProcess(), MeshToolsLib::MeshLayerMapper::createStaticLayers(), anonymous_namespace{MeshUtils.cpp}::extractOneDimensionalElements(), MeshToolsLib::extrudeElement(), ProcessLib::HeatTransportBHE::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataSoil, LocalAssemblerDataBHE, ConstructorArgs >::makeLocalAssemblerBuilder(), ProcessLib::LIE::HydroMechanics::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataMatrix, LocalAssemblerDataMatrixNearFracture, LocalAssemblerDataFracture, DisplacementDim, ConstructorArgs >::makeLocalAssemblerBuilder(), ProcessLib::LIE::SmallDeformation::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataMatrix, LocalAssemblerDataMatrixNearFracture, LocalAssemblerDataFracture, DisplacementDim, ConstructorArgs >::makeLocalAssemblerBuilder(), ProcessLib::LIE::SmallDeformation::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataMatrix, LocalAssemblerDataMatrixNearFracture, LocalAssemblerDataFracture, DisplacementDim, ConstructorArgs >::operator()(), and MeshToolsLib::MeshRevision::simplifyMesh().

getEdge()

virtual const Element * MeshLib::Element::getEdge ( unsigned i ) const

pure virtual

Returns the i-th edge of the element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshGeoToolsLib::computeElementSegmentIntersections(), and MeshLib::FaceRule::getFace().

getEdgeNode()

virtual Node * MeshLib::Element::getEdgeNode ( unsigned edge_id, unsigned node_id ) const

pure virtual

Return a specific edge node.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::computeSqrEdgeLengthRange(), convertLinearToQuadratic(), MeshLib::LinearEdgeReturn::getEdge(), and MeshLib::QuadraticEdgeReturn::getEdge().

getFace()

virtual const Element * MeshLib::Element::getFace ( unsigned i ) const

pure virtual

Returns the i-th face of the element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshToolsLib::anonymous_namespace{AngleSkewMetric.cpp}::checkHexahedron(), MeshToolsLib::anonymous_namespace{AngleSkewMetric.cpp}::checkPrism(), MeshToolsLib::anonymous_namespace{AngleSkewMetric.cpp}::checkTetrahedron(), anonymous_namespace{MeshRevision.cpp}::reduceHex(), MeshLib::CellRule::testElementNodeOrder(), MeshLib::HexRule::validate(), MeshLib::PrismRule::validate(), and MeshLib::PyramidRule::validate().

getGeomType()

virtual MeshElemType MeshLib::Element::getGeomType ( ) const

pure virtual

Get the type of the mesh element in geometric context (as a MeshElemType-enum).

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by ProcessLib::NormalTractionBoundaryCondition::NormalTractionBoundaryConditionLocalAssembler< ShapeFunctionDisplacement, GlobalDim >::NormalTractionBoundaryConditionLocalAssembler(), anonymous_namespace{convertMeshToGeo.cpp}::addElementToSurface(), MeshToolsLib::MeshLayerMapper::addLayerToMesh(), MeshToolsLib::createFlippedElement(), MeshToolsLib::MeshLayerMapper::createStaticLayers(), MeshToolsLib::extrudeElement(), MeshToolsLib::MeshSurfaceExtraction::getSurfaceAreaForNodes(), ProcessLib::SurfaceFluxLocalAssembler< ShapeFunction, GlobalDim >::getSurfaceNormal(), MeshToolsLib::Mesh2MeshPropertyInterpolation::interpolatePropertiesForMesh(), MeshLib::isPointInElementXY(), anonymous_namespace{MeshRevision.cpp}::reduceElement(), anonymous_namespace{MeshRevision.cpp}::reduceHex(), ElementTreeModel::setElement(), anonymous_namespace{MeshRevision.cpp}::subdivideElement(), and FileIO::TetGenInterface::writeElementToFacets().

getID()

std::size_t MeshLib::Element::getID ( ) const

inline

Returns the ID of the element.

Definition at line 91 of file Element.h.

{ return _id; }

References _id.

Referenced by ProcessLib::ConstraintDirichletBoundaryConditionLocalAssembler< ShapeFunction, GlobalDim >::ConstraintDirichletBoundaryConditionLocalAssembler(), ProcessLib::HMPhaseField::HMPhaseFieldLocalAssembler< ShapeFunction, DisplacementDim >::HMPhaseFieldLocalAssembler(), ProcessLib::HT::HTFEM< ShapeFunction, GlobalDim >::HTFEM(), ProcessLib::HydroMechanics::HydroMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::HydroMechanicsLocalAssembler(), ProcessLib::LIE::HydroMechanics::HydroMechanicsLocalAssemblerFracture< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::HydroMechanicsLocalAssemblerFracture(), ProcessLib::LIE::HydroMechanics::HydroMechanicsLocalAssemblerMatrix< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::HydroMechanicsLocalAssemblerMatrix(), ProcessLib::LIE::HydroMechanics::HydroMechanicsLocalAssemblerMatrixNearFracture< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::HydroMechanicsLocalAssemblerMatrixNearFracture(), ProcessLib::LiquidFlow::LiquidFlowLocalAssembler< ShapeFunction, GlobalDim >::LiquidFlowLocalAssembler(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::LocalAssemblerData(), ProcessLib::PhaseField::PhaseFieldLocalAssembler< ShapeFunction, DisplacementDim >::PhaseFieldLocalAssembler(), ProcessLib::LIE::SmallDeformation::SmallDeformationLocalAssemblerFracture< ShapeFunction, DisplacementDim >::SmallDeformationLocalAssemblerFracture(), ProcessLib::LIE::SmallDeformation::SmallDeformationLocalAssemblerMatrix< ShapeFunction, DisplacementDim >::SmallDeformationLocalAssemblerMatrix(), ProcessLib::LIE::SmallDeformation::SmallDeformationLocalAssemblerMatrixNearFracture< ShapeFunction, DisplacementDim >::SmallDeformationLocalAssemblerMatrixNearFracture(), ProcessLib::ThermoHydroMechanics::ThermoHydroMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::ThermoHydroMechanicsLocalAssembler(), ProcessLib::ThermoMechanics::ThermoMechanicsLocalAssembler< ShapeFunction, DisplacementDim >::ThermoMechanicsLocalAssembler(), ProcessLib::ThermoRichardsFlow::ThermoRichardsFlowLocalAssembler< ShapeFunction, GlobalDim >::ThermoRichardsFlowLocalAssembler(), ProcessLib::WellboreSimulator::WellboreSimulatorFEM< ShapeFunction, GlobalDim >::WellboreSimulatorFEM(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assemble(), ProcessLib::HCNonAdvectiveFreeComponentFlowBoundaryConditionLocalAssembler< ShapeFunction, GlobalDim >::assemble(), ProcessLib::HeatConduction::LocalAssemblerData< ShapeFunction, GlobalDim >::assemble(), ProcessLib::HT::MonolithicHTFEM< ShapeFunction, GlobalDim >::assemble(), ProcessLib::NeumannBoundaryConditionLocalAssembler< ShapeFunction, GlobalDim >::assemble(), ProcessLib::RichardsFlow::LocalAssemblerData< ShapeFunction, GlobalDim >::assemble(), ProcessLib::RobinBoundaryConditionLocalAssembler< ShapeFunction, GlobalDim >::assemble(), ProcessLib::SteadyStateDiffusion::LocalAssemblerData< ShapeFunction, GlobalDim >::assemble(), ProcessLib::WellboreCompensateNeumannBoundaryConditionLocalAssembler< ShapeFunction, GlobalDim >::assemble(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleBlockMatrices(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleComponentTransportEquation(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleHeatTransportEquation(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleHydraulicEquation(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleKCmCn(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleReactionEquationConcrete(), ProcessLib::HeatConduction::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleWithJacobian(), ProcessLib::LargeDeformation::LargeDeformationLocalAssembler< ShapeFunction, DisplacementDim >::assembleWithJacobian(), ProcessLib::SmallDeformation::SmallDeformationLocalAssembler< ShapeFunction, DisplacementDim >::assembleWithJacobian(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleWithJacobianComponentTransportEquation(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::assembleWithJacobianHydraulicEquation(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::calculateIntPtDarcyVelocity(), NumLib::detail::checkJacobianDeterminant(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::computeSecondaryVariableConcrete(), ProcessLib::SmallDeformation::SmallDeformationLocalAssemblerInterface< DisplacementDim >::computeSecondaryVariableConcrete(), ProcessLib::WellboreSimulator::WellboreSimulatorFEM< ShapeFunction, GlobalDim >::computeSecondaryVariableConcrete(), convertLinearToQuadratic(), MeshToolsLib::createFlippedElement(), MeshGeoToolsLib::createSubSegmentsForElement(), MeshToolsLib::createSurfaceElementsFromElement(), MeshLib::findElementsWithinRadius(), ProcessLib::HeatTransportBHE::getBHEDataInMesh(), MeshLib::LinearEdgeReturn::getEdge(), MeshLib::QuadraticEdgeReturn::getEdge(), MeshLib::HexRule20::getFace(), MeshLib::HexRule8::getFace(), MeshLib::PrismRule15::getFace(), MeshLib::PrismRule6::getFace(), MeshLib::PyramidRule13::getFace(), MeshLib::PyramidRule5::getFace(), MeshLib::TetRule10::getFace(), MeshLib::TetRule4::getFace(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::getFlux(), ProcessLib::HT::HTFEM< ShapeFunction, GlobalDim >::getFlux(), ProcessLib::SteadyStateDiffusion::LocalAssemblerData< ShapeFunction, GlobalDim >::getFlux(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::getHeatEnergyCoefficient(), ProcessLib::HT::HTFEM< ShapeFunction, GlobalDim >::getHeatEnergyCoefficient(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::getIntPtDarcyVelocity(), ProcessLib::HT::MonolithicHTFEM< ShapeFunction, GlobalDim >::getIntPtDarcyVelocity(), ProcessLib::RichardsFlow::LocalAssemblerData< ShapeFunction, GlobalDim >::getIntPtDarcyVelocity(), ProcessLib::SteadyStateDiffusion::LocalAssemblerData< ShapeFunction, GlobalDim >::getIntPtDarcyVelocity(), ProcessLib::HT::HTFEM< ShapeFunction, GlobalDim >::getIntPtDarcyVelocityLocal(), ProcessLib::HeatConduction::LocalAssemblerData< ShapeFunction, GlobalDim >::getIntPtHeatFlux(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::getIntPtMolarFlux(), ProcessLib::LargeDeformation::LargeDeformationLocalAssemblerInterface< DisplacementDim >::getMaterialID(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::getMaterialID(), ProcessLib::SmallDeformation::SmallDeformationLocalAssemblerInterface< DisplacementDim >::getMaterialID(), ProcessLib::TH2M::LocalAssemblerInterface< DisplacementDim >::getMaterialID(), ProcessLib::ThermoHydroMechanics::ThermoHydroMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::getMaterialID(), ProcessLib::ThermoRichardsMechanics::LocalAssemblerInterface< DisplacementDim, ConstitutiveTraits >::getMaterialID(), ParameterLib::MeshElementParameter< T >::getNodalValuesOnElement(), ParameterLib::Parameter< T >::getNodalValuesOnElement(), ParameterLib::RandomFieldMeshElementParameter< T >::getNodalValuesOnElement(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::getThermalConductivityDispersivity(), ProcessLib::HT::HTFEM< ShapeFunction, GlobalDim >::getThermalConductivityDispersivity(), anonymous_namespace{MeshUtils.cpp}::getUniqueMaterialIds(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::initializeChemicalSystemConcrete(), ProcessLib::HMPhaseField::HMPhaseFieldLocalAssembler< ShapeFunction, DisplacementDim >::initializeConcrete(), ProcessLib::HydroMechanics::HydroMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::initializeConcrete(), ProcessLib::LargeDeformation::LargeDeformationLocalAssembler< ShapeFunction, DisplacementDim >::initializeConcrete(), ProcessLib::PhaseField::PhaseFieldLocalAssembler< ShapeFunction, DisplacementDim >::initializeConcrete(), ProcessLib::RichardsMechanics::RichardsMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::initializeConcrete(), ProcessLib::SmallDeformation::SmallDeformationLocalAssembler< ShapeFunction, DisplacementDim >::initializeConcrete(), ProcessLib::TH2M::TH2MLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::initializeConcrete(), ProcessLib::ThermoHydroMechanics::ThermoHydroMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::initializeConcrete(), ProcessLib::ThermoMechanics::ThermoMechanicsLocalAssembler< ShapeFunction, DisplacementDim >::initializeConcrete(), ProcessLib::ThermoRichardsMechanics::ThermoRichardsMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunction, DisplacementDim, ConstitutiveTraits >::initializeConcrete(), ProcessLib::VolumetricSourceTermLocalAssembler< ShapeFunction, GlobalDim >::integrate(), ProcessLib::DeactivatedSubdomain::isDeactivated(), ProcessLib::HeatTransportBHE::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataSoil, LocalAssemblerDataBHE, ConstructorArgs >::makeLocalAssemblerBuilderBHE(), ProcessLib::LargeDeformation::LargeDeformationLocalAssembler< ShapeFunction, DisplacementDim >::postTimestepConcrete(), ProcessLib::SmallDeformation::SmallDeformationLocalAssembler< ShapeFunction, DisplacementDim >::postTimestepConcrete(), ProcessLib::ThermoHydroMechanics::ThermoHydroMechanicsLocalAssembler< ShapeFunctionDisplacement, ShapeFunctionPressure, DisplacementDim >::postTimestepConcrete(), MeshLib::ElementSearch::searchByNodeIDs(), ProcessLib::ComponentTransport::LocalAssemblerData< ShapeFunction, GlobalDim >::setChemicalSystemConcrete(), ElementTreeModel::setElement(), ProcessLib::LIE::setFractureProperty(), ProcessLib::SmallDeformation::SmallDeformationLocalAssembler< ShapeFunction, DisplacementDim >::setInitialConditionsConcrete(), ProcessLib::LargeDeformation::LargeDeformationLocalAssemblerInterface< DisplacementDim >::setIPDataInitialConditions(), ProcessLib::RichardsMechanics::LocalAssemblerInterface< DisplacementDim >::setIPDataInitialConditions(), ProcessLib::SmallDeformation::SmallDeformationLocalAssemblerInterface< DisplacementDim >::setIPDataInitialConditions(), ProcessLib::ThermoRichardsMechanics::LocalAssemblerInterface< DisplacementDim, ConstitutiveTraits >::setIPDataInitialConditions(), MeshToolsLib::trackSurface(), ProcessLib::LIE::HydroMechanics::HydroMechanicsProcess< DisplacementDim >::updateElementLevelSets(), ProcessLib::LIE::SmallDeformation::SmallDeformationProcess< DisplacementDim >::updateElementLevelSets(), and FileIO::TetGenInterface::write3dElements().

getNeighbor()

virtual const Element * MeshLib::Element::getNeighbor ( unsigned i ) const

pure virtual

Get the specified neighbor.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::areNeighbors(), MeshToolsLib::SizeDifferenceMetric::calculateQuality(), MeshToolsLib::createSurfaceElementsFromElement(), and MeshToolsLib::trackSurface().

getNode() [1/2]

virtual const Node * MeshLib::Element::getNode ( unsigned idx ) const

pure virtual

Get node with local index where the local index should be at most the number of nodes of the element.

Parameters

idx	local index of node, at most the number of nodes of the element that you can obtain with Element::getNumberOfBaseNodes()

Returns

a pointer to the appropriate (and constant, i.e. not modifiable by the user) instance of class Node or a nullptr

See also

getNodeIndex()

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::ElementCoordinatesMappingLocal::ElementCoordinatesMappingLocal(), ProcessLib::HeatTransportBHE::HeatTransportBHELocalAssemblerBHE< ShapeFunction, BHEType >::HeatTransportBHELocalAssemblerBHE(), ProcessLib::NormalTractionBoundaryCondition::NormalTractionBoundaryConditionLocalAssembler< ShapeFunctionDisplacement, GlobalDim >::NormalTractionBoundaryConditionLocalAssembler(), ProcessLib::WellboreSimulator::WellboreSimulatorFEM< ShapeFunction, GlobalDim >::WellboreSimulatorFEM(), MeshToolsLib::MeshGenerator::AddFaultToVoxelGrid::addFaultToVoxelGrid(), addNeighbor(), MeshLib::calculateNormalizedSurfaceNormal(), MeshToolsLib::anonymous_namespace{AngleSkewMetric.cpp}::checkQuad(), MeshToolsLib::anonymous_namespace{AngleSkewMetric.cpp}::checkTriangle(), anonymous_namespace{CollectAndInterpolateNodalDof.cpp}::collectDofsToMatrixSingleComponentForSomeNodes(), ProcessLib::LIE::computePhysicalCoordinates(), MeshLib::computeSqrNodeDistanceRange(), anonymous_namespace{MeshRevision.cpp}::constructFourNodeElement(), anonymous_namespace{MeshRevision.cpp}::constructLine(), anonymous_namespace{MeshRevision.cpp}::constructTri(), convertLinearToQuadratic(), MeshLib::copyElement(), MeshToolsLib::createFlippedElement(), FileIO::SHPInterface::createShapeObject(), MeshToolsLib::MeshLayerMapper::createStaticLayers(), MeshToolsLib::extrudeElement(), MeshLib::findElementsWithinRadius(), anonymous_namespace{MeshRevision.cpp}::findPyramidTopNode(), MeshLib::getCenterOfGravity(), ApplicationUtils::getElementIntegerVariables(), MeshToolsLib::ProjectPointOnMesh::getElevation(), MeshLib::HexRule20::getFace(), MeshLib::HexRule8::getFace(), MeshLib::PrismRule15::getFace(), MeshLib::PrismRule6::getFace(), MeshLib::PyramidRule13::getFace(), MeshLib::PyramidRule5::getFace(), MeshLib::TetRule10::getFace(), MeshLib::TetRule4::getFace(), MeshLib::FaceRule::getFirstSurfaceVector(), ApplicationUtils::ComputeNaturalCoordsRootFindingProblem< ShapeFunction >::getNodeCoords(), MeshLib::getNodeIDinElement(), MeshLib::getNodeIndex(), anonymous_namespace{MeshRevision.cpp}::getNumberOfUniqueNodes(), MeshLib::FaceRule::getSecondSurfaceVector(), ProcessLib::SurfaceFluxLocalAssembler< ShapeFunction, GlobalDim >::getSurfaceNormal(), MeshLib::isPointInElementXY(), MeshGeoToolsLib::mapPointOnSurfaceElement(), anonymous_namespace{MeshRevision.cpp}::reduceHex(), anonymous_namespace{MeshRevision.cpp}::reducePrism(), ElementTreeModel::setElement(), MeshGeoToolsLib::snapPointToElementNode(), MeshLib::MeshElementGrid::sortElementInGridCells(), and MeshLib::CellRule::testElementNodeOrder().

getNode() [2/2]

virtual Node * MeshLib::Element::getNode ( unsigned idx )

pure virtual

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

getNodes()

virtual Node *const * MeshLib::Element::getNodes ( ) const

pure virtual

Get array of element nodes.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::CoordinateSystem::CoordinateSystem(), addNeighbor(), MeshToolsLib::RadiusEdgeRatioMetric::calculateQuality(), MeshToolsLib::anonymous_namespace{ConvertToLinearMesh.cpp}::createLinearElement(), ParameterLib::MeshNodeParameter< T >::getNodalValuesOnElement(), ParameterLib::Parameter< T >::getNodalValuesOnElement(), ParameterLib::RasterParameter::getNodalValuesOnElement(), NumLib::TemplateIsoparametric< ShapeFunctionType_, ShapeMatrixTypes_ >::interpolateCoordinates(), MeshToolsLib::Mesh2MeshPropertyInterpolation::interpolatePropertiesForMesh(), NumLib::TemplateIsoparametric< ShapeFunctionType_, ShapeMatrixTypes_ >::interpolateZerothCoordinate(), FileIO::Gocad::GocadSGridReader::modifyElement(), nodes(), and MeshLib::QuadRule::validate().

getNumberOfBaseNodes()

virtual unsigned MeshLib::Element::getNumberOfBaseNodes ( ) const

pure virtual

Returns the number of linear nodes.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by addNeighbor(), MeshToolsLib::RadiusEdgeRatioMetric::calculateQuality(), ProcessLib::BoundaryConditionAndSourceTerm::Python::collectDofsToMatrixOnBaseNodesSingleComponent(), MeshLib::computeSqrNodeDistanceRange(), anonymous_namespace{MeshRevision.cpp}::constructFourNodeElement(), anonymous_namespace{MeshRevision.cpp}::constructLine(), anonymous_namespace{MeshRevision.cpp}::constructTri(), convertLinearToQuadratic(), FileIO::SHPInterface::createShapeObject(), MeshToolsLib::MeshLayerMapper::createStaticLayers(), MeshToolsLib::extrudeElement(), anonymous_namespace{MeshRevision.cpp}::findPyramidTopNode(), MeshLib::getCenterOfGravity(), anonymous_namespace{MeshRevision.cpp}::getNumberOfUniqueNodes(), MeshLib::Mesh::hasNonlinearElement(), anonymous_namespace{BoundaryElementsAlongPolyline.cpp}::includesAllEdgeNodeIDs(), MeshToolsLib::Mesh2MeshPropertyInterpolation::interpolatePropertiesForMesh(), NumLib::interpolateToHigherOrderNodes(), MeshLib::isPointInElementXY(), ProcessLib::LIE::HydroMechanics::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataMatrix, LocalAssemblerDataMatrixNearFracture, LocalAssemblerDataFracture, DisplacementDim, ConstructorArgs >::operator()(), LayeredVolume::removeCongruentElements(), ElementTreeModel::setElement(), FileIO::FEFLOWMeshInterface::setMaterialIDs(), and MeshToolsLib::MeshRevision::simplifyMesh().

getNumberOfBoundaries()

virtual unsigned MeshLib::Element::getNumberOfBoundaries ( ) const

pure virtual

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshToolsLib::createSurfaceElementsFromElement().

getNumberOfEdges()

virtual unsigned MeshLib::Element::getNumberOfEdges ( ) const

pure virtual

Get the number of edges for this element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshGeoToolsLib::computeElementSegmentIntersections(), MeshLib::computeSqrEdgeLengthRange(), and convertLinearToQuadratic().

getNumberOfFaces()

virtual unsigned MeshLib::Element::getNumberOfFaces ( ) const

pure virtual

Get the number of faces for this element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::CellRule::testElementNodeOrder().

getNumberOfNeighbors()

virtual unsigned MeshLib::Element::getNumberOfNeighbors ( ) const

pure virtual

Get the number of neighbors for this element.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::areNeighbors(), MeshToolsLib::SizeDifferenceMetric::calculateQuality(), isBoundaryElement(), and MeshToolsLib::trackSurface().

getNumberOfNodes()

virtual unsigned MeshLib::Element::getNumberOfNodes ( ) const

pure virtual

Returns the number of all nodes including both linear and nonlinear nodes

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::CoordinateSystem::CoordinateSystem(), MeshLib::ElementCoordinatesMappingLocal::ElementCoordinatesMappingLocal(), ProcessLib::LIE::PostProcessTool::PostProcessTool(), ProcessLib::BoundaryConditionAndSourceTerm::Python::collectDofsToMatrix(), ProcessLib::LIE::computePhysicalCoordinates(), ProcessLib::computeShapeMatrix(), MeshLib::computeSqrNodeDistanceRange(), MeshLib::copyElement(), MeshToolsLib::createFlippedElement(), MeshLib::findElementsWithinRadius(), ApplicationUtils::getElementIntegerVariables(), ParameterLib::ConstantParameter< T >::getNodalValuesOnElement(), ParameterLib::MeshElementParameter< T >::getNodalValuesOnElement(), ParameterLib::MeshNodeParameter< T >::getNodalValuesOnElement(), ParameterLib::Parameter< T >::getNodalValuesOnElement(), ParameterLib::RandomFieldMeshElementParameter< T >::getNodalValuesOnElement(), ParameterLib::RasterParameter::getNodalValuesOnElement(), MeshLib::getNodeIDinElement(), MeshLib::getNodeIndex(), MeshLib::Mesh::hasNonlinearElement(), NumLib::interpolateToHigherOrderNodes(), nodes(), ProcessLib::LIE::HydroMechanics::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataMatrix, LocalAssemblerDataMatrixNearFracture, LocalAssemblerDataFracture, DisplacementDim, ConstructorArgs >::operator()(), ProcessLib::LIE::SmallDeformation::LocalDataInitializer< LocalAssemblerInterface, LocalAssemblerDataMatrix, LocalAssemblerDataMatrixNearFracture, LocalAssemblerDataFracture, DisplacementDim, ConstructorArgs >::operator()(), MeshLib::VtkMappedMeshSource::RequestData(), MeshGeoToolsLib::snapPointToElementNode(), and MeshLib::MeshElementGrid::sortElementInGridCells().

identifyFace()

virtual unsigned MeshLib::Element::identifyFace ( Node const * nodes[3] ) const

pure virtual

Returns the ID of a face given an array of nodes.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by addNeighbor().

isBoundaryElement()

bool MeshLib::Element::isBoundaryElement ( ) const

virtual

Returns true if the element is located at a boundary (i.e. has at least one face without neighbour)

Definition at line 101 of file Element.cpp.

{
    return std::any_of(_neighbors, _neighbors + this->getNumberOfNeighbors(),
                       [](MeshLib::Element const* const e)
                       { return e == nullptr; });
}

References _neighbors, and getNumberOfNeighbors().

isEdge()

virtual bool MeshLib::Element::isEdge ( unsigned i, unsigned j ) const

pure virtual

Returns true if these two indices form an edge and false otherwise.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by anonymous_namespace{MeshRevision.cpp}::reduceHex().

isPntInElement()

virtual bool MeshLib::Element::isPntInElement ( MathLib::Point3d const & pnt, double eps = std::numeric_limits< double >::epsilon() ) const

pure virtual

Checks if a point is inside the element.

Parameters

pnt	a 3D MathLib::Point3d object
eps	tolerance for numerical algorithm used or computing the property

Returns

true if the point is not outside the element, false otherwise

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

nodes()

std::span< Node *const > MeshLib::Element::nodes ( ) const

inlineconstexpr

Span of element's nodes, their pointers actually.

Definition at line 74 of file Element.h.

    {
        return {getNodes(), getNumberOfNodes()};
    }

References getNodes(), and getNumberOfNodes().

Referenced by MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement(), MeshLib::TemplateElement< ELEMENT_RULE >::clone(), ApplicationUtils::computePartitionIDPerElement(), anonymous_namespace{MeshRevision.cpp}::constructLine(), ProcessLib::EmbeddedAnchor< GlobalDim >::getShapeMatricesAndGlobalIndicesAndDisplacements(), MeshLib::TemplateElement< ELEMENT_RULE >::identifyFace(), anonymous_namespace{MeshRevision.cpp}::reduceHex(), anonymous_namespace{MeshRevision.cpp}::reducePrism(), anonymous_namespace{MeshRevision.cpp}::subdivideHex(), anonymous_namespace{MeshRevision.cpp}::subdividePrism(), anonymous_namespace{MeshRevision.cpp}::subdividePyramid(), and anonymous_namespace{MeshRevision.cpp}::subdivideQuad().

setID()

void MeshLib::Element::setID ( std::size_t id )

inlineprotected

Sets the element ID.

Definition at line 200 of file Element.h.

{ _id = id; }

References _id.

setNeighbor()

void MeshLib::Element::setNeighbor ( Element * neighbor, unsigned const face_id )

protected

Sets the neighbor over the face with face_id to the given neighbor.

Definition at line 32 of file Element.cpp.

{
    if (neighbor == this)
    {
        return;
    }
 
    this->_neighbors[face_id] = neighbor;
}

References _neighbors.

Referenced by MeshLib::Mesh::setElementNeighbors().

setNode()

virtual void MeshLib::Element::setNode ( unsigned idx, Node * node )

pure virtual

(Re)Sets the node of the element.

Parameters

idx	the index of the pointer to a node within the element
node	a pointer to a node

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by ProcessLib::LIE::PostProcessTool::PostProcessTool(), and LayeredVolume::removeCongruentElements().

testElementNodeOrder()

virtual bool MeshLib::Element::testElementNodeOrder ( ) const

pure virtual

Checks if the node order of an element is correct by testing surface normals.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by MeshLib::HexRule::validate(), MeshLib::PrismRule::validate(), MeshLib::PyramidRule::validate(), MeshLib::QuadRule::validate(), MeshLib::TetRule::validate(), and MeshLib::TriRule::validate().

validate()

virtual ElementErrorCode MeshLib::Element::validate ( ) const

pure virtual

Tests if the element is geometrically valid.

Implemented in MeshLib::TemplateElement< ELEMENT_RULE >.

Referenced by anonymous_namespace{MeshRevision.cpp}::constructFourNodeElement(), MeshToolsLib::MeshRevision::simplifyMesh(), and MeshLib::HexRule::validate().

Friends And Related Symbol Documentation

Mesh

friend class Mesh

friend

Definition at line 37 of file Element.h.

operator<<

std::ostream & operator<< ( std::ostream & os, Element const & e )

friend

Definition at line 108 of file Element.cpp.

{
    os << "element #" << e._id << " @ " << &e << " with "
       << e.getNumberOfNeighbors() << " neighbours\n";
 
    unsigned const nnodes = e.getNumberOfNodes();
    MeshLib::Node* const* const nodes = e.getNodes();
    os << "MeshElemType: " << MeshLib::MeshElemType2String(e.getGeomType())
       << " with " << nnodes << " nodes: {\n";
    for (unsigned n = 0; n < nnodes; ++n)
    {
        os << "  " << *nodes[n] << " @ " << nodes[n] << '\n';
    }
    return os << '}';
}

Member Data Documentation

_id

std::size_t MeshLib::Element::_id

protected

Definition at line 202 of file Element.h.

Referenced by getID(), and setID().

_neighbors

Element** MeshLib::Element::_neighbors

protected

Definition at line 204 of file Element.h.

Referenced by MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement(), MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement(), MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement(), ~Element(), addNeighbor(), MeshLib::TemplateElement< ELEMENT_RULE >::getNeighbor(), isBoundaryElement(), and setNeighbor().

space_dimension_

unsigned MeshLib::Element::space_dimension_ = 3u

Dimension of the space, where the element exists.

Definition at line 192 of file Element.h.

Referenced by MeshLib::ElementCoordinatesMappingLocal::ElementCoordinatesMappingLocal(), MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement(), MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement(), and MeshLib::TemplateElement< ELEMENT_RULE >::TemplateElement().

---

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

• MeshLib/Elements/Element.h
• MeshLib/Elements/Element.cpp