From: eap Date: Wed, 22 Jun 2016 12:45:22 +0000 (+0300) Subject: Documenting the nodal connectivity X-Git-Tag: V8_1_0a1~8 X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=b582abf7fad6880971653f3764d643f6c9805b53;p=modules%2Fsmesh.git Documenting the nodal connectivity --- diff --git a/doc/salome/gui/SMESH/images/connectivity_edge.png b/doc/salome/gui/SMESH/images/connectivity_edge.png new file mode 100644 index 000000000..9d7af870a Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_edge.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_hex_prism.png b/doc/salome/gui/SMESH/images/connectivity_hex_prism.png new file mode 100644 index 000000000..d5cbfcd52 Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_hex_prism.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_hexa.png b/doc/salome/gui/SMESH/images/connectivity_hexa.png new file mode 100644 index 000000000..326b3efaa Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_hexa.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_penta.png b/doc/salome/gui/SMESH/images/connectivity_penta.png new file mode 100644 index 000000000..1990a1d91 Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_penta.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_polygon.png b/doc/salome/gui/SMESH/images/connectivity_polygon.png new file mode 100644 index 000000000..359417823 Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_polygon.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_polyhedron.png b/doc/salome/gui/SMESH/images/connectivity_polyhedron.png new file mode 100644 index 000000000..c59506f0a Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_polyhedron.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_pyramid.png b/doc/salome/gui/SMESH/images/connectivity_pyramid.png new file mode 100644 index 000000000..40cc35a58 Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_pyramid.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_quad.png b/doc/salome/gui/SMESH/images/connectivity_quad.png new file mode 100644 index 000000000..0b7cdd3fb Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_quad.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_tetra.png b/doc/salome/gui/SMESH/images/connectivity_tetra.png new file mode 100644 index 000000000..cd86363d9 Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_tetra.png differ diff --git a/doc/salome/gui/SMESH/images/connectivity_tria.png b/doc/salome/gui/SMESH/images/connectivity_tria.png new file mode 100644 index 000000000..593ff05d3 Binary files /dev/null and b/doc/salome/gui/SMESH/images/connectivity_tria.png differ diff --git a/doc/salome/gui/SMESH/input/about_meshes.doc b/doc/salome/gui/SMESH/input/about_meshes.doc index 2795d885e..b58293d6a 100644 --- a/doc/salome/gui/SMESH/input/about_meshes.doc +++ b/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 -the - connectivity convention (adopted from MED library). Definition of -the element basing on the elements of a lower dimension is NOT supported. +nodes constituting it and the \ref connectivity_page "connectivity convention" +(adopted from MED library). Definition of 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:
  • \b Volume — 3D mesh element representing a part of 3D space bound by volume facets. Nodes of a volume describing each facet are defined by - the - MED connectivity convention. A volume can be a tetrahedron, hexahedron, + the \subpage connectivity_page "connectivity convention". + A volume can be a tetrahedron, hexahedron, pentahedron, pyramid, hexagonal prism or polyhedron.
  • \b 0D element — mesh element defined by one node.
  • \b Ball element — discrete mesh element defined by a diff --git a/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc b/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc index 855b7e5ea..173db3ce1 100644 --- a/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc +++ b/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 - - here . +\ref connectivity_page "here". To add a node or an element to your mesh:
      diff --git a/doc/salome/gui/SMESH/input/adding_quadratic_elements.doc b/doc/salome/gui/SMESH/input/adding_quadratic_elements.doc index 2fd906baf..912e59baa 100644 --- a/doc/salome/gui/SMESH/input/adding_quadratic_elements.doc +++ b/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 - - here . +connectivity of elements in the documentation on MED library or +\ref connectivity_page "here". There are several ways to create quadratic elements in your mesh: - manually (this way is described below); diff --git a/doc/salome/gui/SMESH/input/connectivity.doc b/doc/salome/gui/SMESH/input/connectivity.doc new file mode 100644 index 000000000..28c863ff5 --- /dev/null +++ b/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. + + + + + + + + + + + + +
      Edge (segment): linear and quadratic
      + \image html connectivity_edge.png
      Triangle: linear, quadratic and bi-quadratic
      + \image html connectivity_tria.png
      Quadrangle: linear, quadratic and bi-quadratic
      + \image html connectivity_quad.png
      Polygon: linear and quadratic
      + \image html connectivity_polygon.png
      Tetrahedron: linear and quadratic
      + \image html connectivity_tetra.png
      Hexahedron: linear, quadratic and tri-quadratic
      + \image html connectivity_hexa.png
      Pentahedron: linear and quadratic
      + \image html connectivity_penta.png
      Pyramid: linear and quadratic
      + \image html connectivity_pyramid.png
      Hexagonal prism
      + \image html connectivity_hex_prism.png
      Polyhedron is defined by
        +
      • a sequence of nodes defining all facets
        • +
      • a sequence of number of nodes per facet
        • +
      + \b Nodes:
      + Node1_of_Facet1, Node2_of_Facet1, ..., NodeN_of_Facet1,
      + Node1_of_Facet2, Node2_of_Facet2, ..., NodeN_of_Facet2,
      + Node1_of_FacetM, Node2_of_FacetM, ..., NodeN_of_FacetM
      + \b Quantity of nodes per facet:
      + NbNodes_in_Facet1, NbNodes_in_Facet2, ..., NbNodes_in_FacetM + + For example the polyhedron shown in the image below is defined by nodes
      + [ 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 ]
      + 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. +
      + + +*/