nedelec1stkindcube.hh

Go to the documentation of this file.

// -*- tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
// vi: set et ts=4 sw=2 sts=2:
// SPDX-FileCopyrightInfo: Copyright (C) DUNE Project contributors, see file LICENSE.md in module root
// SPDX-License-Identifier: LicenseRef-GPL-2.0-only-with-DUNE-exception
#ifndef DUNE_LOCALFUNCTIONS_NEDELEC_NEDELEC1STKINDCUBE_HH
#define DUNE_LOCALFUNCTIONS_NEDELEC_NEDELEC1STKINDCUBE_HH
 
#include <numeric>
 
#include <dune/common/fmatrix.hh>
#include <dune/common/fvector.hh>
#include <dune/common/math.hh>
 
#include <dune/geometry/referenceelements.hh>
#include <dune/geometry/type.hh>
 
#include <dune/localfunctions/common/localbasis.hh>
#include <dune/localfunctions/common/localfiniteelementtraits.hh>
#include <dune/localfunctions/common/localinterpolation.hh>   // For deprecated makeFunctionWithCallOperator
#include <dune/localfunctions/common/localkey.hh>
 
namespace Dune
{
namespace Impl
{
  template<class D, class R, int dim, int k>
  class Nedelec1stKindCubeLocalBasis
  {
    // Number of edges of the reference cube
    constexpr static std::size_t numberOfEdges = power(2,dim-1)*dim;
 
  public:
    using Traits = LocalBasisTraits<D,dim,FieldVector<D,dim>,
                                    R,dim,FieldVector<R,dim>,
                                    FieldMatrix<R,dim,dim> >;
 
    Nedelec1stKindCubeLocalBasis()
    {
      std::fill(edgeOrientation_.begin(), edgeOrientation_.end(), 1.0);
    }
 
    Nedelec1stKindCubeLocalBasis(std::bitset<numberOfEdges> edgeOrientation)
    : Nedelec1stKindCubeLocalBasis()
    {
      for (std::size_t i=0; i<edgeOrientation_.size(); i++)
        edgeOrientation_[i] *= edgeOrientation[i] ? -1.0 : 1.0;
    }
 
    static constexpr unsigned int size()
    {
      static_assert(dim==2 || dim==3, "Nedelec shape functions are implemented only for 2d and 3d cubes.");
      if (dim==2)
        return 2*k * (k+1);
      if (dim==3)
        return 3*k * (k+1) * (k+1);
    }
 
    void evaluateFunction(const typename Traits::DomainType& in,
                           std::vector<typename Traits::RangeType>& out) const
    {
      static_assert(k==1, "Evaluating Nédélec shape functions is implemented only for first order.");
      out.resize(size());
 
      if (dim==2)
      {
        // First-order Nédélec shape functions on a square are of the form
        //
        //         (a, b)^T + (c y, d x)^T,     a, b, c, d \in R
        //
        // The following coefficients create the four basis vectors
        // that are dual to the edge degrees of freedom:
        //
        // a[0] = 0     b[0] = 1    c[0] = 0    d[0] = -1
        // a[1] = 0     b[1] = 0    c[1] = 0    d[1] =  1
        // a[2] = 1     b[2] = 0    c[2] = 0    d[2] = -1
        // a[3] = 0     b[3] = 0    c[3] = 0    d[3] =  1
 
        out[0] = {            0, D(1) - in[0]};
        out[1] = {            0,        in[0]};
        out[2] = { D(1) - in[1],            0};
        out[3] = {        in[1],            0};
      }
 
      if constexpr (dim==3)
      {
        // First-order Nédélec shape functions on a cube are of the form
        //
        //                                (e1 yz)
        //          a + b x + c y + d z + (e2 xz)  ,       a, b, c, d \in R^3 and b[0]=c[1]=d[2]=0
        //                                (e3 xy)
        //
        // The following coefficients create the twelve  basis vectors
        // that are dual to the edge degrees of freedom:
        //
        // a[0] = { 0,  0,  1}              b[0] = { 0,  0, -1}              c[0] = { 0,  0, -1}              d[0] = { 0,  0,  0}              e[0] = { 0,  0,  1}
        // a[1] = { 0,  0,  0}              b[1] = { 0,  0,  1}              c[1] = { 0,  0,  0}              d[1] = { 0,  0,  0}              e[1] = { 0,  0, -1}
        // a[2] = { 0,  0,  0}              b[2] = { 0,  0,  0}              c[2] = { 0,  0,  1}              d[2] = { 0,  0,  0}              e[2] = { 0,  0, -1}
        // a[3] = { 0,  0,  0}              b[3] = { 0,  0,  0}              c[3] = { 0,  0,  0}              d[3] = { 0,  0,  0}              e[3] = { 0,  0,  1}
        //
        // The following implementation uses these values, and simply
        // skips all the zeros.
 
        for (std::size_t i=0; i<out.size(); i++)
          out[i] = {0,0,0};
 
        out[0][2]  = { 1 - in[0] - in[1] + in[0]*in[1]};
        out[1][2]  = {     in[0]         - in[0]*in[1]};
        out[2][2]  = {             in[1] - in[0]*in[1]};
        out[3][2]  = {                     in[0]*in[1]};
 
        out[4][1]  = { 1 - in[0] - in[2] + in[0]*in[2]};
        out[5][1]  = {     in[0]         - in[0]*in[2]};
        out[8][1]  = {             in[2] - in[0]*in[2]};
        out[9][1]  = {                     in[0]*in[2]};
 
        out[6][0]  = { 1 - in[1] - in[2] + in[1]*in[2]};
        out[7][0]  = {     in[1]         - in[1]*in[2]};
        out[10][0] = {             in[2] - in[1]*in[2]};
        out[11][0] = {                     in[1]*in[2]};
      }
 
      for (std::size_t i=0; i<out.size(); i++)
        out[i] *= edgeOrientation_[i];
    }
 
