libMesh
face_tri3.h
Go to the documentation of this file.
1 // The libMesh Finite Element Library.
2 // Copyright (C) 2002-2025 Benjamin S. Kirk, John W. Peterson, Roy H. Stogner
3 
4 // This library is free software; you can redistribute it and/or
5 // modify it under the terms of the GNU Lesser General Public
6 // License as published by the Free Software Foundation; either
7 // version 2.1 of the License, or (at your option) any later version.
8 
9 // This library is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 // Lesser General Public License for more details.
13 
14 // You should have received a copy of the GNU Lesser General Public
15 // License along with this library; if not, write to the Free Software
16 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 
18 
19 
20 #ifndef LIBMESH_FACE_TRI3_H
21 #define LIBMESH_FACE_TRI3_H
22 
23 
24 // Local includes
25 #include "libmesh/libmesh_common.h"
26 #include "libmesh/face_tri.h"
27 
28 // C++ includes
29 #include <cstddef>
30 
31 namespace libMesh
32 {
33 
61 class Tri3 : public Tri
62 {
63 public:
64 
68  explicit
69  Tri3 (Elem * p=nullptr) :
71 
72  Tri3 (Tri3 &&) = delete;
73  Tri3 (const Tri3 &) = delete;
74  Tri3 & operator= (const Tri3 &) = delete;
75  Tri3 & operator= (Tri3 &&) = delete;
76  virtual ~Tri3() = default;
77 
81  virtual ElemType type () const override { return TRI3; }
82 
86  virtual unsigned int n_sub_elem() const override { return 1; }
87 
91  virtual bool is_vertex(const unsigned int i) const override;
92 
96  virtual bool is_edge(const unsigned int i) const override;
97 
101  virtual bool is_face(const unsigned int i) const override;
102 
107  virtual bool is_node_on_side(const unsigned int n,
108  const unsigned int s) const override;
109 
110  virtual std::vector<unsigned int> nodes_on_side(const unsigned int s) const override;
111 
112  virtual std::vector<unsigned int> nodes_on_edge(const unsigned int e) const override;
113 
118  virtual bool is_node_on_edge(const unsigned int n,
119  const unsigned int e) const override
120  { return this->is_node_on_side(n,e); }
121 
126  virtual bool has_affine_map () const override { return true; }
127 
131  virtual bool has_invertible_map(Real tol) const override;
132 
137  virtual bool is_linear () const override { return true; }
138 
142  virtual Order default_order() const override;
143 
144  virtual std::unique_ptr<Elem> build_side_ptr (const unsigned int i) override;
145 
149  virtual void build_side_ptr (std::unique_ptr<Elem> & elem,
150  const unsigned int i) override;
151 
152  // Avoid hiding deprecated version with different signature
153  using Elem::build_side_ptr;
154 
155  virtual void connectivity(const unsigned int sf,
156  const IOPackage iop,
157  std::vector<dof_id_type> & conn) const override;
158 
162  static const int num_nodes = 3;
163  static const int nodes_per_side = 2;
164 
169  static const unsigned int side_nodes_map[num_sides][nodes_per_side];
170 
175  virtual Point true_centroid () const override;
176 
180  virtual Real volume () const override;
181 
187  std::pair<Real, Real> min_and_max_angle() const;
188 
193  virtual bool contains_point (const Point & p, Real tol) const override;
194 
198  virtual BoundingBox loose_bounding_box () const override;
199 
200  virtual void permute(unsigned int perm_num) override final;
201 
202  virtual void flip(BoundaryInfo *) override final;
203 
204  ElemType side_type (const unsigned int s) const override final;
205 
206 protected:
207 
212 
213 
214 
215 #ifdef LIBMESH_ENABLE_AMR
216 
220  virtual Real embedding_matrix (const unsigned int i,
221  const unsigned int j,
222  const unsigned int k) const override
223  { return _embedding_matrix[i][j][k]; }
224 
230 
232 
233 #endif // LIBMESH_ENABLE_AMR
234 
235 };
236 
237 } // namespace libMesh
238 
239 #endif // LIBMESH_FACE_TRI3_H
virtual bool is_node_on_edge(const unsigned int n, const unsigned int e) const override
Definition: face_tri3.h:118
The Tri3 is an element in 2D composed of 3 nodes.
Definition: face_tri3.h:61
ElemType
Defines an enum for geometric element types.
Node * _nodelinks_data[num_nodes]
Data for links to nodes.
Definition: face_tri3.h:211
Order
defines an enum for polynomial orders.
Definition: enum_order.h:40
A Node is like a Point, but with more information.
Definition: node.h:52
static const int num_nodes
Geometric constants for Tri3.
Definition: face_tri3.h:162
virtual unsigned int n_sub_elem() const override
Definition: face_tri3.h:86
static const int num_sides
Geometric constants for all Tris.
Definition: face_tri.h:86
static const unsigned int side_nodes_map[num_sides][nodes_per_side]
This maps the node of the side to element node numbers.
Definition: face_tri3.h:169
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i)=0
virtual Point true_centroid() const override
The centroid of a 3-node triangle is simply given by the average of its vertex positions.
Definition: face_tri3.C:186
virtual bool is_node_on_side(const unsigned int n, const unsigned int s) const override
Definition: face_tri3.C:101
IOPackage
libMesh interfaces with several different software packages for the purposes of creating, reading, and writing mesh files.
This is the base class from which all geometric element types are derived.
Definition: elem.h:94
The Tri is an element in 2D composed of 3 sides.
Definition: face_tri.h:47
std::pair< Real, Real > min_and_max_angle() const
Definition: face_tri3.C:200
virtual std::vector< unsigned int > nodes_on_side(const unsigned int s) const override
Definition: face_tri3.C:111
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i) override
Definition: face_tri3.C:133
virtual BoundingBox loose_bounding_box() const override
Builds a bounding box out of the nodal positions.
Definition: face_tri3.C:256
virtual bool has_invertible_map(Real tol) const override
Definition: face_tri3.C:128
The libMesh namespace provides an interface to certain functionality in the library.
static const int num_children
Definition: face_tri.h:87
virtual void connectivity(const unsigned int sf, const IOPackage iop, std::vector< dof_id_type > &conn) const override
Definition: face_tri3.C:148
virtual Real embedding_matrix(const unsigned int i, const unsigned int j, const unsigned int k) const override
Matrix used to create the elements children.
Definition: face_tri3.h:220
ElemType side_type(const unsigned int s) const override final
Definition: face_tri3.C:286
virtual bool is_edge(const unsigned int i) const override
Definition: face_tri3.C:91
virtual ElemType type() const override
Definition: face_tri3.h:81
The BoundaryInfo class contains information relevant to boundary conditions including storing faces...
Definition: boundary_info.h:57
virtual bool contains_point(const Point &p, Real tol) const override
Specialization for tri3 elements.
Definition: face_tri3.C:225
virtual bool is_linear() const override
Definition: face_tri3.h:137
LIBMESH_ENABLE_TOPOLOGY_CACHES
Definition: face_tri3.h:231
static const int nodes_per_side
Definition: face_tri3.h:163
Defines a Cartesian bounding box by the two corner extremum.
Definition: bounding_box.h:40
virtual bool is_vertex(const unsigned int i) const override
Definition: face_tri3.C:85
Tri3 & operator=(const Tri3 &)=delete
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
virtual void permute(unsigned int perm_num) override final
Permutes the element (by swapping node and neighbor pointers) according to the specified index...
Definition: face_tri3.C:262
virtual Order default_order() const override
Definition: face_tri3.C:123
static const Real _embedding_matrix[num_children][num_nodes][num_nodes]
Matrix that computes new nodal locations/solution values from current nodes/solution.
Definition: face_tri3.h:229
virtual bool has_affine_map() const override
Definition: face_tri3.h:126
virtual bool is_face(const unsigned int i) const override
Definition: face_tri3.C:96
virtual void flip(BoundaryInfo *) override final
Flips the element (by swapping node and neighbor pointers) to have a mapping Jacobian of opposite sig...
Definition: face_tri3.C:274
virtual ~Tri3()=default
virtual Real volume() const override
An optimized method for computing the area of a 3-node triangle.
Definition: face_tri3.C:191
A Point defines a location in LIBMESH_DIM dimensional Real space.
Definition: point.h:39
Tri3(Elem *p=nullptr)
Constructor.
Definition: face_tri3.h:69
virtual std::vector< unsigned int > nodes_on_edge(const unsigned int e) const override
Definition: face_tri3.C:118