cell_weights.h

Go to the documentation of this file.

// ---------------------------------------------------------------------
//
// Copyright (C) 2018 - 2021 by the deal.II authors
//
// This file is part of the deal.II library.
//
// The deal.II library is free software; you can use it, redistribute
// it, and/or modify it under the terms of the GNU Lesser General
// Public License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// The full text of the license can be found in the file LICENSE.md at
// the top level directory of deal.II.
//
// ---------------------------------------------------------------------
 
#ifndef dealii_distributed_cell_weights_h
#define dealii_distributed_cell_weights_h
 
#include <deal.II/base/config.h>
 
#include <deal.II/distributed/tria_base.h>
 
#include <deal.II/dofs/dof_handler.h>
 
 
DEAL_II_NAMESPACE_OPEN
 
namespace parallel
{
  template <int dim, int spacedim = dim>
  class CellWeights
  {
  public:
    using WeightingFunction = std::function<
      unsigned int(const typename DoFHandler<dim, spacedim>::cell_iterator &,
                   const FiniteElement<dim, spacedim> &)>;
 
    CellWeights(const ::DoFHandler<dim, spacedim> &dof_handler,
                const WeightingFunction &                weighting_function);
 
    ~CellWeights();
 
    void
    reinit(const DoFHandler<dim, spacedim> &dof_handler,
           const WeightingFunction &        weighting_function);
 
    static std::function<unsigned int(
      const typename ::Triangulation<dim, spacedim>::cell_iterator &cell,
      const typename ::Triangulation<dim, spacedim>::CellStatus status)>
    make_weighting_callback(const DoFHandler<dim, spacedim> &dof_handler,
                            const WeightingFunction &weighting_function);
 
    static WeightingFunction
    constant_weighting(const unsigned int factor = 1000);
 
    static WeightingFunction
    ndofs_weighting(const std::pair<float, float> &coefficients);
 
    static WeightingFunction
    ndofs_weighting(const std::vector<std::pair<float, float>> &coefficients);
 
    DEAL_II_DEPRECATED
    CellWeights(const ::DoFHandler<dim, spacedim> &dof_handler);
 
    DEAL_II_DEPRECATED void
    register_constant_weighting(const unsigned int factor = 1000);
 
    DEAL_II_DEPRECATED void
    register_ndofs_weighting(const unsigned int factor = 1000);
 
    DEAL_II_DEPRECATED void
    register_ndofs_squared_weighting(const unsigned int factor = 1000);
 
    DEAL_II_DEPRECATED void
    register_custom_weighting(
      const std::function<
        unsigned int(const FiniteElement<dim, spacedim> &,
                     const typename DoFHandler<dim, spacedim>::cell_iterator &)>
        custom_function);
 
  private:
    DEAL_II_DEPRECATED
    SmartPointer<const ::DoFHandler<dim, spacedim>, CellWeights>
      dof_handler;
 
    DEAL_II_DEPRECATED
    SmartPointer<const parallel::TriangulationBase<dim, spacedim>, CellWeights>
      triangulation;
 
    boost::signals2::connection connection;
 
    static unsigned int
    weighting_callback(
      const typename ::Triangulation<dim, spacedim>::cell_iterator &cell,
      const typename ::Triangulation<dim, spacedim>::CellStatus status,
      const DoFHandler<dim, spacedim> &                 dof_handler,
      const parallel::TriangulationBase<dim, spacedim> &triangulation,
      const WeightingFunction &                         weighting_function);
  };
} // namespace parallel
 
 
DEAL_II_NAMESPACE_CLOSE
 
#endif