libMesh
cell_hex27.h
Go to the documentation of this file.
1 // The libMesh Finite Element Library.
2 // Copyright (C) 2002-2024 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,
179  bool proxy=false) override;
180 
184  virtual void build_side_ptr (std::unique_ptr<Elem> & elem,
185  const unsigned int i) override;
186 
191  virtual std::unique_ptr<Elem> build_edge_ptr (const unsigned int i) override;
192 
196  virtual void build_edge_ptr (std::unique_ptr<Elem> & edge, const unsigned int i) override;
197 
198  virtual void connectivity(const unsigned int sc,
199  const IOPackage iop,
200  std::vector<dof_id_type> & conn) const override;
201 
206  virtual unsigned int n_second_order_adjacent_vertices (const unsigned int) const override;
207 
214  virtual unsigned short int second_order_adjacent_vertex (const unsigned int n,
215  const unsigned int v) const override;
216 
222  virtual std::pair<unsigned short int, unsigned short int>
223  second_order_child_vertex (const unsigned int n) const override;
224 
228  static const int num_nodes = 27;
229  static const int num_sides = 6;
230  static const int num_edges = 12;
231  static const int num_children = 8;
232  static const int nodes_per_side = 9;
233  static const int nodes_per_edge = 3;
234 
239  static const unsigned int side_nodes_map[num_sides][nodes_per_side];
240 
245  static const unsigned int edge_nodes_map[num_edges][nodes_per_edge];
246 
250  virtual Real volume () const override;
251 
252  virtual void permute(unsigned int perm_num) override final;
253 
254  virtual void flip(BoundaryInfo *) override final;
255 
256  unsigned int center_node_on_side(const unsigned short side) const override final;
257 
258  ElemType side_type (const unsigned int s) const override final;
259 
260 protected:
261 
262 
267 
268 
269 #ifdef LIBMESH_ENABLE_AMR
270 
274  virtual Real embedding_matrix (const unsigned int i,
275  const unsigned int j,
276  const unsigned int k) const override
277  { return _embedding_matrix[i][j][k]; }
278 
284 
286 
287 #endif // LIBMESH_ENABLE_AMR
288 
289 
290 private:
291 
304  static const unsigned short int _remaining_second_order_adjacent_vertices[6][4];
305 
306 };
307 
308 } // namespace libMesh
309 
310 #endif // LIBMESH_CELL_HEX27_H
static const int num_children
Definition: cell_hex27.h:231
virtual void connectivity(const unsigned int sc, const IOPackage iop, std::vector< dof_id_type > &conn) const override
Definition: cell_hex27.C:278
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:1142
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:283
virtual std::pair< unsigned short int, unsigned short int > second_order_child_vertex(const unsigned int n) const override
Definition: cell_hex27.C:549
virtual unsigned int n_nodes() const override
Definition: cell_hex27.h:96
static const int num_sides
Definition: cell_hex27.h:229
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:274
virtual bool has_affine_map() const override
Definition: cell_hex27.C:129
virtual Order default_order() const override
Definition: cell_hex27.C:175
virtual dof_id_type key() const
Definition: elem.C:563
static const int num_nodes
Geometric constants for Hex27.
Definition: cell_hex27.h:228
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:70
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:1162
virtual bool is_node_on_side(const unsigned int n, const unsigned int s) const override
Definition: cell_hex27.C:95
virtual unsigned int n_second_order_adjacent_vertices(const unsigned int) const override
Definition: cell_hex27.C:448
The libMesh namespace provides an interface to certain functionality in the library.
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i, bool proxy=false) override
Builds a QUAD9 built coincident with face i.
Definition: cell_hex27.C:248
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:1063
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:118
ElemType side_type(const unsigned int s) const override final
Definition: cell_hex27.C:1170
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:245
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:565
static const int num_edges
Definition: cell_hex27.h:230
virtual unsigned int local_edge_node(unsigned int edge, unsigned int edge_node) const override
Definition: cell_hex27.C:237
static const int nodes_per_side
Definition: cell_hex27.h:232
static const int nodes_per_edge
Definition: cell_hex27.h:233
LIBMESH_ENABLE_TOPOLOGY_CACHES
Definition: cell_hex27.h:285
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:304
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:105
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:86
virtual unsigned short int second_order_adjacent_vertex(const unsigned int n, const unsigned int v) const override
Definition: cell_hex27.C:484
virtual unsigned int n_sub_elem() const override
Definition: cell_hex27.h:101
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:264
virtual std::vector< unsigned int > nodes_on_edge(const unsigned int e) const override
Definition: cell_hex27.C:112
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:239
virtual unsigned int local_side_node(unsigned int side, unsigned int side_node) const override
Definition: cell_hex27.C:226
virtual bool is_edge(const unsigned int i) const override
Definition: cell_hex27.C:77
Node * _nodelinks_data[num_nodes]
Data for links to nodes.
Definition: cell_hex27.h:266
uint8_t dof_id_type
Definition: id_types.h:67