    void evaluateJacobian(const typename Traits::DomainType& in,
                          std::vector<typename Traits::JacobianType>& out) const
    {
      out.resize(size());
      if (dim==2)
      {
        for (std::size_t i=0; i<out.size(); i++)
          for (std::size_t j=0; j<dim; j++)
            out[i][j] = { 0, 0};
 
        out[0][1] = { -1, 0};
        out[1][1] = {  1, 0};
 
        out[2][0] = { 0, -1};
        out[3][0] = { 0,  1};
      }
      if (dim==3)
      {
        for (std::size_t i=0; i<out.size(); i++)
          for(std::size_t j=0;j<dim; j++)
            out[i][j] = {0,0,0};
 
 
        out[0][2]  = {-1 +in[1], -1 + in[0],          0};
        out[1][2]  = { 1 -in[1],    - in[0],          0};
        out[2][2]  = {   -in[1],  1 - in[0],          0};
        out[3][2]  = {    in[1],      in[0],          0};
 
        out[4][1]  = {-1 +in[2],          0, -1 + in[0]};
        out[5][1]  = { 1 -in[2],          0,    - in[0]};
        out[8][1]  = {   -in[2],          0,  1 - in[0]};
        out[9][1]  = {    in[2],          0,      in[0]};
 
        out[6][0]  = {        0, -1 + in[2], -1 + in[1]};
        out[7][0]  = {        0,  1 - in[2],    - in[1]};
        out[10][0] = {        0,    - in[2],  1 - in[1]};
        out[11][0] = {        0,      in[2],      in[1]};
 
      }
 
      for (std::size_t i=0; i<out.size(); i++)
        out[i] *= edgeOrientation_[i];
 
    }
 
