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