]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Minor doc adjustments. 13495/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Sun, 6 Mar 2022 03:16:58 +0000 (20:16 -0700)
committerWolfgang Bangerth <bangerth@colostate.edu>
Sun, 6 Mar 2022 03:16:58 +0000 (20:16 -0700)
include/deal.II/base/quadrature_lib.h
include/deal.II/grid/reference_cell.h

index 6832c428a17e6e447e4eb563cbcb2ed02178f2d6..d58afc17ecc08bb02671202a442e3d5afcf7d781 100644 (file)
@@ -588,6 +588,9 @@ public:
  *
  * No transformation is applied to the weights, and the weights referring to
  * points that live outside the reference simplex are simply discarded.
+ * Because this leads to (or *may* lead to) a sum of quadrature weights that
+ * do not equal the area of the simplex, the resulting quadrature formula
+ * is not useful for actually computing integrals.
  *
  * The main use of this quadrature formula is not to chop tensor product
  * quadratures. Ideally you should pass to this class a quadrature formula
index 53beb6fb7ba18703071723ceccd965ba34d41800..8bc55b156a0c33472966663e16c4c22065970720 100644 (file)
@@ -205,9 +205,16 @@ public:
 
   /**
    * Return a quadrature rule with the support points of the given reference
-   * cell.
+   * cell. For 1d line segments, this corresponds to the quadrature points
+   * of the trapezoidal rule, which by taking tensor products easily
+   * generalizes also to other hypercube elements (see also QTrapezoid).
+   * For all reference cell shapes, the quadrature points are ordered
+   * in the same order as the vertices of the reference cell.
    *
-   * @note The weights of the quadrature object are left unfilled.
+   * @note The weights of the quadrature object are left unfilled and
+   *   consequently the object cannot usefully be used for actually
+   *   computing integrals. This is in contrast to, for example, the QTrapez
+   *   class that correctly sets quadrature weights.
    */
   template <int dim>
   const Quadrature<dim> &

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.