    void partial(const std::array<unsigned int, dim>& order,
                 const typename Traits::DomainType& in,
                 std::vector<typename Traits::RangeType>& out) const
    {
      auto totalOrder = std::accumulate(order.begin(), order.end(), 0);
      if (totalOrder == 0) {
        evaluateFunction(in, out);
      } else if (totalOrder == 1) {
        auto const direction = std::distance(order.begin(), std::find(order.begin(), order.end(), 1));
        out.resize(size());
 
        if (dim==2)
        {
          if (direction==0)
          {
            out[0] = { 0, -1};
            out[1] = { 0,  1};
            out[2] = { 0,  0};
            out[3] = { 0,  0};
          }
          else
          {
            out[0] = { 0,  0};
            out[1] = { 0,  0};
            out[2] = { -1, 0};
            out[3] = {  1, 0};
          }
        }
 
        if (dim==3)
        {
          switch (direction)
          {
            case 0:
            out[0] = { 0, 0, -1 +in[1]};
            out[1] = { 0, 0,  1 -in[1]};
            out[2] = { 0, 0,    -in[1]};
            out[3] = { 0, 0,     in[1]};
 
            out[4] = { 0, -1 +in[2], 0};
            out[5] = { 0,  1 -in[2], 0};
            out[8] = { 0,    -in[2], 0};
            out[9] = { 0,     in[2], 0};
 
            out[6]  = {0,0,0};
            out[7]  = {0,0,0};
            out[10] = {0,0,0};
            out[11] = {0,0,0};
            break;
 
            case 1:
            out[0]  = { 0, 0, -1 + in[0]};
            out[1]  = { 0, 0,    - in[0]};
            out[2]  = { 0, 0,  1 - in[0]};
            out[3]  = { 0, 0,      in[0]};
 
            out[4]  = {0,0,0};
            out[5]  = {0,0,0};
            out[8]  = {0,0,0};
            out[9]  = {0,0,0};
 
            out[6]  = { -1 + in[2], 0, 0};
            out[7]  = {  1 - in[2], 0, 0};
            out[10] = {    - in[2], 0, 0};
            out[11] = {      in[2], 0, 0};
            break;
 
            case 2:
            out[0]  = {0,0,0};
            out[1]  = {0,0,0};
            out[2]  = {0,0,0};
            out[3]  = {0,0,0};
 
            out[4]  = { 0, -1 + in[0], 0};
            out[5]  = { 0,    - in[0], 0};
            out[8]  = { 0,  1 - in[0], 0};
            out[9]  = { 0,      in[0], 0};
 
            out[6]  = { -1 + in[1], 0, 0};
            out[7]  = {    - in[1], 0, 0};
            out[10] = {  1 - in[1], 0, 0};
            out[11] = {      in[1], 0, 0};
            break;
          }
        }
 
        for (std::size_t i=0; i<out.size(); i++)
          out[i] *= edgeOrientation_[i];
 
      } else if (totalOrder == 2) {
        out.resize(size());
 
        if (dim==2)
          for (std::size_t i = 0; i < size(); ++i)
            for (std::size_t j = 0; j < dim; ++j)
              out[i][j] = 0;
 
        if (dim==3)
        {
          for(size_t i=0; i<out.size(); i++)
            out[i] = { 0, 0, 0};
 
          //case (1,1,0):
          if( order[0] == 1 and order[1]==1)
          {
            out[0] = { 0, 0,  1};
            out[1] = { 0, 0, -1};
            out[2] = { 0, 0, -1};
            out[3] = { 0, 0,  1};
          }
 
          //case (1,0,1):
          if( order[0] == 1 and order[2]==1)
          {
            out[4] = { 0,  1, 0};
            out[5] = { 0, -1, 0};
            out[8] = { 0, -1, 0};
            out[9] = { 0,  1, 0};
          }
 
          //case (0,1,1):
          if( order[1] == 1 and order[2]==1)
          {
            out[6]  = {  1, 0, 0};
            out[7]  = { -1, 0, 0};
            out[10] = { -1, 0, 0};
            out[11] = {  1, 0, 0};
          }
 
          for (std::size_t i=0; i<out.size(); i++)
            out[i] *= edgeOrientation_[i];
        }
 
 
      }else {
        out.resize(size());
        for (std::size_t i = 0; i < size(); ++i)
          for (std::size_t j = 0; j < dim; ++j)
            out[i][j] = 0;
      }
 
    }
 
    unsigned int order() const
    {
      if (dim==2)
        return 2*k-1;
      if (dim==3)
        return 3*k-1;
    }
 
  private:
 
    // Orientations of the cube edges
    std::array<R,numberOfEdges> edgeOrientation_;
  };
 
 
  template <int dim, int k>
  class Nedelec1stKindCubeLocalCoefficients
  {
  public:
    Nedelec1stKindCubeLocalCoefficients ()
    : localKey_(size())
    {
      static_assert(k==1, "Only first-order Nédélec local coefficients are implemented.");
      // Assign all degrees of freedom to edges
      // TODO: This is correct only for first-order Nédélec elements
      for (std::size_t i=0; i<size(); i++)
        localKey_[i] = LocalKey(i,dim-1,0);
    }
 
