doc/salome/gui/SMESH/input/about_meshes.doc

   1 /*!
   2
   3 \page about_meshes_page About meshes
   4
   5 \n \b MESH represents a discrete approximation of a subset of the
   6 three-dimensional space by \ref mesh_entities "elementary geometrical elements".
   7
   8 A SALOME study can contain multiple meshes, but they do not
   9 implicitly compose one super-mesh, and finally each of them
  10 can be used (e.g. exported) only individually.
  11
  12 Mesh module provides several ways to create the mesh:
  13 <ul>
  14   <li>The main way is to \subpage constructing_meshes_page "construct the mesh"
  15     on the basis of the geometrical shape produced in the Geometry
  16     module. This way implies selection of
  17     - a geometrical object (<em>main shape</em>) and
  18     - <em>meshing parameters</em> (\ref
  19       basic_meshing_algos_page "meshing algorithms" and
  20     characteristics (e.g. element size) of a
  21     required mesh encapsulated in \ref about_hypo_page "hypothesis"
  22     objects).
  23
  24     Construction of \subpage constructing_submeshes_page "sub-meshes"
  25     allows to discretize some sub-shapes of the main shape, for example a face,
  26     using the meshing parameters that differ from those used for other sub-shapes.<br>
  27     Meshing parameters of meshes and sub-meshes can be
  28     \subpage editing_meshes_page "edited". (Upon edition only mesh entities
  29     generated using changed meshing parameters are removed and will be
  30     re-computed).<br>
  31     \note Algorithms and hypotheses used at mesh level are referred to as
  32     \a global ones and those used at sub-mesh level are referred to as \a
  33     local ones.
  34   </li>
  35   <li>Bottom-up way, using \ref modifying_meshes_page "mesh modification"
  36     operations, especially \ref extrusion_page "extrusion" and \ref
  37     revolution_page "revolution". To create an empty mesh not based on
  38     geometry, use the same dialog as to \ref constructing_meshes_page
  39     "construct the mesh on geometry" but specify neither the geometry
  40     nor meshing algorithms.
  41   </li>
  42   <li>The mesh can be \subpage importing_exporting_meshes_page "imported" from
  43     (and exported to) the file in MED, UNV, STL, CGNS, DAT, GMF and
  44     SAUVE formats.
  45   </li>
  46   <li>The 3D mesh can be generated from the 2D mesh not based on geometry,
  47     which was either \ref importing_exporting_meshes_page "imported" or created in
  48     other way. To setup the meshing parameters of a mesh not based on geometry,
  49     just invoke \ref editing_meshes_page "Edit mesh / sub-mesh" command on
  50     your 2D mesh.
  51   </li>
  52   <li>Several meshes can be \subpage building_compounds_page "combined"
  53     into a new mesh.
  54   </li>
  55   <li>The whole mesh or its part (sub-mesh or group) can be
  56     \subpage copy_mesh_page "copied" into a new mesh.
  57   </li>
  58   <li>A new mesh can be created from a transformed, e.g. \ref
  59     translation_page "translated", part of the mesh.</li>
  60 </ul>
  61
  62 Meshes can be edited using the MESH functions destined for
  63 \ref modifying_meshes_page "modification" of meshes.
  64
  65 Attractive meshing capabilities include:
  66 - 3D and 2D \ref viscous_layers_anchor "Viscous Layers" (boundary
  67   layers of highly stretched elements beneficial for high quality
  68   viscous computations);
  69 - automatic conformal transition between tetrahedral and hexahedral
  70   sub-meshes.
  71
  72 The \b structure of a SALOME mesh is described by nodes and elements based on
  73 these nodes. The geometry of an element is defined by the sequence of
  74 nodes constituting it and the \ref connectivity_page "connectivity convention"
  75 (adopted from MED library). Definition of the element basing on the elements
  76 of a lower dimension is NOT supported.
  77
  78 \anchor mesh_entities
  79 The mesh can include the following entities:
  80 <ul>
  81 <li>\b Node &mdash; a mesh entity defining a position in 3D
  82   space with coordinates (x, y, z).</li>
  83 <li>\b Edge (or segment) &mdash; 1D mesh element linking two nodes.</li>
  84 <li>\b Face &mdash; 2D mesh element representing a part of
  85   surface bound by links between face nodes. A face can be a
  86   triangle, quadrangle or polygon.</li>
  87 <li>\b Volume &mdash; 3D mesh element representing a part of 3D
  88   space bound by volume facets. Nodes of a volume describing each
  89   facet are defined by
  90   the \subpage connectivity_page "connectivity convention".
  91   A volume can be a tetrahedron, hexahedron,
  92   pentahedron, pyramid, hexagonal prism or polyhedron.</li>
  93 <li>\b 0D element &mdash; mesh element defined by one node.</li>
  94 <li>\b Ball element &mdash; discrete mesh element defined by a
  95   node and a diameter.</li>
  96 </ul>
  97
  98 Every mesh entity has an attribute associating it to a sub-shape it is
  99 generated on (if any). The node generated on the geometrical edge or
 100 surface in addition stores its position in parametric space of the
 101 associated geometrical entity. This attribute is set up by meshing
 102 algorithms generating elements and nodes.
 103
 104 Mesh entities are identified by integer IDs starting from 1.
 105 Nodes and elements are counted separately, i.e. there can be a node
 106 and element with the same ID.
 107
 108 SALOME supports elements of second order, without a central node
 109 (quadratic triangle, quadrangle, polygon, tetrahedron, hexahedron,
 110 pentahedron and pyramid) and with central nodes (bi-quadratic triangle
 111 and quadrangle and tri-quadratic hexahedron).<br>
 112 Quadratic mesh can be obtained in three ways:
 113 - Using a global \ref quadratic_mesh_anchor "Quadratic Mesh"
 114 hypothesis. (Elements with the central node are not generated in this way).
 115 - Using \ref convert_to_from_quadratic_mesh_page operation.
 116 - Using an appropriate option of some meshing algorithms, which
 117 generate elements of several dimensions starting from mesh segments.
 118 */