]> https://gitweb.dealii.org/ - dealii.git/commitdiff
add a note
authorMatthias Maier <tamiko@43-1.org>
Fri, 15 Sep 2017 15:50:02 +0000 (10:50 -0500)
committerMatthias Maier <tamiko@43-1.org>
Sun, 17 Sep 2017 20:26:40 +0000 (15:26 -0500)
include/deal.II/fe/fe.h

index d9deb79c06f800e550645f734f60c3dc0e5cb78f..a5a28e3c9c82e74e8d2830062588207bb7c5fb33 100644 (file)
@@ -2046,10 +2046,11 @@ public:
 
 
   /**
-   * Given the values of a function $f(\mathbf x)$ at the (generalized) support
-   * points, this function then computes what the nodal values of the element
-   * are, i.e., $\Psi_i[f]$, where $\Psi_i$ are the node functionals of
-   * the element (see also @ref GlossNodes "Node values or node functionals").
+   * Given the values of a function $f(\mathbf x)$ at the (generalized)
+   * support points of the reference cell, this function then computes what
+   * the nodal values of the element are, i.e., $\Psi_i[f]$, where $\Psi_i$
+   * are the node functionals of the element
+   * (see also @ref GlossNodes "Node values or node functionals").
    * The values $\Psi_i[f]$ are then the expansion coefficients
    * for the shape functions of the finite element function that
    * <i>interpolates</i> the given function $f(x)$, i.e.,
@@ -2106,6 +2107,11 @@ public:
    * @param[out] nodal_values An array of size @p dofs_per_cell that contains
    *   the node functionals of the element applied to the given function.
    *
+   * @note It is safe to call this function for (transformed) values on the
+   * real cell only for elements with trivial MappingType. For all other
+   * elements (for example for H(curl), or H(div) conforming elements)
+   * vector values have to be transformed to the reference cell first.
+   *
    * @note Given what the function is supposed to do, the function clearly
    * can only work for elements that actually implement (generalized) support
    * points. Elements that do not have generalized support points -- e.g.,

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.