]> https://gitweb.dealii.org/ - dealii.git/commitdiff
more doc
authorGuido Kanschat <dr.guido.kanschat@gmail.com>
Sat, 20 Mar 2010 17:10:50 +0000 (17:10 +0000)
committerGuido Kanschat <dr.guido.kanschat@gmail.com>
Sat, 20 Mar 2010 17:10:50 +0000 (17:10 +0000)
git-svn-id: https://svn.dealii.org/trunk@20869 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/deal.II/include/dofs/block_info.h
deal.II/doc/doxygen/headers/glossary.h

index 26d687c149e02b0cbaaaa85072562ce134b335fe..f802993cabf285e169c5561b18db2812717aa920 100644 (file)
@@ -32,9 +32,30 @@ namespace hp
  * @brief A small class collecting the different BlockIndices involved in
  * global, multilevel and local computations.
  *
- * In addition to grouping all the block indices into a single
- * instance, this class also provides functions to fill them
- * automatically.
+ * Once a DoFHandler has been initialized with an FESystem, a data
+ * object of type BlockInfo (accessed by DoFHandler::block_info() ) is
+ * filled, which reflects the block structure of the degrees of
+ * freedom.
+ *
+ * BlockInfo consists of deveral BlockIndices objects. The member
+ * global() reflects the block structure of the system on the active
+ * cell level, usually referred to as the global system. As soon as
+ * DoFHandler::distribute_dofs() has been called, the function
+ * BlockIndices::block_size() in global() will return the correct
+ * sizes of each block. After DoFRenumbering::block_wise(),
+ * BlockIndices::block_start() will return the start index for each of
+ * the blocks.
+ *
+ * When an MGDoFHandler is used, the same structure is automatically
+ * generated for each level. The level blocks can be accessed through
+ * level().
+ *
+ * Finally, there are local() BlockIndices, which describe the block
+ * structure on a single cell. This is used for instance by
+ * MeshWorker::Assembler::MatrixLocalBlocksToGlobalBlocks. The local
+ * indices are not filled automatically, since they change the
+ * behavior of the MeshWorker::Assembler classes relying on
+ * BlockInfo. They must be initialized by hand through initialize_local().
  *
  * @todo Extend the functions local() and renumber() to the concept to
  * hpDoFHandler.
index 7d579b54fb6b2c2bb5c53574f564c8157eedcf93..09f366581746846396cfc57c4f858acb73d81c34 100644 (file)
@@ -31,7 +31,8 @@
  * structure of a PDE system in linear algebra, in particular allowing
  * for modular solvers for problems with multiple solution components.
  * How to implement this is described in more detail in the
- * @ref vector_valued report and the tutorial programs referenced
+ * documentation of FESystem, the
+ * @ref vector_valued module and the tutorial programs referenced
  * therein.
  *
  * Originally, this concept was intermixed with the idea of the vector

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.