]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Augment documentation
authorMartin Kronbichler <kronbichler@lnm.mw.tum.de>
Tue, 5 Jan 2016 17:44:41 +0000 (18:44 +0100)
committerMartin Kronbichler <kronbichler@lnm.mw.tum.de>
Wed, 6 Jan 2016 18:00:38 +0000 (19:00 +0100)
include/deal.II/multigrid/mg_transfer.h

index 89e3f57360cb2f7dec72ff087c218a436a00a0c8..2dc701135f89acc5a5f7a46d9bee7544427fa624 100644 (file)
@@ -460,10 +460,36 @@ public:
   template <int dim, int spacedim>
   void build_matrices (const DoFHandler<dim,spacedim> &mg_dof);
 
+  /**
+   * Prolongate a vector from level <tt>to_level-1</tt> to level
+   * <tt>to_level</tt> using the embedding matrices of the underlying finite
+   * element. The previous content of <tt>dst</tt> is overwritten.
+   *
+   * @arg src is a vector with as many elements as there are degrees of
+   * freedom on the coarser level involved.
+   *
+   * @arg dst has as many elements as there are degrees of freedom on the
+   * finer level.
+   */
   virtual void prolongate (const unsigned int to_level,
                            VectorType         &dst,
                            const VectorType   &src) const;
 
+  /**
+   * Restrict a vector from level <tt>from_level</tt> to level
+   * <tt>from_level-1</tt> using the transpose operation of the @p prolongate
+   * method. If the region covered by cells on level <tt>from_level</tt> is
+   * smaller than that of level <tt>from_level-1</tt> (local refinement), then
+   * some degrees of freedom in <tt>dst</tt> are active and will not be
+   * altered. For the other degrees of freedom, the result of the restriction
+   * is added.
+   *
+   * @arg src is a vector with as many elements as there are degrees of
+   * freedom on the finer level involved.
+   *
+   * @arg dst has as many elements as there are degrees of freedom on the
+   * coarser level.
+   */
   virtual void restrict_and_add (const unsigned int from_level,
                                  VectorType         &dst,
                                  const VectorType   &src) const;

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.