Documenting the nodal connectivity

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

@@ -72,10 +72,9 @@ Attractive meshing capabilities include:
 
 The \b structure of a SALOME mesh is described by nodes and elements based on
 these nodes. The geometry of an element is defined by the sequence of
-nodes constituting it and
+nodes constituting it and the \ref connectivity_page "connectivity convention"
-the <a href="http://www.code-aster.org/outils/med/html/connectivites.html">
+(adopted from MED library). Definition of the element basing on the elements
-  connectivity convention </a> (adopted from MED library). Definition of
+of a lower dimension is NOT supported.
-the element basing on the elements of a lower dimension is NOT supported.
 
 \anchor mesh_entities
 The mesh can include the following entities:
@@ -89,8 +88,8 @@ The mesh can include the following entities:
 <li>\b Volume &mdash; 3D mesh element representing a part of 3D
   space bound by volume facets. Nodes of a volume describing each
   facet are defined by
-  the <a href="http://www.code-aster.org/outils/med/html/connectivites.html">
+  the \subpage connectivity_page "connectivity convention".
-  MED connectivity convention.</a> A volume can be a tetrahedron, hexahedron,
+  A volume can be a tetrahedron, hexahedron,
   pentahedron, pyramid, hexagonal prism or polyhedron.</li>
 <li>\b 0D element &mdash; mesh element defined by one node.</li>
 <li>\b Ball element &mdash; discrete mesh element defined by a

doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc

@@ -22,8 +22,7 @@
 The convention of nodal connectivity of elements used in SALOME is
 the MED library convention. You can consult the description of
 nodal connectivity of elements in the documentation on MED library or 
-<a href="http://www.code-aster.org/outils/med/html/connectivites.html">
+\ref connectivity_page "here".
-  here </a>.
 
 <em>To add a node or an element to your mesh:</em>
 <ol>

doc/salome/gui/SMESH/input/adding_quadratic_elements.doc

@@ -16,9 +16,8 @@ side, it is a tri-quadratic element (or HEXA27).
 
 The convention of nodal connectivity of elements used in SALOME is
 the MED library convention. You can consult the description of nodal
-connectivity of elements in the documentation on MED library or 
+connectivity of elements in the documentation on MED library or
-<a href="http://www.code-aster.org/outils/med/html/connectivites.html">
+\ref connectivity_page "here".
-  here </a>.
 
 There are several ways to create quadratic elements in your mesh:
 - manually (this way is described below);

doc/salome/gui/SMESH/input/connectivity.doc

@@ -0,0 +1,45 @@
+/*!
+\page connectivity_page Nodal connectivity of elements
+
+The following images show order of nodes in correctly defined elements.
+
+<table>
+  <tr><td> Edge (segment): linear and quadratic<br>
+      \image html connectivity_edge.png </td></tr>
+  <tr><td> Triangle: linear, quadratic and bi-quadratic <br>
+      \image html connectivity_tria.png </td></tr>
+  <tr><td> Quadrangle: linear, quadratic and bi-quadratic <br>
+      \image html connectivity_quad.png </td></tr>
+  <tr><td align="left"> Polygon: linear and quadratic <br>
+      \image html connectivity_polygon.png </td></tr>
+  <tr><td> Tetrahedron: linear and quadratic <br>
+      \image html connectivity_tetra.png </td></tr>
+  <tr><td> Hexahedron: linear, quadratic and tri-quadratic <br>
+      \image html connectivity_hexa.png </td></tr>
+  <tr><td> Pentahedron: linear and quadratic <br>
+      \image html connectivity_penta.png </td></tr>
+  <tr><td> Pyramid: linear and quadratic <br>
+      \image html connectivity_pyramid.png </td></tr>
+  <tr><td> Hexagonal prism <br>
+      \image html connectivity_hex_prism.png </td></tr>
+  <tr><td> Polyhedron is defined by <ul>
+      <li> a sequence of nodes defining all facets</li>
+      <li> a sequence of number of nodes per facet</li>
+      </ul>
+      \b Nodes: <br>
+      Node1_of_Facet1, Node2_of_Facet1, ..., NodeN_of_Facet1, <br>
+      Node1_of_Facet2, Node2_of_Facet2, ..., NodeN_of_Facet2, <br>
+      Node1_of_FacetM, Node2_of_FacetM, ..., NodeN_of_FacetM  <br>
+      \b Quantity of nodes per facet: <br>
+      NbNodes_in_Facet1, NbNodes_in_Facet2, ..., NbNodes_in_FacetM
+
+      For example the polyhedron shown in the image below is defined by nodes <br>
+      [ 1,2,3, 1,4,5,2, 2,5,6,3, 3,6,4,1, 4,7,9,5, 5,9,8,6, 6,8,7,4, 7,8,9 ]<br>
+      and quantities [ 3, 4, 4, 4, 4, 4, 4, 3 ]
+      \image html connectivity_polyhedron.png
+      Order of nodes of a facet must assure outward direction of its normal.
+  </td></tr>
+</table>
+
+
+*/