    std::size_t size() const
    {
      static_assert(dim==2 || dim==3, "Nédélec shape functions are implemented only for 2d and 3d cubes.");
      return (dim==2) ? 2*k * (k+1)
                      : 3*k * (k+1) * (k+1);
    }
 
    const LocalKey& localKey (std::size_t i) const
    {
      return localKey_[i];
    }
 
  private:
    std::vector<LocalKey> localKey_;
  };
 
  template<class LB>
  class Nedelec1stKindCubeLocalInterpolation
  {
    static constexpr auto dim = LB::Traits::dimDomain;
    static constexpr auto size = LB::size();
 
    // Number of edges of the reference cube
    constexpr static std::size_t numberOfEdges = power(2,dim-1)*dim;
 
  public:
 
    Nedelec1stKindCubeLocalInterpolation (std::bitset<numberOfEdges> s = 0)
    {
      auto refElement = Dune::referenceElement<double,dim>(GeometryTypes::cube(dim));
 
      for (std::size_t i=0; i<numberOfEdges; i++)
        m_[i] = refElement.position(i,dim-1);
 
      for (std::size_t i=0; i<numberOfEdges; i++)
      {
        auto vertexIterator = refElement.subEntities(i,dim-1,dim).begin();
        auto v0 = *vertexIterator;
        auto v1 = *(++vertexIterator);
 
        // By default, edges point from the vertex with the smaller index
        // to the vertex with the larger index.
        if (v0>v1)
          std::swap(v0,v1);
        edge_[i] = refElement.position(v1,dim) - refElement.position(v0,dim);
        edge_[i] *= (s[i]) ? -1.0 : 1.0;
      }
    }
 
    template<typename F, typename C>
    void interpolate (const F& ff, std::vector<C>& out) const
    {
      out.resize(size);
      auto&& f = Impl::makeFunctionWithCallOperator<typename LB::Traits::DomainType>(ff);
 
      for (std::size_t i=0; i<size; i++)
      {
        auto y = f(m_[i]);
        out[i] = 0.0;
        for (int j=0; j<dim; j++)
          out[i] += y[j]*edge_[i][j];
      }
    }
 
  private:
    // Edge midpoints of the reference cube
    std::array<typename LB::Traits::DomainType, numberOfEdges> m_;
    // Edges of the reference cube
    std::array<typename LB::Traits::DomainType, numberOfEdges> edge_;
  };
 
}
 
 
  template<class D, class R, int dim, int k>
  class Nedelec1stKindCubeLocalFiniteElement
  {
  public:
    using Traits = LocalFiniteElementTraits<Impl::Nedelec1stKindCubeLocalBasis<D,R,dim,k>,
                                            Impl::Nedelec1stKindCubeLocalCoefficients<dim,k>,
                                            Impl::Nedelec1stKindCubeLocalInterpolation<Impl::Nedelec1stKindCubeLocalBasis<D,R,dim,k> > >;
 
    static_assert(dim==2 || dim==3, "Nedelec elements are only implemented for 2d and 3d elements.");
    static_assert(k==1,   "Nedelec elements of the first kind are currently only implemented for order k==1.");
 
    Nedelec1stKindCubeLocalFiniteElement() = default;
 
    Nedelec1stKindCubeLocalFiniteElement (std::bitset<power(2,dim-1)*dim> s) :
      basis_(s),
      interpolation_(s)
    {}
 
    const typename Traits::LocalBasisType& localBasis () const
    {
      return basis_;
    }
 
    const typename Traits::LocalCoefficientsType& localCoefficients () const
    {
      return coefficients_;
    }
 
    const typename Traits::LocalInterpolationType& localInterpolation () const
    {
      return interpolation_;
    }
 
    static constexpr unsigned int size ()
    {
      return Traits::LocalBasisType::size();
    }
 
    static constexpr GeometryType type ()
    {
      return GeometryTypes::cube(dim);
    }
 
  private:
    typename Traits::LocalBasisType basis_;
    typename Traits::LocalCoefficientsType coefficients_;
    typename Traits::LocalInterpolationType interpolation_;
  };
 
}
 
#endif