libMesh
cell_tet10.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_CELL_TET10_H
21 #define LIBMESH_CELL_TET10_H
22 
23 // Local includes
24 #include "libmesh/cell_tet.h"
25 
26 namespace libMesh
27 {
28 
64 class Tet10 final : public Tet
65 {
66 public:
67 
71  explicit
72  Tet10 (Elem * p=nullptr) :
74  {}
75 
76  Tet10 (Tet10 &&) = delete;
77  Tet10 (const Tet10 &) = delete;
78  Tet10 & operator= (const Tet10 &) = delete;
79  Tet10 & operator= (Tet10 &&) = delete;
80  virtual ~Tet10() = default;
81 
85  virtual ElemType type () const override { return TET10; }
86 
90  virtual unsigned int n_nodes() const override { return num_nodes; }
91 
95  virtual unsigned int n_sub_elem() const override { return 8; }
96 
100  virtual bool is_vertex(const unsigned int i) const override;
101 
105  virtual bool is_edge(const unsigned int i) const override;
106 
110  virtual bool is_face(const unsigned int i) const override;
111 
116  virtual bool is_node_on_side(const unsigned int n,
117  const unsigned int s) const override;
118 
119  virtual std::vector<unsigned int> nodes_on_side(const unsigned int s) const override;
120 
121  virtual std::vector<unsigned int> nodes_on_edge(const unsigned int e) const override;
122 
127  virtual bool is_node_on_edge(const unsigned int n,
128  const unsigned int e) const override;
129 
134  virtual bool is_child_on_side(const unsigned int c,
135  const unsigned int s) const override;
136 
141  virtual bool has_affine_map () const override;
142 
146  virtual Order default_order() const override;
147 
151  virtual unsigned int local_side_node(unsigned int side,
152  unsigned int side_node) const override;
153 
157  virtual unsigned int local_edge_node(unsigned int edge,
158  unsigned int edge_node) const override;
159 
164  virtual std::unique_ptr<Elem> build_side_ptr (const unsigned int i) override;
165 
169  virtual void build_side_ptr (std::unique_ptr<Elem> & elem,
170  const unsigned int i) override;
171 
172  // Avoid hiding deprecated version with different signature
173  using Elem::build_side_ptr;
174 
179  virtual std::unique_ptr<Elem> build_edge_ptr (const unsigned int i) override;
180 
184  virtual void build_edge_ptr (std::unique_ptr<Elem> & edge, const unsigned int i) override;
185 
186  virtual void connectivity(const unsigned int sc,
187  const IOPackage iop,
188  std::vector<dof_id_type> & conn) const override;
189 
193  virtual unsigned int n_second_order_adjacent_vertices (const unsigned int) const override
194  { return 2; }
195 
202  virtual unsigned short int second_order_adjacent_vertex (const unsigned int n,
203  const unsigned int v) const override;
204 
210  virtual std::pair<unsigned short int, unsigned short int>
211  second_order_child_vertex (const unsigned int n) const override;
212 
216  static const int num_nodes = 10;
217  static const int nodes_per_side = 6;
218  static const int nodes_per_edge = 3;
219 
224  static const unsigned int side_nodes_map[num_sides][nodes_per_side];
225 
230  static const unsigned int edge_nodes_map[num_edges][nodes_per_edge];
231 
235  virtual Real volume () const override;
236 
237  virtual void permute(unsigned int perm_num) override final;
238 
239  virtual void flip(BoundaryInfo *) override final;
240 
241  ElemType side_type (const unsigned int s) const override final;
242 
243 protected:
244 
249 
250 
251 
252 #ifdef LIBMESH_ENABLE_AMR
253 
257  virtual Real embedding_matrix (const unsigned int i,
258  const unsigned int j,
259  const unsigned int k) const override;
260 
266 
268 
269 #endif // LIBMESH_ENABLE_AMR
270 
271 private:
272 
277  static const unsigned short int _second_order_adjacent_vertices[6][2];
278 
282  static const unsigned short int _second_order_vertex_child_number[10];
283 
287  static const unsigned short int _second_order_vertex_child_index[10];
288 };
289 
290 } // namespace libMesh
291 
292 
293 #endif // LIBMESH_CELL_TET10_H
ElemType
Defines an enum for geometric element types.
virtual Order default_order() const override
Definition: cell_tet10.C:175
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
virtual unsigned int n_second_order_adjacent_vertices(const unsigned int) const override
Definition: cell_tet10.h:193
virtual std::unique_ptr< Elem > build_edge_ptr(const unsigned int i) override
Builds a EDGE3 built coincident with edge i.
Definition: cell_tet10.C:219
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i)=0
virtual unsigned int n_nodes() const override
Definition: cell_tet10.h:90
virtual bool has_affine_map() const override
Definition: cell_tet10.C:143
static const unsigned short int _second_order_adjacent_vertices[6][2]
Matrix that tells which vertices define the location of mid-side (or second-order) nodes...
Definition: cell_tet10.h:277
static const unsigned int edge_nodes_map[num_edges][nodes_per_edge]
This maps the node of the edge to element node numbers.
Definition: cell_tet10.h:230
virtual unsigned short int second_order_adjacent_vertex(const unsigned int n, const unsigned int v) const override
Definition: cell_tet10.C:412
static const int num_sides
Geometric constants for all Tets.
Definition: cell_tet.h:74
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
static const int num_edges
Definition: cell_tet.h:75
The libMesh namespace provides an interface to certain functionality in the library.
virtual std::vector< unsigned int > nodes_on_side(const unsigned int s) const override
Definition: cell_tet10.C:87
virtual void connectivity(const unsigned int sc, const IOPackage iop, std::vector< dof_id_type > &conn) const override
Definition: cell_tet10.C:233
virtual void permute(unsigned int perm_num) override final
Permutes the element (by swapping node and neighbor pointers) according to the specified index...
Definition: cell_tet10.C:734
The Tet is an element in 3D composed of 4 sides.
Definition: cell_tet.h:36
virtual bool is_node_on_side(const unsigned int n, const unsigned int s) const override
Definition: cell_tet10.C:77
static const Real _embedding_matrix[num_children][num_nodes][num_nodes]
Matrix that computes new nodal locations/solution values from current nodes/solution.
Definition: cell_tet10.h:265
virtual unsigned int n_sub_elem() const override
Definition: cell_tet10.h:95
LIBMESH_ENABLE_TOPOLOGY_CACHES
Definition: cell_tet10.h:267
Node * _nodelinks_data[num_nodes]
Data for links to nodes.
Definition: cell_tet10.h:248
static const unsigned short int _second_order_vertex_child_number[10]
Vector that names a child sharing each second order node.
Definition: cell_tet10.h:282
virtual bool is_child_on_side(const unsigned int c, const unsigned int s) const override
Definition: cell_tet10.C:113
virtual Real volume() const override
A specialization for computing the volume of a Tet10.
Definition: cell_tet10.C:622
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i) override
Builds a TRI6 built coincident with face i.
Definition: cell_tet10.C:204
virtual bool is_node_on_edge(const unsigned int n, const unsigned int e) const override
Definition: cell_tet10.C:100
The BoundaryInfo class contains information relevant to boundary conditions including storing faces...
Definition: boundary_info.h:57
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: cell_tet10.C:564
virtual unsigned int local_side_node(unsigned int side, unsigned int side_node) const override
Definition: cell_tet10.C:182
virtual void flip(BoundaryInfo *) override final
Flips the element (by swapping node and neighbor pointers) to have a mapping Jacobian of opposite sig...
Definition: cell_tet10.C:776
Tet10(Elem *p=nullptr)
Constructor.
Definition: cell_tet10.h:72
static const int nodes_per_edge
Definition: cell_tet10.h:218
virtual std::vector< unsigned int > nodes_on_edge(const unsigned int e) const override
Definition: cell_tet10.C:94
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
ElemType side_type(const unsigned int s) const override final
Definition: cell_tet10.C:790
virtual bool is_vertex(const unsigned int i) const override
Definition: cell_tet10.C:58
The Tet10 is an element in 3D composed of 10 nodes.
Definition: cell_tet10.h:64
virtual ElemType type() const override
Definition: cell_tet10.h:85
static const unsigned int side_nodes_map[num_sides][nodes_per_side]
This maps the node of the side to element node numbers.
Definition: cell_tet10.h:224
static const int num_children
Definition: cell_tet.h:76
virtual bool is_face(const unsigned int i) const override
Definition: cell_tet10.C:72
virtual std::pair< unsigned short int, unsigned short int > second_order_child_vertex(const unsigned int n) const override
Definition: cell_tet10.C:401
static const unsigned short int _second_order_vertex_child_index[10]
Vector that names the child vertex index for each second order node.
Definition: cell_tet10.h:287
virtual unsigned int local_edge_node(unsigned int edge, unsigned int edge_node) const override
Definition: cell_tet10.C:193
virtual bool is_edge(const unsigned int i) const override
Definition: cell_tet10.C:65
static const int num_nodes
Geometric constants for Tet10.
Definition: cell_tet10.h:216
virtual ~Tet10()=default
static const int nodes_per_side
Definition: cell_tet10.h:217
Tet10 & operator=(const Tet10 &)=delete