]> https://gitweb.dealii.org/ - dealii.git/commitdiff
improve documentation of p::d::SolutionTransfer when used with LA::d::Vector 5616/head
authorDenis Davydov <davydden@gmail.com>
Wed, 13 Dec 2017 13:03:15 +0000 (14:03 +0100)
committerDenis Davydov <davydden@gmail.com>
Wed, 13 Dec 2017 13:03:15 +0000 (14:03 +0100)
include/deal.II/distributed/solution_transfer.h

index 17f18729dc233eb5c054c6284a4bce98630dc126..c6e47e19126a8e4712a7298c1e2055c659978967 100644 (file)
@@ -46,7 +46,8 @@ namespace parallel
      * so that all locally_active elements can be read. On the other hand,
      * ghosted vectors are generally not writable, so for calls to
      * interpolate() or deserialize() you need to supply distributed vectors
-     * without ghost elements.
+     * without ghost elements. More precisely, during interpolation the
+     * current algorithm writes into all locally active degrees of freedom.
      *
      * <h3>Transferring a solution</h3> Here VectorType is your favorite
      * vector type, e.g. PETScWrappers::MPI::Vector,
@@ -74,6 +75,15 @@ namespace parallel
      * soltrans.interpolate(interpolated_solution);
      * @endcode
      *
+     * Different from PETSc and Trilinos vectors, LinearAlgebra::distributed::Vector
+     * allows writing into ghost elements. For a ghosted vector the
+     * interpolation step can be accomplished via
+     * @code
+     * interpolated_solution.zero_out_ghosts();
+     * soltrans.interpolate(interpolated_solution);
+     * interpolated_solution.update_ghost_values();
+     * @endcode
+     *
      * <h3>Use for Serialization</h3>
      *
      * This class can be used to serialize and later deserialize a distributed

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.