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 element "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 three 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 three 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 </ul>
  31
  32 <br>
  33 \anchor mode_without_elem_anchor
  34
  35 <h2>Duplicate nodes only</h2>
  36
  37 \image html duplicate01.png
  38
  39 Parameters to be defined in this mode:
  40 <ul>
  41 <li><b>Group of nodes to duplicate</b> (<em>mandatory</em>): these
  42   nodes will be duplicated.</li>
  43 <li><b>Group of elements to replace nodes with new ones</b>
  44   (<em>optional</em>): the new nodes will replace the duplicated nodes within these elements.</li>
  45 <li><b>Construct group with newly created nodes</b> option
  46   (<em>checked by default</em>): if checked - the group with newly
  47   created nodes will be built.</li>
  48 </ul>
  49 A schema below illustrates how the crack is emulated using the node duplication.
  50 \image html crack_emulation_double_nodes.png "Crack emulation"
  51 This schema shows a virtual crack in a 2D mesh created using this duplication
  52 mode:
  53 - Black balls are <b>duplicated nodes</b>.
  54 - Red balls are <b>new nodes</b>.
  55 - <b>Elements to replace nodes with new ones</b> are marked with green.
  56
  57 Note that in the reality <b>duplicated nodes</b> coincide with <b>new nodes</b>.
  58
  59 <br>
  60 \anchor mode_with_elem_anchor
  61
  62
  63 <h2>Duplicate nodes and border elements</h2>
  64
  65 \image html duplicate02.png
  66
  67 Parameters to be defined in this mode:
  68 <ul>
  69 <li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
  70   elements will be duplicated.</li>
  71 <li><b>Group of nodes not to duplicate</b> (<em>optional</em>):
  72   group of nodes at crack bottom which will not be duplicated.</li>
  73 <li><b>Group of elements to replace nodes with new ones</b>
  74   (<em>mandatory</em>): the new nodes will replace the nodes to
  75   duplicate within these elements.</li>
  76 <li><b>Construct group with newly created elements</b> option
  77  (<em>checked by default</em>): if checked - the group of newly created
  78  elements will be built.</li>
  79 <li><b>Construct group with newly created nodes</b> option
  80   (<em>checked by default</em>): if checked - the group of newly
  81   created nodes will be built.</li>
  82 </ul>
  83
  84 A schema below explains the crack emulation using the node duplication
  85 with border elements.
  86 \image html crack_emulation_double_nodes_with_elems.png "Crack emulation"
  87 This schema shows a virtual crack in a 2D mesh created using this duplication
  88 mode. In this schema:
  89 - Black segments are <b>duplicated elements</b> (edges in 2D case).
  90 - Black balls (except for the lowest one) are duplicated nodes of <b>duplicated elements</b>.
  91 - The lowest black ball is the <b>non-duplicated node</b>.
  92 - Red balls are <b>newly created nodes</b>.
  93 - Red segments are <b>created elements</b> (edges).
  94 - <b>Elements to replace nodes with new ones</b> are marked with green.
  95
  96 Note that in the reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
  97 <br>
  98 In a 3D case, where <b>elements to duplicate</b> are faces, the edges
  99 located at the "crack" (if any) are cloned automatically.
 100
 101 <br>
 102 \anchor mode_elem_only_anchor
 103 <h2>Duplicate elements only</h2>
 104
 105 This mode duplicates the given elements, i.e. creates new elements with the same nodes as the given elements.
 106
 107 <br>
 108
 109
 110 \image html duplicate03.png
 111
 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><b>See Also</b> a sample TUI Script of a
 122  \ref tui_duplicate_nodes "Duplicate nodes or/and elements" operation.
 123
 124 */