doc/gui/input/scaled_jacobian.rst

   1 .. _scaled_jacobian_page:
   2
   3 ***************
   4 Scaled Jacobian
   5 ***************
   6
   7 The **Scaled Jacobian** mesh quality criteria is a scalar measure of the deviation from the perfect element in the geometrical sense. This measure normalizes the range of reported values between [0,1] for a normal element, the value of 1 is considered a perfect element and 0 a element with a collapsed side. Negative values are also accepted for invalid elements.
   8
   9 The **Scaled Jacobian** is implemented for all volumetric elements (except for polyhedrons, returning 0).
  10
  11 For tetrahedrons and hexahedrons, the formulas are
  12 defined in `The Verdict Library Reference Manual [1] <https://gitlab.kitware.com/third-party/verdict/-/blob/master/SAND2007-2853p.pdf>`_.
  13
  14 For pyramid, the minimum scaled jacobian of the four tetrahedrons formed
  15 in the four vertices of the pyramid base is reported.
  16
  17 For pentahedron, a decomposition into tetrahedron is also done.
  18
  19 For hexahedron prisms, the minimum scaled jacobian between two pentahedrons and one hexahedron is reported.
  20
  21 * Geometrically the Scaled Jacobian of a **tetrahedron** can be understood by the follow figure:
  22
  23         .. image:: ../images/scaled_jacobian_tetra.png
  24                 :align: center
  25
  26         The reported Scaled Jacobian will be 1 if :math:`\alpha=45^{\circ}`
  27
  28 * For **hexadrons** this measure return 1 for the perfect non rotated elements:
  29
  30         .. image:: ../images/scaled_jacobian_hexa.png
  31                 :align: center
  32
  33         The reported Scaled Jacobian will be 1 if :math:`\alpha=0^{\circ}` for all the vertices
  34
  35
  36 *To visualize the Scaled Jacobian quality criterion in your mesh:*
  37
  38 .. |img| image:: ../images/scaled_jacobian.png
  39
  40 #. Display your mesh in the viewer.
  41 #. Choose **Controls > Volume Controls > Scaled Jacobian** or click *"Scaled Jacobian"* button |img| of the toolbar.
  42
  43    Your mesh will be displayed in the viewer with its elements colored according to the applied mesh quality control criterion:
  44
  45         .. image:: ../images/scaled_jacobian_mesh_hexa.png
  46                 :align: center
  47
  48
  49 **See Also** a sample TUI Script of a :ref:`tui_scaled_jacobian` filter.