doc/salome/gui/SMESH/input/double_nodes_page.rst

   1 .. _double_nodes_page:
   2
   3 *******************************
   4 Duplicate Nodes or/and Elements
   5 *******************************
   6
   7 This operation allows duplicating mesh nodes or/and elements, which can be useful to emulate a crack in the model.
   8
   9 Duplication consists in creation of mesh elements "equal" to existing ones.
  10
  11 *To duplicate nodes or/and elements:*
  12
  13 .. |img| image:: ../images/duplicate_nodes.png
  14
  15 #. From the **Modification** menu choose **Transformation** -> **Duplicate Nodes or/and Elements** item or click *"Duplicate Nodes or/and Elements"* button |img| in the toolbar.
  16 #. Check in the dialog box one of four radio buttons corresponding to the type of duplication operation you would like to perform.
  17 #. Fill the other fields available in the dialog box (depending on the chosen operation mode).
  18 #. Click the **Apply** or **Apply and Close** button to perform the operation of duplication.
  19
  20 "Duplicate Nodes or/and Elements" dialog has four working modes:
  21
  22         * :ref:`mode_without_elem_anchor`
  23         * :ref:`mode_with_elem_anchor`
  24         * :ref:`mode_elem_only_anchor`
  25         * :ref:`mode_group_boundary_anchor`
  26
  27
  28
  29 .. _mode_without_elem_anchor:
  30
  31 Duplicate nodes only
  32 ####################
  33
  34         .. image:: ../images/duplicate01.png
  35                 :align: center
  36
  37
  38 Parameters to be defined in this mode:
  39
  40         * **Group of nodes to duplicate** (*mandatory*): these nodes will be duplicated.
  41         * **Group of elements to replace nodes with new ones** (*optional*): the new nodes will replace the duplicated nodes within these elements. **Generate** button tries to automatically find such elements and creates a group of them. This button becomes active as soon as **Group of nodes to duplicate** is selected.
  42         * **Construct group with newly created nodes** option (*checked by default*): if checked - the group with newly created nodes will be built.
  43
  44 A schema below illustrates how the crack is emulated using the node duplication.
  45
  46 .. image:: ../images/crack_emulation_double_nodes.png
  47         :align: center
  48
  49 .. centered::
  50         Crack emulation
  51
  52
  53 This schema shows a virtual crack in a 2D mesh created using this duplication mode:
  54         * Black balls are **duplicated nodes**.
  55         * Red balls are **new nodes**.
  56         * **Elements to replace nodes with new ones** are marked with green.
  57
  58 .. note::
  59         Note that in the reality **duplicated nodes** coincide with **new nodes**.
  60
  61
  62 .. _mode_with_elem_anchor:
  63
  64 Duplicate nodes and border elements
  65 ###################################
  66
  67 .. image:: ../images/duplicate02.png
  68         :align: center
  69
  70 Parameters to be defined in this mode:
  71
  72         * **Group of elements to duplicate** (*mandatory*): these elements will be duplicated.
  73         * **Group of nodes not to duplicate** (*optional*): group of nodes at crack bottom which will not be duplicated.
  74         * **Group of elements to replace nodes with new ones** (*mandatory*): the new nodes will replace the nodes to duplicate within these elements. **Generate** button tries to automatically find such elements and creates a group of them. This button becomes active as soon as **Group of elements to duplicate** is selected.
  75         * **Construct group with newly created elements** option (*checked by default*): if checked - the group of newly created elements will be built.
  76         * **Construct group with newly created nodes** option (*checked by default*): if checked - the group of newly created nodes will be built.
  77
  78
  79 A schema below explains the crack emulation using the node duplication with border elements.
  80
  81         .. image:: ../images/crack_emulation_double_nodes_with_elems.png
  82                 :align: center
  83
  84         .. centered::
  85                 Crack emulation
  86
  87 This schema shows a virtual crack in a 2D mesh created using this duplication mode. In this schema:
  88
  89 * Black segments are **duplicated elements** (edges in 2D case).
  90 * Black balls (except for the lowest one) are duplicated nodes of **duplicated elements**.
  91 * The lowest black ball is the **non-duplicated node**.
  92 * Red balls are **newly created nodes**.
  93 * Red segments are **created elements** (edges).
  94 * **Elements to replace nodes with new ones** are marked with green.
  95
  96 Note that in the reality **nodes to duplicate** coincide with **new nodes**.
  97
  98 In a 3D case, where **elements to duplicate** are faces, the edges
  99 located at the "crack" (if any) are cloned automatically.
 100
 101
 102 .. _mode_elem_only_anchor:
 103
 104 Duplicate elements only
 105 #######################
 106
 107 This mode duplicates the given elements, i.e. creates new elements with the same nodes as the given elements.
 108
 109
 110 .. image:: ../images/duplicate03.png
 111         :align: center
 112
 113 Parameters to be defined in this mode:
 114
 115         * **Group of elements to duplicate** (*mandatory*): these elements will be duplicated.
 116         * **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".
 117
 118
 119 .. _mode_group_boundary_anchor:
 120
 121 Duplicate nodes on group boundaries
 122 ###################################
 123
 124 This mode duplicates nodes located on boundaries between given groups of volumes.
 125
 126
 127 .. image:: ../images/duplicate04.png
 128         :align: center
 129
 130 Parameters to be defined in this mode:
 131
 132         * **Groups (faces or volumes)** (*mandatory*): list of mesh groups. These groups should be disjoint, i.e. should not have shared elements.
 133         * 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".
 134         * 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.
 135
 136
 137 **See Also** a sample TUI Script of a :ref:`tui_duplicate_nodes` operation.
 138
 139