]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Improve documentation of FEEvaluationBaseData::inverse_jacobian 11037/head
authorMartin Kronbichler <kronbichler@lnm.mw.tum.de>
Mon, 12 Oct 2020 08:11:13 +0000 (10:11 +0200)
committerMartin Kronbichler <kronbichler@lnm.mw.tum.de>
Mon, 12 Oct 2020 08:11:13 +0000 (10:11 +0200)
include/deal.II/matrix_free/fe_evaluation.h

index 187f22d840eee1fb2a9a9a76dc751287fb886277..a05f3db31b121f917d0f64a6a86642cfcd44dba9 100644 (file)
@@ -135,10 +135,15 @@ public:
   JxW(const unsigned int q_point) const;
 
   /**
-   * Return the inverse and transposed version of Jacobian of the mapping
-   * between the unit to the real cell (representing the covariant
-   * transformation). This is exactly the matrix used internally to transform
-   * the unit cell gradients to gradients on the real cell.
+   * Return the inverse and transposed version $J^{-\mathrm T}$ of the
+   * Jacobian of the mapping between the unit to the real cell defined as
+   * $J_{ij} = d x_i / d\hat x_j$. The $(i,j)$ entry of the returned tensor
+   * contains $d\hat x_j/dx_i$, i.e., columns refer to reference space
+   * coordinates and rows to real cell coordinates. Thus, the returned tensor
+   * represents a covariant transformation, which is used in the
+   * FEEvaluationBase::get_gradient() function to transform the unit cell
+   * gradients to gradients on the real cell by a multiplication $J^{-\mathrm
+   * T} \hat{\nabla} u_h$.
    */
   Tensor<2, dim, VectorizedArrayType>
   inverse_jacobian(const unsigned int q_point) 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.