From: Peter Munch <peterrmuench@gmail.com>
Date: Thu, 27 May 2021 19:00:45 +0000 (+0200)
Subject: Add some warnings regarding collective calls
X-Git-Tag: v9.4.0-rc1~1324^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6a4ee319875a485cf7a8c4ea04dc10e7bc0c5f43;p=dealii.git

Add some warnings regarding collective calls
---

diff --git a/include/deal.II/base/mpi_remote_point_evaluation.h b/include/deal.II/base/mpi_remote_point_evaluation.h
index 74dc477e78..ff2a74ecb0 100644
--- a/include/deal.II/base/mpi_remote_point_evaluation.h
+++ b/include/deal.II/base/mpi_remote_point_evaluation.h
@@ -68,6 +68,9 @@ namespace Utilities
        * Set up internal data structures and communication pattern based on
        * a list of points @p points and mesh description (@p tria and @p
        * mapping).
+       *
+       * @warning This is a collective call that needs to be executed by all
+       *   processors in the communicator.
        */
       void
       reinit(const std::vector<Point<spacedim>> &points,
@@ -106,6 +109,9 @@ namespace Utilities
        *   might be the case if a point coincides with a geometric entity (e.g.,
        *   vertex) that is shared by multiple cells or a point is outside of the
        *   computational domain.
+       *
+       * @warning This is a collective call that needs to be executed by all
+       *   processors in the communicator.
        */
       template <typename T>
       void
@@ -119,6 +125,9 @@ namespace Utilities
        * This method is the inverse of the method evaluate_and_process(). It
        * makes the data at the points, provided by @p input, available in the
        * function @p evaluation_function.
+       *
+       * @warning This is a collective call that needs to be executed by all
+       *   processors in the communicator.
        */
       template <typename T>
       void
diff --git a/include/deal.II/numerics/vector_tools_evaluate.h b/include/deal.II/numerics/vector_tools_evaluate.h
index 6a53e2ec7a..8a1b1af150 100644
--- a/include/deal.II/numerics/vector_tools_evaluate.h
+++ b/include/deal.II/numerics/vector_tools_evaluate.h
@@ -67,6 +67,9 @@ namespace VectorTools
   /**
    * Given a (distributed) solution vector @p vector, evaluate the values at
    * the (arbitrary and even remote) points specified by @p evaluation_points.
+   *
+   * @warning This is a collective call that needs to be executed by all
+   *   processors in the communicator.
    */
   template <int n_components, int dim, int spacedim, typename VectorType>
   std::vector<typename FEPointEvaluation<n_components, dim>::value_type>
@@ -85,6 +88,9 @@ namespace VectorTools
    *
    * @note Refinement/coarsening/repartitioning leads to the invalidation of the
    *   cache so that the above function has to be called again.
+   *
+   * @warning This is a collective call that needs to be executed by all
+   *   processors in the communicator.
    */
   template <int n_components, int dim, int spacedim, typename VectorType>
   std::vector<typename FEPointEvaluation<n_components, dim>::value_type>