]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Clarify documentation of p::s::T. 14136/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Fri, 15 Jul 2022 02:52:32 +0000 (20:52 -0600)
committerWolfgang Bangerth <bangerth@colostate.edu>
Fri, 15 Jul 2022 02:52:32 +0000 (20:52 -0600)
include/deal.II/distributed/shared_tria.h

index 65128423902bd301c7015ef6a2f9bc7e31fb3b5d..f9d56f08398d8806c2485a3443f086e75d94e943 100644 (file)
@@ -69,9 +69,16 @@ namespace parallel
      * about cells owned by other processors with the exception of a single
      * layer of ghost cells around their own part of the domain.
      *
-     * Active cells need to be flagged for refinement or coarsening
-     * locally owned cells. The relevant information is gathered for
-     * ghost and artificial cells internally via MPI communication.
+     * Because every MPI process has a complete copy of the entire mesh
+     * as if it were stored on only this process, it needs to know for
+     * every active cell whether it is flagged for refinement or coarsening
+     * when doing mesh refinement via
+     * Triangulation::execute_coarsening_and_refinement(). In practice,
+     * each process only needs to set this information for its own
+     * "locally owned" cells; upon calling
+     * Triangulation::execute_coarsening_and_refinement(), the
+     * relevant information is then exchanged between processes
+     * internally, via MPI communication.
      *
      * The class is also useful in cases where compute time and memory
      * considerations dictate that the program needs to be run in parallel,

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.