libMesh
face_quad8.h
Go to the documentation of this file.
1 // The libMesh Finite Element Library.
2 // Copyright (C) 2002-2019 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_QUAD8_H
21 #define LIBMESH_FACE_QUAD8_H
22 
23 // Local includes
24 #include "libmesh/libmesh_common.h"
25 #include "libmesh/face_quad.h"
26 
27 namespace libMesh
28 {
29 
51 class Quad8 : public Quad
52 {
53 public:
54 
58  explicit
59  Quad8 (Elem * p=nullptr) :
61 
62  Quad8 (Quad8 &&) = delete;
63  Quad8 (const Quad8 &) = delete;
64  Quad8 & operator= (const Quad8 &) = delete;
65  Quad8 & operator= (Quad8 &&) = delete;
66  virtual ~Quad8() = default;
67 
71  virtual ElemType type () const override { return QUAD8; }
72 
76  virtual unsigned int n_nodes() const override { return num_nodes; }
77 
81  virtual unsigned int n_sub_elem() const override { return 5; }
82 
86  virtual bool is_vertex(const unsigned int i) const override;
87 
91  virtual bool is_edge(const unsigned int i) const override;
92 
96  virtual bool is_face(const unsigned int i) const override;
97 
102  virtual bool is_node_on_side(const unsigned int n,
103  const unsigned int s) const override;
104 
105  virtual std::vector<unsigned int> nodes_on_side(const unsigned int s) const override;
106 
111  virtual bool is_node_on_edge(const unsigned int n,
112  const unsigned int e) const override
113  { return this->is_node_on_side(n,e); }
114 
119  virtual bool has_affine_map () const override;
120 
124  virtual Order default_order() const override;
125 
129  using Elem::key;
130 
140  virtual dof_id_type key (const unsigned int s) const override;
141 
145  virtual unsigned int which_node_am_i(unsigned int side,
146  unsigned int side_node) const override;
147 
148  virtual std::unique_ptr<Elem> build_side_ptr (const unsigned int i,
149  bool proxy=true) override;
150 
154  virtual void build_side_ptr (std::unique_ptr<Elem> & elem,
155  const unsigned int i) override;
156 
157  virtual void connectivity(const unsigned int sf,
158  const IOPackage iop,
159  std::vector<dof_id_type> & conn) const override;
160 
164  virtual unsigned int n_second_order_adjacent_vertices (const unsigned int) const override
165  { return 2; }
166 
173  virtual unsigned short int second_order_adjacent_vertex (const unsigned int n,
174  const unsigned int v) const override;
175 
181  virtual std::pair<unsigned short int, unsigned short int>
182  second_order_child_vertex (const unsigned int n) const override;
183 
187  static const int num_nodes = 8;
188  static const int num_sides = 4;
189  static const int num_children = 4;
190  static const int nodes_per_side = 3;
191 
196  static const unsigned int side_nodes_map[num_sides][nodes_per_side];
197 
202  virtual Real volume () const override;
203 
208  virtual BoundingBox loose_bounding_box () const override;
209 
210 protected:
211 
216 
217 
218 
219 #ifdef LIBMESH_ENABLE_AMR
220 
224  virtual float embedding_matrix (const unsigned int i,
225  const unsigned int j,
226  const unsigned int k) const override
227  { return _embedding_matrix[i][j][k]; }
228 
234 
236 
237 #endif // LIBMESH_ENABLE_AMR
238 
239 };
240 
241 
242 } // namespace libMesh
243 
244 #endif // LIBMESH_FACE_QUAD8_H
libMesh::Quad8::is_node_on_side
virtual bool is_node_on_side(const unsigned int n, const unsigned int s) const override
Definition: face_quad8.C:130
libMesh::dof_id_type
uint8_t dof_id_type
Definition: id_types.h:67
libMesh::Quad8::is_node_on_edge
virtual bool is_node_on_edge(const unsigned int n, const unsigned int e) const override
Definition: face_quad8.h:111
libMesh::Quad8::side_nodes_map
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_quad8.h:196
libMesh::Quad8::embedding_matrix
virtual float 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_quad8.h:224
libMesh::Quad8::_embedding_matrix
static const float _embedding_matrix[num_children][num_nodes][num_nodes]
Matrix that computes new nodal locations/solution values from current nodes/solution.
Definition: face_quad8.h:233
libMesh::IOPackage
IOPackage
libMesh interfaces with several different software packages for the purposes of creating,...
Definition: enum_io_package.h:37
libMesh::BoundingBox
Defines a Cartesian bounding box by the two corner extremum.
Definition: bounding_box.h:40
libMesh
The libMesh namespace provides an interface to certain functionality in the library.
Definition: factoryfunction.C:55
libMesh::Quad8::_nodelinks_data
Node * _nodelinks_data[num_nodes]
Data for links to nodes.
Definition: face_quad8.h:215
libMesh::Order
Order
Definition: enum_order.h:40
libMesh::Quad8::operator=
Quad8 & operator=(const Quad8 &)=delete
libMesh::Quad8::n_second_order_adjacent_vertices
virtual unsigned int n_second_order_adjacent_vertices(const unsigned int) const override
Definition: face_quad8.h:164
libMesh::Quad::key
virtual dof_id_type key() const override
Definition: face_quad.C:76
libMesh::Quad8::type
virtual ElemType type() const override
Definition: face_quad8.h:71
libMesh::Quad8::Quad8
Quad8(Elem *p=nullptr)
Constructor.
Definition: face_quad8.h:59
libMesh::Quad8::second_order_adjacent_vertex
virtual unsigned short int second_order_adjacent_vertex(const unsigned int n, const unsigned int v) const override
Definition: face_quad8.C:477
libMesh::Quad8::has_affine_map
virtual bool has_affine_map() const override
Definition: face_quad8.C:146
libMesh::Quad8::second_order_child_vertex
virtual std::pair< unsigned short int, unsigned short int > second_order_child_vertex(const unsigned int n) const override
Definition: face_quad8.C:490
libMesh::Quad8::volume
virtual Real volume() const override
An optimized method for approximating the area of a QUAD8 using quadrature.
Definition: face_quad8.C:427
libMesh::Quad8::num_children
static const int num_children
Definition: face_quad8.h:189
libMesh::Elem::key
virtual dof_id_type key() const
Definition: elem.C:410
libMesh::Quad8::build_side_ptr
virtual std::unique_ptr< Elem > build_side_ptr(const unsigned int i, bool proxy=true) override
Definition: face_quad8.C:217
libMesh::Node
A Node is like a Point, but with more information.
Definition: node.h:52
libMesh::Quad8::loose_bounding_box
virtual BoundingBox loose_bounding_box() const override
Definition: face_quad8.C:397
libMesh::Quad8::is_vertex
virtual bool is_vertex(const unsigned int i) const override
Definition: face_quad8.C:111
libMesh::Quad
The QUAD is an element in 2D composed of 4 sides.
Definition: face_quad.h:48
libMesh::Quad8::n_nodes
virtual unsigned int n_nodes() const override
Definition: face_quad8.h:76
libMesh::Quad8::default_order
virtual Order default_order() const override
Definition: face_quad8.C:166
libMesh::Quad8::is_face
virtual bool is_face(const unsigned int i) const override
Definition: face_quad8.C:125
libMesh::Quad8
The QUAD8 is an element in 2D composed of 8 nodes.
Definition: face_quad8.h:51
libMesh::Quad8::num_nodes
static const int num_nodes
Geometric constants for Quad8.
Definition: face_quad8.h:187
libMesh::Quad8::connectivity
virtual void connectivity(const unsigned int sf, const IOPackage iop, std::vector< dof_id_type > &conn) const override
Definition: face_quad8.C:251
libMesh::Elem
This is the base class from which all geometric element types are derived.
Definition: elem.h:100
libMesh::Quad8::nodes_on_side
virtual std::vector< unsigned int > nodes_on_side(const unsigned int s) const override
Definition: face_quad8.C:140
libMesh::Quad8::n_sub_elem
virtual unsigned int n_sub_elem() const override
Definition: face_quad8.h:81
libMesh::Quad8::LIBMESH_ENABLE_TOPOLOGY_CACHES
LIBMESH_ENABLE_TOPOLOGY_CACHES
Definition: face_quad8.h:235
libMesh::Quad8::num_sides
static const int num_sides
Definition: face_quad8.h:188
libMesh::Real
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
Definition: libmesh_common.h:121
libMesh::Quad8::which_node_am_i
virtual unsigned int which_node_am_i(unsigned int side, unsigned int side_node) const override
Definition: face_quad8.C:206
libMesh::Quad8::is_edge
virtual bool is_edge(const unsigned int i) const override
Definition: face_quad8.C:118
libMesh::Quad8::~Quad8
virtual ~Quad8()=default
libMesh::Quad8::nodes_per_side
static const int nodes_per_side
Definition: face_quad8.h:190
libMesh::QUAD8
Definition: enum_elem_type.h:42
libMesh::ElemType
ElemType
Defines an enum for geometric element types.
Definition: enum_elem_type.h:33