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 to duplicate nodes or/and elements of your mesh.
   6 Duplication of nodes can be useful to emulate a crack in the model.
   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 <h2>Duplicate nodes only</h2>
  35
  36 In this mode the dialog looks like:
  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 nodes to
  46   duplicate within these elements.</li>
  47 <li><b>Construct group with newly created nodes</b> option
  48   (<em>checked by default</em>): if checked - the group with just
  49   created nodes will be built.</li>
  50 </ul>
  51 A schema below explains the crack emulation using the node duplication.
  52 \image html crack_emulation_double_nodes.png "Crack emulation"
  53 This schema shows a virtual crack in a 2D mesh created using this duplication
  54 mode. In this schema:
  55 - Black balls are <b>nodes to duplicate</b>.
  56 - Red balls are <b>new nodes</b>.
  57 - <b>Elements to replace nodes with new ones</b> are marked with green.
  58
  59 Note that in reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
  60
  61
  62 <br>
  63 \anchor mode_with_elem_anchor
  64 <h2>Duplicate nodes and border elements</h2>
  65
  66 In this mode the dialog looks like:
  67
  68 \image html duplicate02.png
  69
  70 Parameters to be defined in this mode:
  71 <ul>
  72 <li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
  73   elements will be duplicated.</li>
  74 <li><b>Group of nodes not to duplicate</b> (<em>optional</em>):
  75   group of nodes at crack bottom which will not be duplicated.</li>
  76 <li><b>Group of elements to replace nodes with new ones</b>
  77   (<em>mandatory</em>): the new nodes will replace the nodes to
  78   duplicate within these elements.</li>
  79 <li><b>Construct group with newly created elements</b> option
  80  (<em>checked by default</em>): if checked - the group of just created
  81  elements will be built.</li>
  82 <li><b>Construct group with newly created nodes</b> option
  83   (<em>checked by default</em>): if checked - the group of just
  84   created nodes will be built.</li>
  85 </ul>
  86
  87 A schema below explains the crack emulation using the node duplication
  88 with border elements.
  89 \image html crack_emulation_double_nodes_with_elems.png "Crack emulation"
  90 This schema shows a virtual crack in a 2D mesh created using this duplication
  91 mode. In this schema:
  92 - Black segments are <b>elements to duplicate</b> (edges in 2D case).
  93 - Black balls (except the lowest one) are nodes of <b>elements to
  94   duplicate</b> that are duplicated.
  95 - The lowest black ball is a <b>node not to duplicate</b>.
  96 - Red balls are <b>creates nodes</b>.
  97 - Red segments are <b>created elements</b> (edges).
  98 - <b>Elements to replace nodes with new ones</b> are marked with green.
  99
 100 Note that in reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
 101 <br>
 102 In a 3D case, where <b>elements to duplicate</b> are faces, the edges
 103 located at the "crack" (if any) are cloned automatically.
 104
 105 <br>
 106 \anchor mode_elem_only_anchor
 107 <h2>Duplicate elements only</h2>
 108
 109 This mode just duplicates given elements, i.e. creates new elements on
 110 the same nodes as the given elements.
 111 <br>
 112 In this mode the dialog looks like:
 113
 114 \image html duplicate03.png
 115
 116 Parameters to be defined in this mode:
 117 <ul>
 118 <li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
 119   elements will be duplicated.</li>
 120 <li><b>Construct group with newly created elements</b> option
 121   (<em>checked by default</em>): if checked - the group of just created
 122   elements will be built. A name of the created group starts from
 123   "DoubleElements".</li>
 124 </ul>
 125
 126
 127 <br><b>See Also</b> a sample TUI Script of a
 128  \ref tui_duplicate_nodes "Duplicate nodes or/and elements" operation.
 129
 130 */