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

   1 /*!
   2
   3 \page double_nodes_page Duplicate Nodes or/and Elements
   4
   5 \n This operation allows duplicating mesh nodes or/and elements, which can be useful to emulate a crack in the model.
   6
   7 Duplication consists in creation of mesh elements "equal" to existing ones.
   8
   9 <em>To duplicate nodes or/and elements:</em>
  10 <ol>
  11 <li>From the \b Modification menu choose \b Transformation -> <b> Duplicate
  12  Nodes or/and Elements </b> item or click <em>"Duplicate Nodes or/and
  13  Elements"</em> button in the toolbar.
  14 <br>
  15 \image html duplicate_nodes.png "Duplicate Nodes or/and Elements button"
  16 </li>
  17 <li>Check in the dialog box one of four radio buttons corresponding to
  18   the type of duplication operation you would like to perform.</li>
  19 <li>Fill the other fields available in the dialog box (depending on
  20   the chosen operation mode).</li>
  21 <li>Click the \b Apply or <b>Apply and Close</b> button to perform the
  22   operation of duplication.</li>
  23 </ol>
  24
  25 \n "Duplicate Nodes or/and Elements" dialog has four working modes:
  26 <ul>
  27 <li>\ref mode_without_elem_anchor "Duplicate nodes only"</li>
  28 <li>\ref mode_with_elem_anchor "Duplicate nodes and border elements"</li>
  29 <li>\ref mode_elem_only_anchor "Duplicate elements only"</li>
  30 <li>\ref mode_group_boundary_anchor "Duplicate nodes on group boundaries"</li>
  31 </ul>
  32
  33 <br>
  34 \anchor mode_without_elem_anchor
  35
  36 <h2>Duplicate nodes only</h2>
  37
  38 \image html duplicate01.png
  39
  40 Parameters to be defined in this mode:
  41 <ul>
  42 <li><b>Group of nodes to duplicate</b> (<em>mandatory</em>): these
  43   nodes will be duplicated.</li>
  44 <li><b>Group of elements to replace nodes with new ones</b>
  45   (<em>optional</em>): the new nodes will replace the duplicated nodes within these elements.</li>
  46 <li><b>Construct group with newly created nodes</b> option
  47   (<em>checked by default</em>): if checked - the group with newly
  48   created nodes will be built.</li>
  49 </ul>
  50 A schema below illustrates how the crack is emulated using the node duplication.
  51 \image html crack_emulation_double_nodes.png "Crack emulation"
  52 This schema shows a virtual crack in a 2D mesh created using this duplication
  53 mode:
  54 - Black balls are <b>duplicated nodes</b>.
  55 - Red balls are <b>new nodes</b>.
  56 - <b>Elements to replace nodes with new ones</b> are marked with green.
  57
  58 Note that in the reality <b>duplicated nodes</b> coincide with <b>new nodes</b>.
  59
  60 <br>
  61 \anchor mode_with_elem_anchor
  62
  63
  64 <h2>Duplicate nodes and border elements</h2>
  65
  66 \image html duplicate02.png
  67
  68 Parameters to be defined in this mode:
  69 <ul>
  70 <li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
  71   elements will be duplicated.</li>
  72 <li><b>Group of nodes not to duplicate</b> (<em>optional</em>):
  73   group of nodes at crack bottom which will not be duplicated.</li>
  74 <li><b>Group of elements to replace nodes with new ones</b>
  75   (<em>mandatory</em>): the new nodes will replace the nodes to
  76   duplicate within these elements.</li>
  77 <li><b>Construct group with newly created elements</b> option
  78  (<em>checked by default</em>): if checked - the group of newly created
  79  elements will be built.</li>
  80 <li><b>Construct group with newly created nodes</b> option
  81   (<em>checked by default</em>): if checked - the group of newly
  82   created nodes will be built.</li>
  83 </ul>
  84
  85 A schema below explains the crack emulation using the node duplication
  86 with border elements.
  87 \image html crack_emulation_double_nodes_with_elems.png "Crack emulation"
  88 This schema shows a virtual crack in a 2D mesh created using this duplication
  89 mode. In this schema:
  90 - Black segments are <b>duplicated elements</b> (edges in 2D case).
  91 - Black balls (except for the lowest one) are duplicated nodes of <b>duplicated elements</b>.
  92 - The lowest black ball is the <b>non-duplicated node</b>.
  93 - Red balls are <b>newly created nodes</b>.
  94 - Red segments are <b>created elements</b> (edges).
  95 - <b>Elements to replace nodes with new ones</b> are marked with green.
  96
  97 Note that in the reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
  98 <br>
  99 In a 3D case, where <b>elements to duplicate</b> are faces, the edges
 100 located at the "crack" (if any) are cloned automatically.
 101
 102 <br>
 103 \anchor mode_elem_only_anchor
 104 <h2>Duplicate elements only</h2>
 105
 106 This mode duplicates the given elements, i.e. creates new elements with the same nodes as the given elements.
 107 <br>
 108
 109 \image html duplicate03.png
 110
 111 Parameters to be defined in this mode:
 112 <ul>
 113   <li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
 114     elements will be duplicated.</li>
 115   <li><b>Construct group with newly created elements</b> option
 116     (<em>checked by default</em>): if checked - the group of newly created
 117     elements will be built. The name of the created group starts from
 118     "DoubleElements".</li>
 119 </ul>
 120
 121 <br>
 122 \anchor mode_group_boundary_anchor
 123 <h2>Duplicate nodes on group boundaries</h2>
 124
 125 This mode duplicates nodes located on boundaries between given groups of volumes.
 126
 127 <br>
 128
 129 \image html duplicate04.png
 130
 131 Parameters to be defined in this mode:
 132 <ul>
 133   <li><b>Groups of volumes</b> (<em>mandatory</em>): list of volume
 134     groups. These groups should be disjoint, i.e. should not have shared
 135     volumes.</li>
 136   <li> If <b>Create joint elements</b> option is activated, flat
 137     elements are created on the duplicated nodes: a triangular facet
 138     shared by two volumes of two groups generates a flat prism, a
 139     quadrangular facet generates a flat hexahedron.
 140     <br>
 141     The created flat volumes are stored in groups. These groups are named
 142     according to the position of the group in the list of groups: group
 143     "j_n_p" is a group of flat elements that are built between the group \#n
 144     and the group \#p in the group list. All the flat elements are gathered
 145     into the group named "joints3D". The flat element of the multiple
 146     junctions between the simple junction are stored in a group named
 147     "jointsMultiples".</li>
 148   <li> If <b>On all boundaries</b> option is activated, the volumes,
 149     which are not included into <b>Groups of volumes</b>, are considered
 150     as another group and thus the nodes on the boundary
 151     between <b>Groups of volumes</b> and the remaining mesh are also
 152     duplicated.</li>
 153 </ul>
 154
 155 <br><b>See Also</b> a sample TUI Script of a
 156  \ref tui_duplicate_nodes "Duplicate nodes or/and elements" operation.
 157
 158 */