// ------------------------------------------------------------------------ // // SPDX-License-Identifier: LGPL-2.1-or-later // Copyright (C) 2015 - 2023 by the deal.II authors // // This file is part of the deal.II library. // // Part of the source code is dual licensed under Apache-2.0 WITH // LLVM-exception OR LGPL-2.1-or-later. Detailed license information // governing the source code and code contributions can be found in // LICENSE.md and CONTRIBUTING.md at the top level directory of deal.II. // // ------------------------------------------------------------------------ #ifndef dealii_fe_rannacher_turek_h #define dealii_fe_rannacher_turek_h #include #include #include #include #include #include DEAL_II_NAMESPACE_OPEN /** * Implementation of the Rannacher-Turek element. This element is used * to generate a stable pair of function spaces for the Stokes * equation without having to increase the polynomial degree of the * velocity space as much as one would do for the stable Taylor-Hood * element which uses the $Q_2^d\times Q_1$ pair for velocity and * pressure. That said, like many other non-conforming elements, it * can also be used for the discretization of the Laplace * equation. The element was first described in R. Rannacher and * S. Turek: "Simple non-conforming quadrilateral Stokes element", * Numerical Methods for Partial Differential Equations, vol. 8, * pp. 97-112, 1992. * * The shape functions generated by this element are in general * discontinuous, and consequently the element is not $H^1$ conforming * (i.e., it is a "non-conforming" element). However, the shape * functions are constructed in such a way that the jump along faces * has mean value zero, and consequently there is some sort of * conformity in the element: a conforming element would have a * pointwise zero jump, a completely discontinuous element like the * FE_DGQ elements can have entirely arbitrary values for the jump * across a face, and the current element is somewhere in the middle * because its jump is nonzero but at least has mean value zero. * * The element is currently implemented only in dimension 2, for the * lowest polynomial order, and without hanging nodes and * restriction/prolongation. * * *

Interpolation

* *

Node values

* * The * @ref GlossNodes "node values" * are moments on faces. * *

Generalized support points

* * To calculate the node values, we are using a QGauss rule on each * face. By default, we are using a two point rule to integrate * Rannacher-Turek functions exactly. But in order to be able to * interpolate other functions with sufficient accuracy, the number of * quadrature points used on a face can be adjusted in the * constructor. * * @ingroup fe */ template class FE_RannacherTurek : public FE_Poly { public: /** * Constructor for Rannacher-Turek element of given @p order, using @p * n_face_support_points quadrature points on each face for interpolation. * Notice that the element of order 0 contains polynomials of degree 2. * * The element is currently only implemented for order 0 in 2d. */ FE_RannacherTurek(const unsigned int order = 0, const unsigned int n_face_support_points = 2); virtual std::string get_name() const override; virtual std::unique_ptr> clone() const override; // documentation inherited from the base class virtual void convert_generalized_support_point_values_to_dof_values( const std::vector> &support_point_values, std::vector &nodal_values) const override; private: /** * Order of this element. */ const unsigned int order; /** * The number of quadrature points used on each face to evaluate node * functionals during interpolation. */ const unsigned int n_face_support_points; /** * The weights used on the faces to evaluate node functionals. */ std::vector weights; /** * Compute generalized support points and their weights. */ void initialize_support_points(); /** * Return information about degrees of freedom per object as needed during * construction. */ std::vector get_dpo_vector(); }; DEAL_II_NAMESPACE_CLOSE #endif