libMesh
cell_hex27.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_HEX27_H
21 #define LIBMESH_CELL_HEX27_H
22 
23 // Local includes
24 #include "libmesh/cell_hex.h"
25 
26 namespace libMesh
27 {
28 
70 class Hex27 final : public Hex
71 {
72 public:
73 
77  explicit
78  Hex27 (Elem * p=nullptr) :
80  {}
81 
82  Hex27 (Hex27 &&) = delete;
83  Hex27 (const Hex27 &) = delete;
84  Hex27 & operator= (const Hex27 &) = delete;
85  Hex27 & operator= (Hex27 &&) = delete;
86  virtual ~Hex27() = default;
87 
91  virtual ElemType type () const override { return HEX27; }
92 
96  virtual unsigned int n_nodes() const override { return num_nodes; }
97 
101  virtual unsigned int n_sub_elem() const override { return 8; }
102 
106  virtual bool is_vertex(const unsigned int i) const override;
107 
111  virtual bool is_edge(const unsigned int i) const override;
112 
116  virtual bool is_face(const unsigned int i) const override;
117 
122  virtual bool is_node_on_side(const unsigned int n,
123  const unsigned int s) const override;
124 
125  virtual std::vector<unsigned int> nodes_on_side(const unsigned int s) const override;
126 
127  virtual std::vector<unsigned int> nodes_on_edge(const unsigned int e) const override;
128 
133  virtual bool is_node_on_edge(const unsigned int n,
134  const unsigned int e) const override;
135 
140  virtual bool has_affine_map () const override;
141 
145  virtual Order default_order() const override;
146 
150  using Elem::key;
151 
160  virtual dof_id_type key (const unsigned int s) const override;
161 
165  virtual unsigned int local_side_node(unsigned int side,
166  unsigned int side_node) const override;
167 
171  virtual unsigned int local_edge_node(unsigned int edge,
172  unsigned int edge_node) const override;
173 
178  virtual std::unique_ptr<Elem> build_side_ptr (const unsigned int i) override;
179 
183  virtual void build_side_ptr (std::unique_ptr<Elem> & elem,
184  const unsigned int i) override;
185 
186  // Avoid hiding deprecated version with different signature
187  using Elem::build_side_ptr;
188 
193  virtual std::unique_ptr<Elem> build_edge_ptr (const unsigned int i) override;
194 
198  virtual void build_edge_ptr (std::unique_ptr<Elem> & edge, const unsigned int i) override;
199 
200  virtual void connectivity(const unsigned int sc,
201  const IOPackage iop,
202  std::vector<dof_id_type> & conn) const override;
203 
208  virtual unsigned int n_second_order_adjacent_vertices (const unsigned int) const override;
209 
216  virtual unsigned short int second_order_adjacent_vertex (const unsigned int n,
217  const unsigned int v) const override;
218 
224  virtual std::pair<unsigned short int, unsigned short int>
225  second_order_child_vertex (const unsigned int n) const override;
226 
230  static const int num_nodes = 27;
231  static const int nodes_per_side = 9;
232  static const int nodes_per_edge = 3;
233 
238  static const unsigned int side_nodes_map[num_sides][nodes_per_side];
239 
244  static const unsigned int edge_nodes_map[num_edges][nodes_per_edge];
245 
249  virtual Real volume () const override;
250 
251  virtual void permute(unsigned int perm_num) override final;
252 
253  virtual void flip(BoundaryInfo *) override final;
254 
255  unsigned int center_node_on_side(const unsigned short side) const override final;
256 
257  ElemType side_type (const unsigned int s) const override final;
258 
259 protected:
260 
261 
266 
267 
268 #ifdef LIBMESH_ENABLE_AMR
269 
273  virtual Real embedding_matrix (const unsigned int i,
274  const unsigned int j,
275  const unsigned int k) const override
276  { return _embedding_matrix[i][j][k]; }
277 
283 
285 
286 #endif // LIBMESH_ENABLE_AMR
287 
288 
289 private:
290 
303  static const unsigned short int _remaining_second_order_adjacent_vertices[6][4];
304 
305 };
306 
307 } // namespace libMesh
308 
309 #endif // LIBMESH_CELL_HEX27_H
virtual void connectivity(const unsigned int sc, const IOPackage iop, std::vector< dof_id_type > &conn) const override
Definition: cell_hex27.C:273
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_hex27.C:1137
ElemType
Defines an enum for geometric element types.
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 Real _embedding_matrix[num_children][num_nodes][num_nodes]
Matrix that computes new nodal locations/solution values from current nodes/solution.
Definition: cell_hex27.h:282
virtual std::pair< unsigned short int, unsigned short int > second_order_child_vertex(const unsigned int n) const override
Definition: cell_hex27.C:544
virtual unsigned int n_nodes() const override
Definition: cell_hex27.h:96
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_hex27.h:273
virtual bool has_affine_map() const override
Definition: cell_hex27.C:125
virtual Order default_order() const override
Definition: cell_hex27.C:171
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i)=0
virtual dof_id_type key() const
Definition: elem.C:753
static const int num_nodes
Geometric constants for Hex27.
Definition: cell_hex27.h:230
The Hex is an element in 3D with 6 sides.
Definition: cell_hex.h:36
virtual bool is_vertex(const unsigned int i) const override
Definition: cell_hex27.C:66
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
virtual ~Hex27()=default
unsigned int center_node_on_side(const unsigned short side) const override final
Definition: cell_hex27.C:1159
virtual bool is_node_on_side(const unsigned int n, const unsigned int s) const override
Definition: cell_hex27.C:91
virtual unsigned int n_second_order_adjacent_vertices(const unsigned int) const override
Definition: cell_hex27.C:443
The libMesh namespace provides an interface to certain functionality in the library.
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i) override
Builds a QUAD9 built coincident with face i.
Definition: cell_hex27.C:244
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_hex27.C:1058
virtual ElemType type() const override
Definition: cell_hex27.h:91
Hex27(Elem *p=nullptr)
Constructor.
Definition: cell_hex27.h:78
virtual bool is_node_on_edge(const unsigned int n, const unsigned int e) const override
Definition: cell_hex27.C:114
static const int num_edges
Definition: cell_hex.h:74
ElemType side_type(const unsigned int s) const override final
Definition: cell_hex27.C:1167
static const int num_children
Definition: cell_hex.h:75
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_hex27.h:244
The BoundaryInfo class contains information relevant to boundary conditions including storing faces...
Definition: boundary_info.h:57
Hex27 & operator=(const Hex27 &)=delete
virtual Real volume() const override
A specialization for computing the volume of a Hex27.
Definition: cell_hex27.C:560
virtual unsigned int local_edge_node(unsigned int edge, unsigned int edge_node) const override
Definition: cell_hex27.C:233
static const int nodes_per_side
Definition: cell_hex27.h:231
static const int nodes_per_edge
Definition: cell_hex27.h:232
LIBMESH_ENABLE_TOPOLOGY_CACHES
Definition: cell_hex27.h:284
static const unsigned short int _remaining_second_order_adjacent_vertices[6][4]
Matrix that tells which vertices define the location of mid-side (or second-order) nodes...
Definition: cell_hex27.h:303
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
virtual std::vector< unsigned int > nodes_on_side(const unsigned int s) const override
Definition: cell_hex27.C:101
The Hex27 is an element in 3D composed of 27 nodes.
Definition: cell_hex27.h:70
virtual bool is_face(const unsigned int i) const override
Definition: cell_hex27.C:82
virtual unsigned short int second_order_adjacent_vertex(const unsigned int n, const unsigned int v) const override
Definition: cell_hex27.C:479
virtual unsigned int n_sub_elem() const override
Definition: cell_hex27.h:101
static const int num_sides
Geometric constants for all Hexes.
Definition: cell_hex.h:73
virtual std::unique_ptr< Elem > build_edge_ptr(const unsigned int i) override
Builds a EDGE3 built coincident with edge i.
Definition: cell_hex27.C:259
virtual std::vector< unsigned int > nodes_on_edge(const unsigned int e) const override
Definition: cell_hex27.C:108
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_hex27.h:238
virtual unsigned int local_side_node(unsigned int side, unsigned int side_node) const override
Definition: cell_hex27.C:222
virtual bool is_edge(const unsigned int i) const override
Definition: cell_hex27.C:73
Node * _nodelinks_data[num_nodes]
Data for links to nodes.
Definition: cell_hex27.h:265
uint8_t dof_id_type
Definition: id_types.h:67