X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fabout_meshes.doc;h=003258f37884bc84659434e6861c836b47ebfa8c;hp=3864329e427815fdcdcf7666436b65f16a345c55;hb=287b2ac10eee586fb10a950958023b05aa008407;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813
diff --git a/doc/salome/gui/SMESH/input/about_meshes.doc b/doc/salome/gui/SMESH/input/about_meshes.doc
index 3864329e4..003258f37 100644
--- a/doc/salome/gui/SMESH/input/about_meshes.doc
+++ b/doc/salome/gui/SMESH/input/about_meshes.doc
@@ -2,85 +2,119 @@
\page about_meshes_page About meshes
-\n \b MESH represents a discretization of a geometrical CAD model into
-a set of entities with a simple topology. In MESH there are two
-options of creation of meshes, you can:
+\n \b MESH represents a discrete approximation of a subset of the
+three-dimensional space by \ref mesh_entities "elementary geometrical
+elements".
-
-- generate meshes on the basis of geometrical shapes produced in the GEOM module,
-- create your own meshes using the MESH functions destined for modification of generated meshes.
-
-
-The topology of a mesh is described by the relationships between its
-entities including:
+A SALOME study can contain multiple meshes, but they do not
+implicitly compose one super-mesh, and finally each of them
+can be used (e.g. exported) only individually.
+Mesh module provides several ways to create the mesh:
-- \b Node — 0D object of a mesh presented by a point with coordinates (x, y, z).
-- \b Edge — 1D element of a mesh defined by two nodes.
-- \b Face — 2D element of a mesh defined by three or four edges (closed contour).
-- \b Volume — 3D element of a mesh defined by several faces.
+ - The main way is to \subpage constructing_meshes_page "construct the mesh"
+ on the basis of the geometrical shape produced in the Geometry
+ module. This way implies selection of
+ - a geometrical object (main shape) and
+ - meshing parameters (\ref
+ basic_meshing_algos_page "meshing algorithms" and
+ characteristics (e.g. element size) of a
+ required mesh encapsulated in \ref about_hypo_page "hypothesis"
+ objects).
+
+ Construction of \subpage constructing_submeshes_page "sub-meshes"
+ allows to discretize some sub-shapes of the main shape, for example a face,
+ using the meshing parameters that differ from those used for other sub-shapes.
+ Meshing parameters of meshes and sub-meshes can be
+ \subpage editing_meshes_page "edited". (Upon edition only mesh entities
+ generated using changed meshing parameters are removed and will be
+ re-computed).
+ \note Algorithms and hypotheses used at mesh level are referred to as
+ \a global ones and those used at sub-mesh level are referred to as \a
+ local ones.
+
+ - Bottom-up way, using \ref modifying_meshes_page "mesh modification"
+ operations, especially \ref extrusion_page "extrusion" and \ref
+ revolution_page "revolution". To create an empty mesh not based on a
+ geometry, use the same dialog as to \ref constructing_meshes_page
+ "construct the mesh on geometry" but specify neither the geometry
+ nor meshing algorithms.
+
+ - The mesh can be \subpage importing_exporting_meshes_page "imported" from
+ (and exported to) the file in MED, UNV, STL, CGNS, DAT, GMF and
+ SAUVE formats.
+
+ - The 3D mesh can be generated from the 2D mesh not based on the geometry,
+ which was either \ref importing_exporting_meshes_page "imported" or created in
+ other way. To setup the meshing parameters of a mesh not based on a geometry,
+ just invoke \ref editing_meshes_page "Edit mesh / sub-mesh" command on
+ your 2D mesh.
+
+ - Several meshes can be \subpage building_compounds_page "combined"
+ into a new mesh.
+
+ - The whole mesh or its part (sub-mesh or group) can be
+ \subpage copy_mesh_page "copied" into a new mesh.
+
+ - A new mesh can be created from a transformed, e.g. \ref
+ translation_page "translated", part of the mesh.
- These entities are
-considered as topological entities and they don't
-imply any geometric representation. Only \b Nodes reference geometric
-representations of points with definite coordinates. The node entity
-will contain additional information about its position in the space
-and its relations with the meshed CAD model. Its position could be
-described in the following way:
-
-
-- 2D position. It is a free position defined by only two coordinates x,y.
-- 3D position. It is a free position defined by three coordinates x,y and z.
-- Surface position. It characterizes the position of a node on a
-geometric surface and is defined by the u,v position in the parametric
-space of the corresponding surface.
-- Line position. It characterizes the position of a node on a
-geometric curve and is defined by the u parameter and the
-corresponding curve.
-- Vertex position. It characterizes the position of a node on a
-geometric point of the meshed CAD model and is defined by the x,y,z
-coordinates of the corresponding vertex.
-
-
-
Connections
-
-Each mesh entity bounds 0 or more mesh entities of higher
-dimension. In the same way each mesh entity is bounded by 0 or more
-mesh entities of lower dimension:
-
+Meshes can be edited using the MESH functions destined for
+\ref modifying_meshes_page "modification" of meshes.
+
+Attractive meshing capabilities include:
+- 3D and 2D \ref viscous_layers_anchor "Viscous Layers" (boundary
+ layers of highly stretched elements beneficial for high quality
+ viscous computations);
+- automatic conformal transition between tetrahedral and hexahedral
+ sub-meshes.
+
+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.
+
+\anchor mesh_entities
+The mesh can include the following entities:
-- A node bounds edges, faces and volumes
-- An edge bounds faces, and volumes
-- A face bounds volumes
-- A volume is bounded by faces, edges and nodes
-- A face is bounded by edges, and nodes
-- An edge is bounded by nodes
+- \b Node — a mesh entity defining a position in 3D
+ space with coordinates (x, y, z).
+- \b Edge (or segment) — 1D mesh element linking two nodes.
+- \b Face — 2D mesh element representing a part of
+ surface bound by links between face nodes. A face can be a
+ triangle, quadrangle or polygon.
+- \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,
+ pentahedron, pyramid, hexagonal prism or polyhedron.
+- \b 0D element — mesh element defined by one node.
+- \b Ball element — discrete mesh element defined by a
+ node and a diameter.
-You can notice that there are two types of connections: \b inverse and
-\b direct connections.
-
-
Inverse connections
-
-This relationship has a particularity that the order of bounded
-entities has not a direct meaning. Also the number of bounded entities
-is not fixed.
-
-\b Example: The edges surrounding a node. The 3rd edge has no more
-sense that the 5th one.
-
-
Direct connections
-
-This relationship has a particularity that the order of bounding
-entities is meaningful. The number of bounding entities is fixed and
-depends on the type of the entity (hexahedron, tetrahedron,?).
-
-\b Example: An edge is composed of two nodes. A face is composed of 3
-or 4 edges depending if we are dealing with triangles or quadrangles.
-
-The connections are not only restricted to entities of one dimension
-higher or lower. For example some algorithms may be interested to
-retrieve all the faces surrounding a node.
-
+Every mesh entity has an attribute associating it to a sub-shape it is
+generated on (if any). The node generated on the geometrical edge or
+surface in addition stores its position in parametric space of the
+associated geometrical entity. This attribute is set up by meshing
+algorithms generating elements and nodes.
+
+Mesh entities are identified by integer IDs starting from 1.
+Nodes and elements are counted separately, i.e. there can be a node
+and element with the same ID.
+
+SALOME supports elements of second order, without a central node
+(quadratic triangle, quadrangle, polygon, tetrahedron, hexahedron,
+pentahedron and pyramid) and with central nodes (bi-quadratic triangle
+and quadrangle and tri-quadratic hexahedron).
+Quadratic mesh can be obtained in three ways:
+- Using a global \ref quadratic_mesh_anchor "Quadratic Mesh"
+hypothesis. (Elements with the central node are not generated in this way).
+- Using \ref convert_to_from_quadratic_mesh_page operation.
+- Using an appropriate option of some meshing algorithms, which
+generate elements of several dimensions starting from mesh segments.
*/