data_out_faces.h

// ---------------------------------------------------------------------
//
// Copyright (C) 2000 - 2018 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_data_out_faces_h
#define dealii_data_out_faces_h
 
 
#include <deal.II/base/config.h>
 
#include <deal.II/numerics/data_out.h>
 
#include <string>
#include <vector>
 
DEAL_II_NAMESPACE_OPEN
 
 
namespace internal
{
  namespace DataOutFacesImplementation
  {
    template <int dim, int spacedim>
    struct ParallelData
      : public internal::DataOutImplementation::ParallelDataBase<dim, spacedim>
    {
      ParallelData(const unsigned int               n_datasets,
                   const unsigned int               n_subdivisions,
                   const std::vector<unsigned int> &n_postprocessor_outputs,
                   const Mapping<dim, spacedim> &   mapping,
                   const std::vector<
                     std::shared_ptr<::hp::FECollection<dim, spacedim>>>
                     &               finite_elements,
                   const UpdateFlags update_flags);
 
      std::vector<Point<spacedim>> patch_evaluation_points;
    };
  } // namespace DataOutFacesImplementation
} // namespace internal
 
 
template <int dim, typename DoFHandlerType = DoFHandler<dim>>
class DataOutFaces : public DataOut_DoFData<DoFHandlerType,
                                            DoFHandlerType::dimension - 1,
                                            DoFHandlerType::dimension>
{
public:
  static const unsigned int dimension = DoFHandlerType::dimension;
 
  static const unsigned int space_dimension = DoFHandlerType::space_dimension;
 
  using cell_iterator = typename DataOut_DoFData<DoFHandlerType,
                                                 dimension - 1,
                                                 dimension>::cell_iterator;
 
  DataOutFaces(const bool surface_only = true);
 
  virtual void
  build_patches(const unsigned int n_subdivisions = 0);
 
  virtual void
  build_patches(const Mapping<dimension> &mapping,
                const unsigned int        n_subdivisions = 0);
 
  using FaceDescriptor = typename std::pair<cell_iterator, unsigned int>;
 
 
  virtual FaceDescriptor
  first_face();
 
  virtual FaceDescriptor
  next_face(const FaceDescriptor &face);
 
private:
  const bool surface_only;
 
  void
  build_one_patch(
    const FaceDescriptor *cell_and_face,
    internal::DataOutFacesImplementation::ParallelData<dimension, dimension>
      &                                                 data,
    DataOutBase::Patch<dimension - 1, space_dimension> &patch);
};
 
 
DEAL_II_NAMESPACE_CLOSE
 
#endif