X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_meshes.doc;h=042b66320d413ba63466268f27b8333c0be2a37b;hp=625cff3bd1d510418a3a85d2e758cfee0478f724;hb=aa67cc96d730566d202d1014d97b7f0b3a4d71f4;hpb=64be032249f21ff884326a9b1d5e6b1a6eed93dc
diff --git a/doc/salome/gui/SMESH/input/constructing_meshes.doc b/doc/salome/gui/SMESH/input/constructing_meshes.doc
index 625cff3bd..042b66320 100644
--- a/doc/salome/gui/SMESH/input/constructing_meshes.doc
+++ b/doc/salome/gui/SMESH/input/constructing_meshes.doc
@@ -152,10 +152,92 @@ evaluation will be displayed in the following information box:
\image html mesh_evaluation_succeed.png
+
-Consider trying a sample script for construction of a mesh from our
-\ref tui_creating_meshes_page "TUI Scripts" section.
+
+
+\anchor mesh_order_anchor
+It is allowed to change submesh priority in mesh computation when
+there are concurrent submeshes present. I.e. user can change priority of
+applying algorithms on shared subshapes of Mesh shape.
+To change submesh priority:
+
+- From the Mesh menu choose the "Change submesh priority" on
+selected Mesh item, or invoke from popup menu. The opened dialogue box
+shows a list of submeshes in the order of their priority. Algorithm and its
+hypotheses of a submesh being upper in the list are applied before those of
+a submesh lower in the list.
+
+There is an example of submesh order modifications of Mesh created on a Box
+shape. The main Mesh object:
+
+- 3D Tetrahedron (Netgen) with HypothesisMax Element Volume
+- 2D Triangle (Mefisto) with HypothesisMax Element Area
+- 1D Wire discretisation with Number of Segments=20
+
+The first submesh object Submesh_1 created on Face_1
+is:
+
+- 2D Netgen 1D-2D with Hypothesis Netgen Simple parameters
+(Number of Segments = 4)
+
+The second submesh object Submesh_2 created on Face_2
+is:
+
+- 2D Netgen 1D-2D with Hypothesis Netgen Simple parameters
+(Number of Segments = 8)
+
+
+And the last third submesh object Submesh_3 created on Face_3
+is:
+
+- 2D Netgen 1D-2D with Hypothesis Netgen Simple parameters
+(Number of Segments = 12)
+
+The submeshes can become concurrent if their algorithms leads to mesh shared subshape
+with different algorithms (or different algorithms parameters, i.e. hypothesises).
+In fact, we have three submeshes with concurrent algorithms, because
+they have different hypothesises assigned to them.
+
+The first mesh computation made with:
+\image html mesh_order_123.png
+"Mesh order SubMesh_1, SubMesh_2, SubMesh_3"
+\image html mesh_order_123_res.png
+"Result mesh with order SubMesh_1, SubMesh_2, SubMesh_3 "
+
+The next mesh computation with:
+\image html mesh_order_213.png
+"Mesh order SubMesh_2, SubMesh_1, SubMesh_3"
+\image html mesh_order_213_res.png
+"Result mesh with order SubMesh_2, SubMesh_1, SubMesh_3 "
+
+And the last mesh computation with:
+\image html mesh_order_321.png
+"Mesh order SubMesh_3, SubMesh_2, SubMesh_1"
+\image html mesh_order_321_res.png
+"Result mesh with order SubMesh_3, SubMesh_2, SubMesh_1 "
+
+As we can see each mesh computation has different number of result
+elements and different mesh discretisation on shared edges (edges
+that are shared between Face_1, Face_2 and Face_3)
+
+Additionally, submesh priority (order of algorithms to be applied) can
+be modified not only in separate dialog box, but in Preview
+also. This helps to preview different mesh results, modifying submesh
+order.
+\image html mesh_order_preview.png
+"Preview with submesh priority list box"
+
+If there are no concurrent submeshes under Mesh object, then user will see the
+following information dialog box
+\image html mesh_order_no_concurrent.png
+"No concurrent submeshes detected"
+and no mesh order list box will appear in Preview dialog box.
+
+Consider trying a sample script for construction of a mesh from our
+\ref tui_creating_meshes_page "TUI Scripts" section.
+
*/