// ------------------------------------------------------------------------ // // 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_polynomials_nedelec_h #define dealii_polynomials_nedelec_h #include #include #include #include #include #include #include #include #include DEAL_II_NAMESPACE_OPEN /** * This class implements the first family Hcurl-conforming, * vector-valued polynomials, proposed by J.-C. Nédélec in 1980 (Numer. * Math. 35). * * The Nédélec polynomials are constructed such that the curl is in the * tensor product polynomial space Qk. Therefore, the * polynomial order of each component must be one order higher in the * corresponding two directions, yielding the polynomial spaces * (Qk,k+1, Qk+1,k) and * (Qk,k+1,k+1, Qk+1,k,k+1, * Qk+1,k+1,k) in 2d and 3d, resp. * * @ingroup Polynomials */ template class PolynomialsNedelec : public TensorPolynomialsBase { public: /** * Constructor. Creates all basis functions for Nédélec polynomials of * given degree. * * @arg k: the degree of the Nédélec space, which is the degree of the * largest tensor product polynomial space Qk contained. */ PolynomialsNedelec(const unsigned int k); /** * Compute the value and the first and second derivatives of each Nédélec * polynomial at @p unit_point. * * The size of the vectors must either be zero or equal n(). In * the first case, the function will not compute these values. */ void evaluate(const Point &unit_point, std::vector> &values, std::vector> &grads, std::vector> &grad_grads, std::vector> &third_derivatives, std::vector> &fourth_derivatives) const override; /** * Return the name of the space, which is Nedelec. */ std::string name() const override; /** * Return the number of polynomials in the space N(degree) without * requiring to build an object of PolynomialsNedelec. This is required by * the FiniteElement classes. */ static unsigned int n_polynomials(const unsigned int degree); /** * @copydoc TensorPolynomialsBase::clone() */ virtual std::unique_ptr> clone() const override; private: /** * An object representing the polynomial space for a single component. We * can re-use it by rotating the coordinates of the evaluation point. */ const AnisotropicPolynomials polynomial_space; /** * A static member function that creates the polynomial space we use to * initialize the #polynomial_space member variable. */ static std::vector>> create_polynomials(const unsigned int k); }; template inline std::string PolynomialsNedelec::name() const { return "Nedelec"; } DEAL_II_NAMESPACE_CLOSE #endif