X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_submeshes.doc;h=b7fe2feee549fd60768816ed9c5949257d15cec3;hb=62336a394b80b503991ff801f2ebf7feff47e7f0;hp=f300d6f50e125a426e201beabb7fb09452c6b277;hpb=bd4e115a78b52e3fbc016e5e30bb0e19b2a9e7d6;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/constructing_submeshes.doc b/doc/salome/gui/SMESH/input/constructing_submeshes.doc
index f300d6f50..b7fe2feee 100644
--- a/doc/salome/gui/SMESH/input/constructing_submeshes.doc
+++ b/doc/salome/gui/SMESH/input/constructing_submeshes.doc
@@ -2,33 +2,86 @@
\page constructing_submeshes_page Constructing sub-meshes
-Sub-mesh is a mesh on a geometrical sub-object created with algorithms
-and/or hypotheses other than the algorithms and hypotheses assigned to
-the parent mesh on the parent object.
-
-If a geometrical sub-object belongs to several geometrical objects
-having different meshes or sub-meshes, it will be meshed with the
-hypotheses of a sub-mesh of a lower dimension.
-For example, a face of a box is meshed with a sub-mesh using algorithms
-and hypotheses other than the parent mesh on the whole box. The face
-and the box share four edges, which will be meshed with algorithms and
-hypotheses of the sub-mesh on the face, because the face is a 2D object
-while the box is a 3D object.
- If the dimensions are the same, an arbitrary algorithm/hypothesis
- will be used. This means that an edge shared by two faces each having
- its own different sub-mesh, will be meshed using algorithms and
- hypotheses of any of the two, chosen randomly. This indeterminacy can
- be fixed by defining \ref submesh_order_anchor "Sub-mesh priority".
-
+\tableofcontents
+
+By purpose, the sub-mesh is an object used to assign to a sub-shape
+different meshing parameters than those assigned to the main shape.
+
+Structurally, the sub-mesh is a mesh on a certain sub-shape, or a group of
+sub-shapes, possibly generated using different meshing algorithms
+and/or hypotheses than those used to generate the mesh on other
+sub-shapes.
+
+Creation of a sub-mesh allows to control individually meshing of a
+certain sub-shape, thus to get a locally coarser or finer mesh, to get
+elements of different types in the same mesh, etc.
+
+A sub-mesh can be meshed individually. To achieve this, select a
+sub-mesh and either invoke Compute Sub-mesh vai the contextual
+menu in the Object Browser or invoke Mesh > Compute menu.
+
+\section submesh_shape_section How to get a sub-shape for sub-mesh construction
+
+A sub-shape to create a sub-mesh on should be retrieved from the main shape
+in one of the following ways:
+- In Geometry module, via New Entity > Explode menu.
+- In Geometry module, by creation of a group (New Entity >
+ Group > Create Group menu).
+- In Mesh module, by
+ \ref subshape_by_mesh_elem "selecting a mesh element" generated on a
+ sub-shape of interest. This way is accessible if the mesh is
+ already computed.
+- In Mesh module, by clicking Publish Sub-shape button in a
+ dialog showing \ref meshing_failed_anchor "meshing errors".
+
+
+\section submesh_priority How hypotheses are selected among sub-meshes
+
+Internally, definition of meshing parameters to apply for
+discretization of a certain sub-shape, for example an edge of a
+compound of solids, starts from searching an algorithm, 1D as for the
+edge. The following sub-shapes are sequentially checked for presence
+of a sub-mesh where 1D algorithm is assigned:
+
+- the \b edge itself
+- groups of edges containing the edge, if any
+- \b wires sharing the edge
+- \b faces sharing the edge
+- groups of faces sharing the edge, if any
+- \b shells sharing the edge
+- \b solids sharing the edge
+- groups of solids sharing the edge, if any
+- the main shape
+
+(This sequence of sub-shapes defines the priority of sub-meshes. Thus more
+local, i.e. assigned to sub-shape of lower dimension, algorithms and
+hypotheses have higher priority during the search of hypotheses to
+apply.)
+
+As soon as a 1D algorithm is found, the search stops and the same
+sequence of sub-shapes is checked to find the main and additional 1D
+hypotheses, which can be taken into account by the found 1D algorithm.
+
+The multi-dimensional algorithms have a higher priority than
+uni-dimensional ones if they are assigned to sub-meshes of the
+same priority.
+
+If meshing parameters are defined on sub-meshes of the same priority,
+for example, different 1D hypotheses are assigned to two faces sharing
+an edge, the hypothesis assigned to a sub-shape with a lower ID will
+be used for meshing. You can \ref submesh_order_anchor "change" mutual
+priority of such concurrent sub-meshes.
+
+\section submesh_definition How to construct a sub-mesh
\n Construction of a sub-mesh consists of:
-- Selecting a mesh which will encapsulate your sub-mesh
-- Selecting a geometrical object for meshing
-- Applying one or several previously described
+
- Selecting a mesh which will encapsulate the sub-mesh
+- Selecting a sub-shape for meshing
+- Applying one or several
\ref about_hypo_page "hypotheses" and
\ref basic_meshing_algos_page "meshing algorithms" which will be used
-at computation of this sub-mesh
+for discretization of this sub-shape.
To construct a sub-mesh:
@@ -36,34 +89,68 @@ at computation of this sub-mesh
From the \b Mesh menu select Create Sub-mesh or click "Create
Sum-mesh" button in the toolbar.
-\image html image33.gif
-"Create Sub-mesh" button
+
+ \image html image33.gif
+ "Create Sub-mesh" button
+
\par
The following dialog box will appear:
+\par
\image html createmesh-inv2.png
-\par
It allows to define the \b Name, the parent \b Mesh and the \b
Geometry (e.g. a face if the parent mesh has been built on box) of the
-sub-mesh. You can define algorithms and hypotheses in the same way as
-in \ref constructing_meshes_page "Create mesh" menu.
+sub-mesh. You can define meshing algorithms and hypotheses in the same way as
+in \ref constructing_meshes_page "Create mesh" dialog.
+
+Later you can change the applied hypotheses or their parameters in
+\ref editing_meshes_page "Edit mesh/sub-mesh" dialog. Mesh entities
+generated using changed hypotheses are automatically removed.
+
+\anchor subshape_by_mesh_elem
+If the parent mesh is already computed, then you can define the
+\b Geometry by picking mesh elements computed on a sub-shape of interest
+in the 3D Viewer, i.e. you do not have to extract this sub-shape
+in Geometry module beforehand. To start element selection, press \a
+Selection button to the right of \b Geometry label. If this button is
+already down, then click it to release and then click it again. The
+following pop-up menu allowing to choose a way of geometry definition will
+appear.
+
+\image html choose_geom_selection_way.png
+
+Direct geometry selection enables selecting the sub-shape in the Object
+Browser.
+Find geometry by mesh element selection activates the following dialog.
+
+\image html find_geom_by_mesh_elem.png
+
+In this dialog, Element Type defines a kind of element to pick in the
+Viewer.
+Instead of picking an element in the Viewer, you can type its
+ID in Element ID field.
+ Geometry name field allows defining a name of the sub-shape,
+with which the sub-shape will appear in the Object Browser (if not yet
+there).
+
+\section submesh_tree Sub-mesh in the Object Browser
-\par
In the Object Browser the structure of the new sub-mesh will be
displayed as follows:
\image html image10.jpg
-\par
It contains:
-- a reference to the geometrical object on the basis of which the sub-mesh has been constructed;
-- Applied hypotheses folder containing the references to the
-hypotheses applied to the construction of the sub-mesh;
-- Applied algorithms folder containing the references to the
-algorithms applied to the construction of the sub-mesh.
+- a sub-mesh name (\a SubMeshFace1)
+
- a reference to the geometrical object on the basis of which the
+ sub-mesh has been constructed (Cylindrical Face_1);
+- Applied hypotheses folder containing references to
+hypotheses assigned to the sub-mesh;
+- Applied algorithms folder containing references to
+algorithms assigned to the sub-mesh.
See Also a sample TUI Script of a