solution_transfer.h

// ---------------------------------------------------------------------
//
// Copyright (C) 2009 - 2019 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_solution_transfer_h
#define dealii_distributed_solution_transfer_h

#include <deal.II/base/config.h>

#include <deal.II/distributed/tria.h>

#include <deal.II/dofs/dof_handler.h>

#include <vector>


DEAL_II_NAMESPACE_OPEN

namespace parallel
{
  namespace distributed
  {
    template <int dim,
              typename VectorType,
              typename DoFHandlerType = DoFHandler<dim>>
    class SolutionTransfer
    {
#ifndef DEAL_II_MSVC
      static_assert(dim == DoFHandlerType::dimension,
                    "The dimension explicitly provided as a template "
                    "argument, and the dimension of the DoFHandlerType "
                    "template argument must match.");
#endif
    public:
      SolutionTransfer(const DoFHandlerType &dof);

      ~SolutionTransfer() = default;

      void
      prepare_for_coarsening_and_refinement(
        const std::vector<const VectorType *> &all_in);

      void
      prepare_for_coarsening_and_refinement(const VectorType &in);

      void
      interpolate(std::vector<VectorType *> &all_out);

      void
      interpolate(VectorType &out);

      void
      prepare_for_serialization(const VectorType &in);

      void
      prepare_for_serialization(const std::vector<const VectorType *> &all_in);

      DEAL_II_DEPRECATED
      void
      prepare_serialization(const VectorType &in);

      DEAL_II_DEPRECATED
      void
      prepare_serialization(const std::vector<const VectorType *> &all_in);

      void
      deserialize(VectorType &in);


      void
      deserialize(std::vector<VectorType *> &all_in);

    private:
      SmartPointer<const DoFHandlerType,
                   SolutionTransfer<dim, VectorType, DoFHandlerType>>
        dof_handler;

      std::vector<const VectorType *> input_vectors;

      unsigned int handle;

      std::vector<char>
      pack_callback(
        const typename Triangulation<dim, DoFHandlerType::space_dimension>::
          cell_iterator &cell,
        const typename Triangulation<dim, DoFHandlerType::space_dimension>::
          CellStatus status);

      void
      unpack_callback(
        const typename Triangulation<dim, DoFHandlerType::space_dimension>::
          cell_iterator &cell,
        const typename Triangulation<dim, DoFHandlerType::space_dimension>::
          CellStatus status,
        const boost::iterator_range<std::vector<char>::const_iterator>
          &                        data_range,
        std::vector<VectorType *> &all_out);


      void
      register_data_attach();
    };


  } // namespace distributed
} // namespace parallel



DEAL_II_NAMESPACE_CLOSE

#endif