dgspace.hh

Go to the documentation of this file.

#ifndef DUNE_FEM_SPACE_LOCALFINITEELEMENT_DGSPACE_HH
#define DUNE_FEM_SPACE_LOCALFINITEELEMENT_DGSPACE_HH
 
#include <cassert>
 
#include <memory>
#include <utility>
#include <vector>
 
#include <dune/geometry/type.hh>
 
#include <dune/fem/gridpart/common/capabilities.hh>
#include <dune/fem/space/basisfunctionset/default.hh>
#include <dune/fem/space/basisfunctionset/transformed.hh>
#include <dune/fem/space/common/defaultcommhandler.hh>
#include <dune/fem/space/common/discretefunctionspace.hh>
#include <dune/fem/space/common/functionspace.hh>
#include <dune/fem/space/mapper/compile.hh>
#include <dune/fem/space/mapper/indexsetdofmapper.hh>
#include <dune/fem/space/mapper/codimensionmapper.hh>
#include <dune/fem/space/shapefunctionset/proxy.hh>
#include <dune/fem/space/shapefunctionset/selectcaching.hh>
#include <dune/fem/space/shapefunctionset/vectorial.hh>
 
#include <dune/fem/space/localfiniteelement/shapefunctionset.hh>
#include <dune/fem/space/localfiniteelement/capabilities.hh>
#include <dune/fem/space/localfiniteelement/interpolation.hh>
 
namespace Dune
{
 
  namespace Fem
  {
 
    // DiscontinuousLocalFiniteElementSpaceTraits
    // ------------------------------------------
    template< class LFEMap, class FunctionSpace, class Storage,
              unsigned int scalarBlockSize >
    struct DiscontinuousLocalFiniteElementSpaceTraits
    {
      typedef DiscontinuousLocalFiniteElementSpace< LFEMap, FunctionSpace, Storage > DiscreteFunctionSpaceType;
 
      typedef LFEMap LFEMapType;
 
      typedef typename LFEMapType::GridPartType GridPartType;
      typedef typename LFEMapType::LocalFiniteElementType LocalFiniteElementType;
 
      typedef GridFunctionSpace< GridPartType, FunctionSpace > FunctionSpaceType;
 
      static constexpr int codimension = 0;
      static constexpr bool isScalar = LocalFiniteElementType::Traits::LocalBasisType::Traits::dimRange==1;
      static constexpr bool fullBlocking = isScalar && scalarBlockSize>1;
 
      typedef std::conditional_t<isScalar,
              Hybrid::IndexRange< int, FunctionSpace::dimRange*scalarBlockSize >,
              Hybrid::IndexRange< int, 1 >
              > LocalBlockIndices;
 
    private:
      typedef typename GridPartType::template Codim< codimension >::EntityType EntityType;
 
    public:
      using BlockMapperType = std::conditional_t<!fullBlocking,
                     IndexSetDofMapper< GridPartType >,
                     CodimensionMapper< GridPartType, codimension > >;
 
      // TODO: need SFINAE since not all LFEMap have a pointSetId
      typedef LocalFunctionsShapeFunctionSet< typename LocalFiniteElementType::Traits::LocalBasisType, LFEMap::pointSetId > LocalFunctionsShapeFunctionSetType;
      typedef SelectCachingShapeFunctionSet< LocalFunctionsShapeFunctionSetType, Storage > StoredShapeFunctionSetType;
 
      typedef ShapeFunctionSetProxy< StoredShapeFunctionSetType > ShapeFunctionSetProxyType;
      // only extend to vector valued in case that the original space is scalar
      typedef std::conditional_t<isScalar,
              VectorialShapeFunctionSet< ShapeFunctionSetProxyType, typename FunctionSpaceType::RangeType >,
              ShapeFunctionSetProxyType
              > ShapeFunctionSetType;
 
    private:
      template< class LFEM >
      static TransformedBasisFunctionSet< EntityType, ShapeFunctionSetType, typename LFEM::TransformationType > basisFunctionSet ( const LFEM & );
 
      static DefaultBasisFunctionSet< EntityType, ShapeFunctionSetType > basisFunctionSet ( ... );
 
    public:
      typedef decltype( basisFunctionSet( std::declval< const LFEMapType & >() ) ) BasisFunctionSetType;
 
      template< class DiscreteFunction, class Operation = DFCommunicationOperation::Copy >
      struct CommDataHandle
      {
        typedef DefaultCommunicationHandler< DiscreteFunction, Operation > Type;
        typedef Operation OperationType;
      };
    };
 
 
 
    // DiscontinuousLocalFiniteElementSpace
    // ------------------------------------
 
    template <class LFEMap,class Enabler>
    struct FixedPolyOrder_
    {
      static const unsigned int scalarBlockSize = 1;
    };
    template <class LFEMap>
    struct FixedPolyOrder_<LFEMap,
      std::enable_if_t<LFEMap::numBasisFunctions>=0, std::true_type> >
    {
      static const unsigned int scalarBlockSize = LFEMap::numBasisFunctions;
      static const unsigned int polynomialOrder = LFEMap::polynomialOrder;
    };
    template <class LFEMap>
    using FixedPolyOrder = FixedPolyOrder_<LFEMap,std::true_type>;
 
