From: Peter Munch 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> &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 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 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 std::vector::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 std::vector::value_type>