]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Minor changes to documentation.
authorWolfgang Bangerth <bangerth@math.tamu.edu>
Wed, 12 Aug 2009 03:46:23 +0000 (03:46 +0000)
committerWolfgang Bangerth <bangerth@math.tamu.edu>
Wed, 12 Aug 2009 03:46:23 +0000 (03:46 +0000)
git-svn-id: https://svn.dealii.org/trunk@19232 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/examples/step-32/step-32.cc

index 20dd78f762645a1c3ce69eeb75a2ab1fa74d6dab..037c3a2ed15e82d377f6478e7cd6b359154a3e6e 100644 (file)
@@ -1,6 +1,6 @@
 /* $Id$ */
 /* Author: Martin Kronbichler, Uppsala University,
-   Wolfgang Bangerth, Texas A&M University 2007, 2008, 2009 */
+           Wolfgang Bangerth, Texas A&M University 2007, 2008, 2009 */
 /*                                                                */
 /*    Copyright (C) 2008, 2009 by the deal.II authors */
 /*                                                                */
@@ -264,30 +264,40 @@ namespace LinearSolvers
 
 
                                 // @sect3{Definition of assembly data structures}
-                                // 
-                                // This is a collection of data
-                                // structures that we use for assembly in
-                                // %parallel. The concept of this
-                                // task-based parallelization is
-                                // described in detail @ref MTWorkStream
-                                // "here". Each assembly routine gets two
-                                // sets of data: a Scratch array that
-                                // collects all the classes and arrays
-                                // that are used for the calculation of
-                                // the cell contribution, and a CopyData
-                                // array that keeps local matrices and
-                                // vectors which will be written into the
+                                //
+                                // As described in the introduction, we will
+                                // use the WorkStream mechanism discussed in
+                                // the @ref threads module to parallelize
+                                // operations among the processors of a
+                                // single machine. The WorkStream class
+                                // requires that data is passed around in two
+                                // kinds of data structures, one for scratch
+                                // data and one to pass data from the
+                                // assembly function to the function that
+                                // copies local contributions into global
+                                // objects.
+                                //
+                                // The following namespace (and the two
+                                // sub-namespaces) contains a collection of
+                                // data structures that serve this purpose,
+                                // one pair for each of the four operations
+                                // discussed in the introduction that we will
+                                // want to parallelize. Each
+                                // assembly routine gets two sets of data: a
+                                // Scratch array that collects all the
+                                // classes and arrays that are used for the
+                                // calculation of the cell contribution, and
+                                // a CopyData array that keeps local matrices
+                                // and vectors which will be written into the
                                 // global matrix. Whereas CopyData is a
                                 // container for the final data that is
                                 // written into the global matrices and
-                                // vector (and, thus, absolutely
-                                // necessary), the Scratch arrays are
-                                // merely there for performance reasons
-                                // &mdash; it would be much more
-                                // expensive to set up a FEValues object
-                                // on each cell, than creating it only
-                                // once and updating some derivative
-                                // data.
+                                // vector (and, thus, absolutely necessary),
+                                // the Scratch arrays are merely there for
+                                // performance reasons &mdash; it would be
+                                // much more expensive to set up a FEValues
+                                // object on each cell, than creating it only
+                                // once and updating some derivative data.
                                 //
                                 // Using the program in step-31, we have
                                 // four assembly routines. One for the

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.