X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_submeshes.doc;h=d88161c44bc9aa554aa636b12e869185ec44643d;hp=a17569f7cb9188541ad3df343491f3b68bc8e27e;hb=83811dbaaef9bb88b6ed0c5fe83fe1ab68d8d436;hpb=0635c9fc80f67d1e5dc0e94ec85f487286a92070
diff --git a/doc/salome/gui/SMESH/input/constructing_submeshes.doc b/doc/salome/gui/SMESH/input/constructing_submeshes.doc
index a17569f7c..d88161c44 100644
--- a/doc/salome/gui/SMESH/input/constructing_submeshes.doc
+++ b/doc/salome/gui/SMESH/input/constructing_submeshes.doc
@@ -1,55 +1,105 @@
/*!
-\page constructing_submeshes_page Constructing submeshes
-
-Submesh is a mesh on a geometrical subobject created with algorithms
-and/or hypotheses other than the algorithms and hypotheses assigned to
-the parent mesh on the parent object.
-
-If a geometrical subobject belongs to several geometrical objects
-having different meshes or submeshes, it will be meshed with the
-hypotheses of a submesh of a lower dimension.
-For example, a face of a box is meshed with a submesh using algorithms
+\page constructing_submeshes_page Constructing sub-meshes
+
+Sub-mesh is a mesh on a geometrical sub-object (sub-shape) used to assign
+different meshing algorithms and/or hypotheses than the algorithms and
+hypotheses assigned to the parent mesh on the parent geometrical
+object, that allows getting a local mesh refinement.
+
+A sub-shape to create a sub-mesh on should be retrieved from the shape
+of the parent mesh 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.
+
+
+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 submesh on the face, because the face is a 2D object
+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 submesh, will be meshed using algorithms and
- hypotheses of any of the two, chosen randomly.
+ 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". The
+ default sub-meshes priority is such that multi-dimensional algorithms
+ are processed first.
+
-\n Construction of a submesh consists of:
+\n Construction of a sub-mesh consists of:
-- Selecting a mesh which will encapsulate your submesh
+- Selecting a mesh which will encapsulate your sub-mesh
- Selecting a geometrical object for meshing
- Applying one or several previously described
\ref about_hypo_page "hypotheses" and
\ref basic_meshing_algos_page "meshing algorithms" which will be used
-at computation of this submesh
+at computation of this sub-mesh
-
To construct a submesh:
+
To construct a sub-mesh:
\par
-From the \b Mesh menu select Create Submesh or click "Create
+From the \b Mesh menu select Create Sub-mesh or click "Create
Sum-mesh" button in the toolbar.
-\image html image33.gif
-"Create Submesh" 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
-submesh. You can define algorithms and hypotheses in the same way as
+sub-mesh. You can select meshing algorithms and hypotheses in the same way as
in \ref constructing_meshes_page "Create mesh" menu.
\par
-In the Object Browser the structure of the new submesh will be
+\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.
+
+\par
+\image html choose_geom_selection_way.png
+
+\par
+Direct geometry selection enables selecting the sub-shape in the Object
+Browser.
+Find geometry by mesh element selection activates the following dialog.
+
+\par
+\image html find_geom_by_mesh_elem.png
+
+\par
+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).
+
+\par
+In the Object Browser the structure of the new sub-mesh will be
displayed as follows:
\image html image10.jpg
@@ -57,14 +107,16 @@ displayed as follows:
\par
It contains:
-- a reference to the geometrical object on the basis of which the submesh has been constructed;
+- 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 the references to the
-hypotheses applied to the construction of the submesh;
+hypotheses selected at the construction of the sub-mesh;
- Applied algorithms folder containing the references to the
-algorithms applied to the construction of the submesh.
+algorithms selected at the construction of the sub-mesh.
See Also a sample TUI Script of a
-\ref tui_construction_submesh "Construct Submesh" operation.
+\ref tui_construction_submesh "Construct Sub-mesh" operation.
*/