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 Mesh module provides several ways to create the mesh:
   9 <ul>
  10   <li>The main way is to \subpage constructing_meshes_page "construct the mesh"
  11     on the basis of the geometrical shape produced in the Geometry
  12     module. This way implies selection of
  13     - a geometrical object (<em> main shape</em>) and
  14     - <em>meshing parameters</em> (\ref
  15       basic_meshing_algos_page "meshing algorithms" and
  16     characteristics (e.g. element size) of a
  17     required mesh encapsulated in \ref about_hypo_page "hypothesis"
  18     objects).
  19
  20     Construction of \subpage constructing_submeshes_page "sub-meshes"
  21     allows to mesh some sub-shapes of the main shape, for example a face,
  22     using different meshing parameters than other sub-shapes.<br>
  23     Meshing parameters of meshes and sub-meshes can be
  24     \subpage editing_meshes_page "edited". (Upon edition only mesh entities
  25     generated using changed meshing parameters are removed and will be
  26     re-computed).<br>
  27     \note Algorithms and hypotheses used at mesh level are referred as
  28     \a global ones and those used at sub-mesh level are referred as \a
  29     local ones.
  30   </li>
  31   <li>Bottom-up way, using \ref modifying_meshes_page "mesh modification"
  32     operations, especially \ref extrusion_page "extrusion" and \ref
  33     revolution_page "revolution". To create an empty mesh not based on
  34     geometry, use the same dialog as to \ref constructing_meshes_page
  35     "construct the mesh on geometry" but do not specify any geometry
  36     nor meshing algorithm.
  37   </li>
  38   <li>The mesh can be \ref importing_exporting_meshes_page "imported" from
  39     (and exported to) the file in MED, UNV, STL, CGNS, DAT, GMF and
  40     SAUVE formats.
  41   </li>
  42   <li>The 3D mesh can be generated from the 2D mesh, \ref
  43     importing_exporting_meshes_page "imported" or manually created. To
  44     setup the meshing parameters of a mesh not based on geometry, just
  45     invoke \ref editing_meshes_page "Edit mesh / sub-mesh" command on
  46     your 3D mesh.
  47   </li>
  48   <li>Several meshes can be \subpage building_compounds_page "combined"
  49     into a new mesh.
  50   </li>
  51   <li>The whole mesh or its part (sub-mesh or group) can be
  52     \subpage copy_mesh_page "copied" into a new mesh.
  53   </li>
  54   <li>A new mesh can be created from a transformed, e.g. \ref
  55     translation_page "translated", part of the mesh.</li>
  56 </ul>
  57
  58 Meshes can be edited using the MESH functions destined for
  59 \ref modifying_meshes_page "modification" of meshes.
  60
  61
  62 The \b structure of a SALOME mesh is described by nodes and elements based on
  63 these nodes. Geometry of the element is defined by the sequence of
  64 nodes constituting it and
  65 the <a href="http://www.code-aster.org/outils/med/html/connectivites.html">
  66   connectivity convention </a> (adopted from MED library). Definition of
  67 the element basing on elements of lower dimension is NOT supported.
  68
  69 \anchor mesh_entities
  70 The mesh can include the following entities:
  71 <ul>
  72 <li>\b Node &mdash; an entity of a mesh defining a position in 3D
  73   space with coordinates (x, y, z).</li>
  74 <li>\b Edge (or segment) &mdash; 1D element of a mesh linking two nodes.</li>
  75 <li>\b Face &mdash; 2D element of a mesh representing a part of
  76   surface bound by links between face nodes. A face can be a
  77   triangle, quadrangle or polygon.</li>
  78 <li>\b Volume &mdash; 3D element of a mesh representing a part of 3D
  79   space bound by volume facets. Nodes of a volume describing each
  80   facet are defined by
  81   the <a href="http://www.code-aster.org/outils/med/html/connectivites.html">
  82   MED connectivity convention.</a> A volume can be a tetrahedron, hexahedron,
  83   pentahedron, pyramid, hexagonal prism or polyhedron.</li>
  84 <li>\b 0D element &mdash; element of a mesh defined by one node.</li>
  85 <li>\b Ball element &mdash; discrete element of a mesh defined by a
  86   node and a diameter.</li>
  87 </ul>
  88
  89 Every mesh entity has an attribute associating it to a sub-shape it is
  90 generated on (if any). The node generated on the geometrical edge or
  91 surface in addition stores its position in parametric space of the
  92 associated geometrical entity.
  93
  94 SALOME supports elements of second order, without central node
  95 (quadratic triangle, quadrangle, tetrahedron, hexahedron, pentahedron
  96 and pyramid) and with central nodes (bi-quadratic triangle and
  97 quadrangle and tri-quadratic hexahedron).<br>
  98 Quadratic mesh can be obtained in two ways:
  99 - Using a global \ref quadratic_mesh_anchor "Quadratic Mesh"
 100 hypothesis. (Elements with the central node are not generated in this way).
 101 - Using \ref convert_to_from_quadratic_mesh_page operation.
 102
 103 */