    template< class LFEMap, class FunctionSpace, class Storage >
    class DiscontinuousLocalFiniteElementSpace
      : public DiscreteFunctionSpaceDefault<
          DiscontinuousLocalFiniteElementSpaceTraits< LFEMap,
               FunctionSpace, Storage, FixedPolyOrder<LFEMap>::scalarBlockSize > >,
        public FixedPolyOrder<LFEMap>
    {
      typedef DiscontinuousLocalFiniteElementSpace< LFEMap, FunctionSpace, Storage > ThisType;
      typedef DiscreteFunctionSpaceDefault<
        DiscontinuousLocalFiniteElementSpaceTraits< LFEMap, FunctionSpace,
        Storage, FixedPolyOrder<LFEMap>::scalarBlockSize > > BaseType;
 
      typedef typename BaseType::Traits Traits;
 
    public:
      typedef typename BaseType::FunctionSpaceType FunctionSpaceType;
 
      typedef typename BaseType::GridPartType GridPartType;
      typedef typename BaseType::EntityType EntityType;
      typedef typename BaseType::IntersectionType IntersectionType;
 
      typedef typename BaseType::Traits::ShapeFunctionSetType ShapeFunctionSetType;
      typedef typename BaseType::BasisFunctionSetType BasisFunctionSetType;
 
      typedef typename BaseType::BlockMapperType BlockMapperType;
 
      typedef typename Traits::LocalFiniteElementType LocalFiniteElementType;
      // typedef L2LocalFiniteElement< typename Traits::LocalFiniteElementType > LocalFiniteElementType;
 
      typedef typename Traits::LFEMapType LFEMapType;
 
      typedef typename LFEMapType::KeyType KeyType;
 
    private:
      typedef typename LocalFiniteElementType::Traits::LocalBasisType LocalBasisType;
      typedef typename LocalFiniteElementType::Traits::LocalInterpolationType LocalInterpolationType;
      typedef typename LocalFiniteElementType::Traits::LocalCoefficientsType LocalCoefficientsType;
 
      typedef typename Traits::LocalFunctionsShapeFunctionSetType LocalFunctionsShapeFunctionSetType;
 
      struct LFEMapFactory
      {
        static LFEMapType *createObject ( std::pair< GridPartType *, KeyType > key ) { return new LFEMapType( *key.first, key.second ); }
        static void deleteObject ( LFEMapType *object ) { delete object; }
      };
 
      typedef SingletonList< std::pair< GridPartType *, KeyType >, LFEMapType, LFEMapFactory > LFEMapProviderType;
 
      typedef typename Traits::StoredShapeFunctionSetType StoredShapeFunctionSetType;
      typedef std::vector< std::unique_ptr< StoredShapeFunctionSetType > > StoredShapeFunctionSetVectorType;
 
      struct StoredShapeFunctionSetVectorFactory
      {
        static StoredShapeFunctionSetVectorType *createObject ( LFEMapType *lfeMap ) { return new StoredShapeFunctionSetVectorType( lfeMap->size() ); }
        static void deleteObject ( StoredShapeFunctionSetVectorType *object ) { delete object; }
      };
 
      typedef SingletonList< LFEMapType *, StoredShapeFunctionSetVectorType, StoredShapeFunctionSetVectorFactory > StoredShapeFunctionSetVectorProviderType;
 
      struct BlockMapperSingletonFactory
      {
        static BlockMapperType *createObject ( LFEMapType *lfeMap )
        {
          if constexpr (!Traits::fullBlocking)
            return new BlockMapperType( lfeMap->gridPart(),
              [ lfeMap ] ( const auto &refElement ) {
                if( lfeMap->hasCoefficients( refElement.type() ) )
                  return Dune::Fem::generateCodimensionCode( refElement, 0, lfeMap->localCoefficients( refElement.type() ).size() );
                else
                  return Dune::Fem::DofMapperCode();
              } );
          else
            return new BlockMapperType( lfeMap->gridPart() );
        }
 
        static void deleteObject ( BlockMapperType *object ) { delete object; }
      };
 
      typedef SingletonList< LFEMapType *, BlockMapperType, BlockMapperSingletonFactory > BlockMapperProviderType;
 
    public:
      //- internal implementation
      typedef LocalFiniteElementInterpolation< ThisType, LocalInterpolationType, LocalBasisType::dimRange==1 > InterpolationImplType;
 
      typedef LocalFEInterpolationWrapper< ThisType > InterpolationType;
 
      using BaseType::order;
 
      template< class GridPart, std::enable_if_t< std::is_same< GridPart, GridPartType >::value &&std::is_same< KeyType, std::tuple<> >::value, int > = 0 >
      explicit DiscontinuousLocalFiniteElementSpace ( GridPart &gridPart,
                                                      const InterfaceType commInterface = InteriorBorder_All_Interface,
                                                      const CommunicationDirection commDirection = ForwardCommunication )
        : BaseType( gridPart, commInterface, commDirection ),
          lfeMap_( &LFEMapProviderType::getObject( std::make_pair( &gridPart, KeyType() ) ) ),
          storedShapeFunctionSetVector_( &StoredShapeFunctionSetVectorProviderType::getObject( lfeMap_.get() ) ),
          blockMapper_( &BlockMapperProviderType::getObject( lfeMap_.get()))
      {}
 
      template< class GridPart, std::enable_if_t< std::is_same< GridPart, GridPartType >::value && !std::is_same< KeyType, std::tuple<> >::value, int > = 0 >
      explicit DiscontinuousLocalFiniteElementSpace ( GridPart &gridPart, const KeyType &key,
                                                      const InterfaceType commInterface = InteriorBorder_All_Interface,
                                                      const CommunicationDirection commDirection = ForwardCommunication )
        : BaseType( gridPart, commInterface, commDirection ),
          lfeMap_( &LFEMapProviderType::getObject( std::make_pair( &gridPart, key ) ) ),
          storedShapeFunctionSetVector_( &StoredShapeFunctionSetVectorProviderType::getObject( lfeMap_.get() ) ),
          blockMapper_( &BlockMapperProviderType::getObject( lfeMap_.get()) )
      {}
 
      DiscontinuousLocalFiniteElementSpace ( const ThisType & ) = delete;
      DiscontinuousLocalFiniteElementSpace ( ThisType && ) = delete;
 
      ThisType &operator= ( const ThisType & ) = delete;
      ThisType &operator= ( ThisType && ) = delete;
 
      DFSpaceIdentifier type () const { return DGSpace_id; }
 
      BasisFunctionSetType basisFunctionSet ( const EntityType &entity ) const
      {
        return BasisFunctionSetType( entity, shapeFunctionSet( entity ) );
      }
 
      ShapeFunctionSetType shapeFunctionSet ( const EntityType &entity ) const
      {
        return getShapeFunctionSet( (*lfeMap_)( entity ), entity.type() );
      }
 
      bool continuous () const { return false; }
 
      bool continuous ( const IntersectionType &intersection ) const { return false; }
 
      int order () const { return lfeMap_->order(); }
 
      bool multipleGeometryTypes () const { return true; }
 
      BlockMapperType &blockMapper () const { assert( blockMapper_ ); return *blockMapper_; }
 
      InterpolationType interpolation () const
      {
        return InterpolationType( *this );
      }
 
      [[deprecated("Use LocalInterpolation( space ) instead!")]]
      InterpolationImplType interpolation ( const EntityType &entity ) const
      {
        return localInterpolation( entity );
      }
 
      InterpolationImplType localInterpolation ( const EntityType &entity ) const
      {
        auto lfe = (*lfeMap_)( entity );
        return InterpolationImplType( BasisFunctionSetType( entity, getShapeFunctionSet( lfe, entity.type() ) ), std::get< 2 >( lfe ) );
      }
 
      typedef typename LFEMapType::LocalCoefficientsType QuadratureType;
      const QuadratureType& quadrature ( const GeometryType &type ) const
      {
        return (*lfeMap_).localCoefficients(type);
      }
    private:
      ShapeFunctionSetType getShapeFunctionSet ( std::tuple< std::size_t, const LocalBasisType &, const LocalInterpolationType & > lfe, const GeometryType &type ) const
      {
        auto &storedShapeFunctionSet = (*storedShapeFunctionSetVector_)[ std::get< 0 >( lfe ) ];
        if( !storedShapeFunctionSet )
          storedShapeFunctionSet.reset( new StoredShapeFunctionSetType( type, LocalFunctionsShapeFunctionSetType( std::get< 1 >( lfe ) ) ) );
        return ShapeFunctionSetType( storedShapeFunctionSet.get() );
      }
 
      std::unique_ptr< LFEMapType, typename LFEMapProviderType::Deleter > lfeMap_;
      std::unique_ptr< StoredShapeFunctionSetVectorType, typename StoredShapeFunctionSetVectorProviderType::Deleter > storedShapeFunctionSetVector_;
      std::unique_ptr< BlockMapperType, typename BlockMapperProviderType::Deleter > blockMapper_;
    };
 
    template< class LFEMap, class FunctionSpace, class Storage, int newRange >
    struct ToNewDimRangeFunctionSpace<
      DiscontinuousLocalFiniteElementSpace<LFEMap, FunctionSpace, Storage>, newRange>
    {
      typedef DiscontinuousLocalFiniteElementSpace<LFEMap, typename ToNewDimRangeFunctionSpace<FunctionSpace,newRange>::Type, Storage> Type;
    };
    template <class LFEMap, class FunctionSpace, class Storage,
              class NewFunctionSpace>
    struct DifferentDiscreteFunctionSpace<
        DiscontinuousLocalFiniteElementSpace<LFEMap,FunctionSpace,Storage>, NewFunctionSpace>
    {
      typedef DiscontinuousLocalFiniteElementSpace<LFEMap, NewFunctionSpace, Storage > Type;
    };
 
  } // namespace Fem
 
} // namespace Dune
 
#endif // #ifndef DUNE_FEM_SPACE_LOCALFINITEELEMENT_DGSPACE_HH