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

   1 /*!
   2
   3 \page about_meshes_page About meshes
   4
   5 \n \b MESH represents a discretization of a geometrical CAD model into
   6 a set of entities with a simple topology.
   7
   8 It is possible to \subpage constructing_meshes_page "construct meshes"
   9 on the basis of geometrical shapes produced in the GEOM module.
  10 It is also possible to
  11 \subpage constructing_submeshes_page "construct mesh on a part of the geometrical object",
  12 for example, a face, with different meshing parameters or using
  13 another meshing algorithm than the whole mesh.
  14
  15 Several created meshes can be \subpage building_compounds_page "combined into another mesh".
  16
  17 The whole mesh or its part can be \subpage copy_mesh_page "copied" into another mesh.
  18
  19 Meshing parameters of meshes and sub-meshes can be
  20 \subpage editing_meshes_page "edited", then only the mesh part
  21 depending on the changed parameters will be re-computed.
  22
  23 Meshes can be edited using the MESH functions destined for
  24 \ref modifying_meshes_page "modification" of generated meshes.
  25
  26 Meshes are stored in DAT, MED, UNV, STL, CGNS, GMF and SAUVE formats and can be
  27 \subpage importing_exporting_meshes_page "imported from and exported to"
  28  the file in these formats.
  29
  30 The \b topology of a mesh is described by the relationships between its
  31 entities including:
  32
  33 <ul>
  34 <li>\b Node &mdash; 0D object of a mesh presented by a point with coordinates (x, y, z).</li>
  35 <li>\b 0D element &mdash; element of a mesh defined by one node.</li>
  36 <li>\b Edge &mdash; 1D element of a mesh defined by two nodes.</li>
  37 <li>\b Face &mdash; 2D element of a mesh defined by three or four edges (closed contour).</li>
  38 <li>\b Volume &mdash; 3D element of a mesh defined by several faces.</li>
  39 <li>\b Ball element &mdash; discrete element of a mesh defined by a node and a diameter.</li>
  40 </ul>
  41
  42 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;These entities are
  43 considered as topological entities and they don't
  44 imply any geometric representation. Only \b Nodes reference  geometric
  45 representations of points with definite coordinates. The node entity
  46 contains  additional information about its position in the space
  47 and its relations with the meshed CAD model. Its position could be
  48 described in the following way:
  49
  50 <ul>
  51 <li><b>3D position</b>. It characterizes the position of a node in a
  52   solid geometry and is defined by three coordinates x,y and z and a
  53   reference to the solid geometrical entity. </li>
  54 <li><b>Surface position</b>. It characterizes the position of a node on a
  55   geometric surface and is defined by the u,v position in the parametric
  56   space of the corresponding surface.</li>
  57 <li><b>Line position</b>. It characterizes the position of a node on a
  58   geometric curve and is defined by the u parameter and the
  59   corresponding curve.</li>
  60 <li><b>Vertex position</b>. It characterizes the position of a node on a
  61   geometric point of the meshed CAD model and is defined by the x,y,z
  62   coordinates of the corresponding vertex.</li>
  63 </ul>
  64
  65 <br><h2>Connections</h2>
  66
  67 Each mesh entity bounds 0 or more mesh entities of higher
  68 dimension. In the same way each mesh entity is bounded by 0 or more
  69 mesh entities of lower dimension:
  70
  71 <ul>
  72 <li>A node bounds edges, faces and volumes</li>
  73 <li>An edge bounds faces, and volumes</li>
  74 <li>A face bounds volumes</li>
  75 <li>A volume is bounded by faces, edges and nodes</li>
  76 <li>A face is bounded by edges, and nodes</li>
  77 <li>An edge is bounded by nodes</li>
  78 </ul>
  79
  80 You can notice that there are two types of connections: \b inverse and
  81 \b direct connections.
  82
  83 <br><h2>Inverse connections</h2>
  84
  85 This relationship has a particularity that the order of bounded
  86 entities has not a direct meaning. Also the number of bounded entities
  87 is not fixed.
  88
  89 \b Example: The edges surrounding a node. The 3rd edge has no more
  90 sense that the 5th one.
  91
  92 <br><h2>Direct connections</h2>
  93
  94 This relationship has a particularity that the order of bounding
  95 entities is meaningful. The number of bounding entities is fixed and
  96 depends on the type of the entity (hexahedron, tetrahedron,?).
  97
  98 \b Example: An edge is composed of two nodes. A face is composed of 3
  99 or 4 edges depending if we are dealing with triangles or quadrangles.
 100
 101 The connections are not only restricted to entities of one dimension
 102 higher or lower. For example some algorithms may be interested to
 103 retrieve all the faces surrounding a node.
 104
 105 */