mg_transfer_global_coarsening.h

Go to the documentation of this file.

// -----------------------------------------------------------------------------
//
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception OR LGPL-2.1-or-later
// Copyright (C) 2020 - 2025 by the deal.II authors
//
// This file is part of the deal.II library.
//
// Detailed license information governing the source code and contributions
// can be found in LICENSE.md and CONTRIBUTING.md at the top level directory.
//
// -----------------------------------------------------------------------------
 
#ifndef dealii_mg_transfer_global_coarsening_h
#define dealii_mg_transfer_global_coarsening_h
 
#include <deal.II/base/config.h>
 
#include <deal.II/grid/tria.h>
 
#include <deal.II/multigrid/mg_transfer_matrix_free.h>
 
 
DEAL_II_NAMESPACE_OPEN
 
// Forward declarations
#ifndef DOXYGEN
namespace RepartitioningPolicyTools
{
  template <int dim, int spacedim>
  class Base;
}
#endif

namespace MGTransferGlobalCoarseningTools
{
  enum class PolynomialCoarseningSequenceType
  {
    bisect,
    decrease_by_one,
    go_to_one
  };

  unsigned int
  create_next_polynomial_coarsening_degree(
    const unsigned int                      degree,
    const PolynomialCoarseningSequenceType &p_sequence);

  std::vector<unsigned int>
  create_polynomial_coarsening_sequence(
    const unsigned int                      max_degree,
    const PolynomialCoarseningSequenceType &p_sequence);

  template <int dim, int spacedim>
  std::vector<std::shared_ptr<const Triangulation<dim, spacedim>>>
  create_geometric_coarsening_sequence(
    const Triangulation<dim, spacedim> &tria);

  template <int dim, int spacedim>
  std::vector<std::shared_ptr<const Triangulation<dim, spacedim>>>
  create_geometric_coarsening_sequence(
    Triangulation<dim, spacedim>                         &tria,
    const RepartitioningPolicyTools::Base<dim, spacedim> &policy,
    const bool preserve_fine_triangulation,
    const bool repartition_fine_triangulation);

  template <int dim, int spacedim>
  std::vector<std::shared_ptr<const Triangulation<dim, spacedim>>>
  create_geometric_coarsening_sequence(
    const Triangulation<dim, spacedim>                   &tria,
    const RepartitioningPolicyTools::Base<dim, spacedim> &policy,
    const bool repartition_fine_triangulation = false);
 
} // namespace MGTransferGlobalCoarseningTools
 
 
template <int dim, typename Number>
using MGTransferMF DEAL_II_DEPRECATED_EARLY = MGTransferMatrixFree<dim, Number>;
 
template <int dim, typename Number>
using MGTransferBlockMF DEAL_II_DEPRECATED_EARLY =
  MGTransferBlockMatrixFree<dim, Number>;
 
template <int dim, typename VectorType>
using MGTransferGlobalCoarsening DEAL_II_DEPRECATED_EARLY =
  MGTransferMatrixFree<dim,
                       typename VectorType::value_type,
                       ::MemorySpace::Host>;
 
template <int dim, typename VectorType>
using MGTransferBlockGlobalCoarsening DEAL_II_DEPRECATED_EARLY =
  MGTransferBlockMatrixFree<dim, typename VectorType::value_type>;
 
 
DEAL_II_NAMESPACE_CLOSE
 
#endif