// ------------------------------------------------------------------------ // // SPDX-License-Identifier: LGPL-2.1-or-later // Copyright (C) 2010 - 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_bdm_h #define dealii_fe_bdm_h #include #include #include #include #include #include #include #include DEAL_II_NAMESPACE_OPEN /** * The Brezzi-Douglas-Marini element. * *

Degrees of freedom

* * @todo The 3d version exhibits some numerical instabilities, in particular * for higher order * * @todo Restriction matrices are missing. * * The matching pressure space for FE_BDM of order k is the element * FE_DGP of order k-1. * * The BDM element of order @p p has p+1 degrees of freedom on each * face. These are implemented as the function values in the p+1 Gauss * points on each face. * * Additionally, for order greater or equal 2, we have additional * p(p-1), the number of vector valued polynomials in * Pp, interior degrees of freedom. These are the vector * function values in the first p(p-1)/2 of the p2 * Gauss points in the cell. * * @ingroup fe */ template class FE_BDM : public FE_PolyTensor { public: /** * Constructor for the BDM element of degree @p p. */ FE_BDM(const unsigned int p); /** * Return a string that uniquely identifies a finite element. This class * returns FE_BDM(degree), with @p dim and @p degree replaced * by appropriate values. */ 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: /** * Only for internal use. Its full name is @p get_dofs_per_object_vector * function and it creates the @p dofs_per_object vector that is needed * within the constructor to be passed to the constructor of @p * FiniteElementData. */ static std::vector get_dpo_vector(const unsigned int degree); /** * Compute the vector used for the @p restriction_is_additive field passed * to the base class's constructor. */ static std::vector get_ria_vector(const unsigned int degree); /** * Initialize the FiniteElement::generalized_support_points and * FiniteElement::generalized_face_support_points fields. Called from * the constructor. See the * @ref GlossGeneralizedSupport "glossary entry on generalized support points" * for more information. */ void initialize_support_points(const unsigned int bdm_degree); /** * The values in the face support points of the polynomials needed as test * functions. The outer vector is indexed by quadrature points, the inner by * the test function. The test function space is PolynomialsP. */ std::vector> test_values_face; /** * The values in the interior support points of the polynomials needed as * test functions. The outer vector is indexed by quadrature points, the * inner by the test function. The test function space is PolynomialsP. */ std::vector> test_values_cell; /** * Initialize the permutation pattern and the pattern of sign change. * * @note This function is not fully filled with the correct implementation * yet. It needs to be consistently implemented in a future release to work * on meshes that contain cells with flipped faces. */ void initialize_quad_dof_index_permutation_and_sign_change(); }; DEAL_II_NAMESPACE_CLOSE #endif