]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Clarify when RemotePointEvaluation is reinitialized. 16244/head
authorDavid Wells <drwells@email.unc.edu>
Sun, 5 Nov 2023 14:43:06 +0000 (09:43 -0500)
committerDavid Wells <drwells@email.unc.edu>
Sun, 5 Nov 2023 14:45:27 +0000 (09:45 -0500)
include/deal.II/numerics/vector_tools_evaluate.h

index 69ecd574d9b3f4c248cd681b4011c4d4cb177a14..c33c060dd158c9380073017187aa57eeb9cc0ee0 100644 (file)
@@ -68,8 +68,9 @@ namespace VectorTools
   } // namespace EvaluationFlags
 
   /**
-   * Given a (distributed) solution vector @p vector, evaluate the values at
-   * the (arbitrary and even remote) points specified by @p evaluation_points.
+   * Given a (distributed) solution vector @p vector, reinitialize @p cache and
+   * evaluate the values at the (arbitrary and even remote) points specified by
+   * @p evaluation_points.
    *
    * The following code snippet shows the usage of this function. Given
    * a Mapping object, a DoFHandler object, and solution vector as well as a
@@ -80,13 +81,15 @@ namespace VectorTools
    * further function calls (see also the function below).
    *
    * @code
-   * // first usage: set up cache
    * Utilities::MPI::RemotePointEvaluation<dim, spacedim> cache;
    *
+   * // Set up the cache and perform evaluation. This overload always
+   * // reinitializes the RemotePointEvaluation cache object so, typically, it
+   * // should only be called once.
    * const auto result_1 = VectorTools::point_values(
    *   mapping, dof_handler_1, vector_1, evaluation_points, cache);
    *
-   * // further usages: reuse the cache
+   * // This overload does not initialize or reinitialize the cache.
    * const auto result_2 = VectorTools::point_values(
    *   cache, dof_handler_2, vector_2);
    * @endcode

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.