X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fdouble_nodes_page.doc;h=955d0cffeb6f6e2298dd16cb1d515d9de0c3a21c;hb=9d296302bce45a19ce73bcb52e86884ba38f1199;hp=0c4c1eb2c28fc9edd638a557269c8ad4c0769f04;hpb=13b8c96957cd060f6e76f73c9248b941beff0d6d;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/double_nodes_page.doc b/doc/salome/gui/SMESH/input/double_nodes_page.doc
index 0c4c1eb2c..955d0cffe 100644
--- a/doc/salome/gui/SMESH/input/double_nodes_page.doc
+++ b/doc/salome/gui/SMESH/input/double_nodes_page.doc
@@ -2,9 +2,9 @@
\page double_nodes_page Duplicate Nodes or/and Elements
-\n This operation allows to duplicate nodes or/and elements of your mesh.
-Duplication of nodes can be useful to emulate a crack in the model.
-Duplication consists in creation of mesh element "equal" to existing ones.
+\n This operation allows duplicating mesh nodes or/and elements, which can be useful to emulate a crack in the model.
+
+Duplication consists in creation of mesh elements "equal" to existing ones.
To duplicate nodes or/and elements:
@@ -14,7 +14,7 @@ Duplication consists in creation of mesh element "equal" to existing ones.
\image html duplicate_nodes.png "Duplicate Nodes or/and Elements button"
-- Check in the dialog box one of three radio buttons corresponding to
+
- Check in the dialog box one of four radio buttons corresponding to
the type of duplication operation you would like to perform.
- Fill the other fields available in the dialog box (depending on
the chosen operation mode).
@@ -22,18 +22,18 @@ Duplication consists in creation of mesh element "equal" to existing ones.
operation of duplication.
-\n "Duplicate Nodes or/and Elements" dialog has three working modes:
+\n "Duplicate Nodes or/and Elements" dialog has four working modes:
- \ref mode_without_elem_anchor "Duplicate nodes only"
- \ref mode_with_elem_anchor "Duplicate nodes and border elements"
- \ref mode_elem_only_anchor "Duplicate elements only"
+- \ref mode_group_boundary_anchor "Duplicate nodes on group boundaries"
\anchor mode_without_elem_anchor
-Duplicate nodes only
-In this mode the dialog looks like:
+Duplicate nodes only
\image html duplicate01.png
@@ -42,28 +42,26 @@ Parameters to be defined in this mode:
Group of nodes to duplicate (mandatory): these
nodes will be duplicated.
Group of elements to replace nodes with new ones
- (optional): the new nodes will replace the nodes to
- duplicate within these elements.
+ (optional): the new nodes will replace the duplicated nodes within these elements.
Construct group with newly created nodes option
- (checked by default): if checked - the group with just
+ (checked by default): if checked - the group with newly
created nodes will be built.
-A schema below explains the crack emulation using the node duplication.
+A schema below illustrates how the crack is emulated using the node duplication.
\image html crack_emulation_double_nodes.png "Crack emulation"
This schema shows a virtual crack in a 2D mesh created using this duplication
-mode. In this schema:
-- Black balls are nodes to duplicate.
+mode:
+- Black balls are duplicated nodes.
- Red balls are new nodes.
- Elements to replace nodes with new ones are marked with green.
-Note that in reality nodes to duplicate coincide with new nodes.
-
+Note that in the reality duplicated nodes coincide with new nodes.
\anchor mode_with_elem_anchor
-Duplicate nodes and border elements
-In this mode the dialog looks like:
+
+Duplicate nodes and border elements
\image html duplicate02.png
@@ -77,10 +75,10 @@ Parameters to be defined in this mode:
(mandatory): the new nodes will replace the nodes to
duplicate within these elements.
Construct group with newly created elements option
- (checked by default): if checked - the group of just created
+ (checked by default): if checked - the group of newly created
elements will be built.
Construct group with newly created nodes option
- (checked by default): if checked - the group of just
+ (checked by default): if checked - the group of newly
created nodes will be built.
@@ -89,15 +87,14 @@ with border elements.
\image html crack_emulation_double_nodes_with_elems.png "Crack emulation"
This schema shows a virtual crack in a 2D mesh created using this duplication
mode. In this schema:
-- Black segments are elements to duplicate (edges in 2D case).
-- Black balls (except the lowest one) are nodes of elements to
- duplicate that are duplicated.
-- The lowest black ball is a node not to duplicate.
-- Red balls are creates nodes.
+- Black segments are duplicated elements (edges in 2D case).
+- Black balls (except for the lowest one) are duplicated nodes of duplicated elements.
+- The lowest black ball is the non-duplicated node.
+- Red balls are newly created nodes.
- Red segments are created elements (edges).
- Elements to replace nodes with new ones are marked with green.
-Note that in reality nodes to duplicate coincide with new nodes.
+Note that in the reality nodes to duplicate coincide with new nodes.
In a 3D case, where elements to duplicate are faces, the edges
located at the "crack" (if any) are cloned automatically.
@@ -106,23 +103,56 @@ located at the "crack" (if any) are cloned automatically.
\anchor mode_elem_only_anchor
Duplicate elements only
-This mode just duplicates given elements, i.e. creates new elements on
-the same nodes as the given elements.
+This mode duplicates the given elements, i.e. creates new elements with the same nodes as the given elements.
-In this mode the dialog looks like:
\image html duplicate03.png
Parameters to be defined in this mode:
-- Group of elements to duplicate (mandatory): these
- elements will be duplicated.
-- Construct group with newly created elements option
- (checked by default): if checked - the group of just created
- elements will be built. A name of the created group starts from
- "DoubleElements".
+ - Group of elements to duplicate (mandatory): these
+ elements will be duplicated.
+ - Construct group with newly created elements option
+ (checked by default): if checked - the group of newly created
+ elements will be built. The name of the created group starts from
+ "DoubleElements".
+
+\anchor mode_group_boundary_anchor
+Duplicate nodes on group boundaries
+
+This mode duplicates nodes located on boundaries between given groups of volumes.
+
+
+
+\image html duplicate04.png
+
+Parameters to be defined in this mode:
+
+ - Groups (faces or volumes) (mandatory): list of mesh
+ groups. These groups should be disjoint, i.e. should not have shared
+ elements.
+ - If Create joint elements option is activated, flat
+ elements are created on the duplicated nodes: a triangular facet
+ shared by two volumes of two groups generates a flat prism, a
+ quadrangular facet generates a flat hexahedron.
+ Correspondingly 2D joint elements (null area faces) are generated
+ where edges are shared by two faces.
+
+ The created flat volumes (or faces) are stored in groups. These groups are named
+ according to the position of the group in the list of groups: group
+ "j_n_p" is a group of flat elements that are built between the group \#n
+ and the group \#p in the group list. All flat elements are gathered
+ into the group named "joints3D" (correspondingly "joints2D"). The flat elements of multiple
+ junctions between the simple junction are stored in a group named
+ "jointsMultiples".
+ - If On all boundaries option is activated, the volumes (or faces),
+ which are not included into Groups input, are considered
+ as another group and thus the nodes on the boundary
+ between Groups and the remaining mesh are also
+ duplicated.
+
See Also a sample TUI Script of a
\ref tui_duplicate_nodes "Duplicate nodes or/and elements" operation.