Salome HOME
Porting GUI documentation on Doxygen tool.
[modules/smesh.git] / 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. In MESH there are two
7 options of creation of meshes, you can:
8
9 <ul>
10 <li>generate meshes on the basis of geometrical shapes produced in the GEOM module,</li>
11 <li>create your own meshes using the MESH functions destined for modification of generated meshes.</li>
12 </ul>
13
14 The topology of a mesh is described by the relationships between its
15 entities including:
16
17 <ul>
18 <li>\b Node &mdash; 0D element of a mesh presented by a point with coordinates (x, y, z).</li>
19 <li>\b Edge &mdash; 1D element of a mesh defined by two nodes.</li>
20 <li>\b Face &mdash; 2D element of a mesh defined by three or four edges (closed contour).</li>
21 <li>\b Volume &mdash; 3D element of a mesh defined by several faces.</li>
22 </ul>
23
24 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;These entities are
25 considered as topological entities and they don't
26 imply any geometric representation. Only \b Nodes reference  geometric
27 representations of points with definite coordinates. The node entity
28 will contain  additional information about its position in the space
29 and its relations with the meshed CAD model. Its position could be
30 described in the following way:
31
32 <ul>
33 <li><b>2D position</b>. It is a free position defined by only two coordinates x,y.</li>
34 <li><b>3D position</b>. It is a free position defined by three coordinates x,y and z. </li>
35 <li><b>Surface position</b>. It characterizes the position of a node on a
36 geometric surface and is defined by the u,v position in the parametric
37 space of the corresponding surface.</li>
38 <li><b>Line position</b>. It characterizes the position of a node on a
39 geometric curve and is defined by the u parameter and the
40 corresponding curve.</li>
41 <li><b>Vertex position</b>. It characterizes the position of a node on a
42 geometric point of the meshed CAD model and is defined by the x,y,z
43 coordinates of the corresponding vertex.</li>
44 </ul>
45
46 <br><h2>Connections</h2>
47
48 Each mesh entity bounds 0 or more mesh entities of higher
49 dimension. In the same way each mesh entity is bounded by 0 or more
50 mesh entities of lower dimension:
51
52 <ul>
53 <li>A node bounds edges, faces and volumes</li>
54 <li>An edge bounds faces, and volumes</li>
55 <li>A face bounds volumes</li>
56 <li>A volume is bounded by faces, edges and nodes</li>
57 <li>A face is bounded by edges, and nodes</li>
58 <li>An edge is bounded by nodes</li>
59 </ul>
60
61 You can notice that there are two types of connections: \b inverse and
62 \b direct connections.
63
64 <br><h2>Inverse connections</h2>
65
66 This relationship has a particularity that the order of bounded
67 entities has not a direct meaning. Also the number of bounded entities
68 is not fixed.
69
70 \b Example: The edges surrounding a node. The 3rd edge has no more
71 sense that the 5th one.
72
73 <br><h2>Direct connections</h2>
74
75 This relationship has a particularity that the order of bounding
76 entities is meaningful. The number of bounding entities is fixed and
77 depends on the type of the entity (hexahedron, tetrahedron,?).
78
79 \b Example: An edge is composed of two nodes. A face is composed of 3
80 or 4 edges depending if we are dealing with triangles or quadrangles.
81
82 The connections are not only restricted to entities of one dimension
83 higher or lower. For example some algorithms may be interested to
84 retrieve all the faces surrounding a node.
85
86 */