cell_weights.h

Go to the documentation of this file.

// ---------------------------------------------------------------------
//
// Copyright (C) 2018 - 2020 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/hp/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 hp::DoFHandler<dim, spacedim>::cell_iterator &,
      const FiniteElement<dim, spacedim> &)>;

    CellWeights(const hp::DoFHandler<dim, spacedim> &dof_handler,
                const WeightingFunction &            weighting_function);

    ~CellWeights();

    void
    reinit(const hp::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 hp::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 hp::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 hp::DoFHandler<dim, spacedim>::cell_iterator &)>
        custom_function);

  private:
    DEAL_II_DEPRECATED
    SmartPointer<const ::hp::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 hp::DoFHandler<dim, spacedim> &                       dof_handler,
      const parallel::TriangulationBase<dim, spacedim> &          triangulation,
      const WeightingFunction &weighting_function);
  };
} // namespace parallel


DEAL_II_NAMESPACE_CLOSE

#endif