doc/salome/gui/SMESH/input/merging_nodes.doc

   1 /*!
   2
   3 \page merging_nodes_page Merging nodes
   4
   5 This functionality allows user to detect groups of coincident nodes
   6 with specified tolerance; each group of the coincident nodes can be
   7 then converted to the single node.
   8
   9 \image html mergenodes_ico.png "Merge nodes menu button"
  10
  11 <em>To merge nodes of your mesh:</em>
  12 <ol>
  13 <li>Choose \b Modification -> \b Transformation -> <b>Merge nodes</b>
  14   menu item. The following dialog box shall appear:</li>
  15 <br>
  16 \image html mergenodes_auto.png
  17 <br>
  18 <ul>
  19 <li>\b Name is the name of the mesh whose nodes will be merged.</li>
  20 <li>\b Automatic or \b Manual mode allows choosing how the nodes are
  21 processed.
  22 <li>\b Tolerance is a maximum distance between nodes sufficient for
  23 merging.</li>
  24 <li>Activation of <b>No merge of corner and medium nodes of quadratic
  25     cells</b> check-box prevents merging medium nodes of quadratic
  26     elements with corner nodes. This check-box is enabled provided
  27     that the selected mesh includes quadratic elements.</li>
  28 <li><b>Exclude Groups</b> group box allows to ignore the nodes which
  29 belong to the specified mesh groups.</li>
  30 <li><b>Nodes to keep</b> group box allows to specify nodes to keep in
  31   the mesh. (By default a node being the first in a group of
  32   coincident nodes is kept.) It is possible to either select nodes in
  33   the Viewer or select groups of any element type whose nodes will be
  34   kept.
  35   <ol>
  36     <li>\a Selection button activates selection of nodes to keep.</li>
  37     <li><b>Node IDs</b> button activates selection of nodes in the
  38       Viewer.</li>
  39     <li><b>Groups and Sub-meshes</b> button activates selection of
  40       groups and sub-meshes.</li>
  41     <li>\b Add button adds selected nodes or groups to the list.</li>
  42     <li> Nodes or groups selected in the list can be removed using \b
  43       Remove button.</li>
  44   </ol>
  45 </li>
  46 </ul>
  47
  48 <li><b>Automatic mode:</b>
  49 <br>
  50 <ul>
  51 <li>In the \b Automatic Mode all Nodes within the indicated tolerance
  52 will be merged. The nodes which belong to the groups specified in the
  53 <b>Exclude Groups</b> will be not taken into account.</li>
  54 </ul>
  55 </li><br>
  56 <li> The \b Manual mode gives you full control of what the operation will do.
  57 In this mode additional controls are available:
  58 <ul>
  59 <li>\b Detect button generates the list of coincident nodes for the given
  60 \b Tolerance.</li>
  61 <li><b>Coincident nodes</b> is a list of groups of nodes for
  62   merging. After the operation all nodes of each group will
  63   be united into one node. The first node of a group is kept and
  64   the others are removed.
  65 <ul>
  66 <li>\b Remove button deletes the selected group from the list.</li>
  67 <li>\b Add button adds to the list a group of nodes selected in the
  68 viewer with pressed "Shift" key.</li>
  69 <li><b>Select all</b> check-box selects all groups.</li>
  70 <li><b>Show double nodes IDs</b> check-box shows/hides identifiers of
  71 nodes of selected groups in the 3D viewer.</li>
  72 </ul>
  73
  74 <br>
  75 \image html mergenodes.png
  76 <br>
  77 </li>
  78 <li><b>Edit selected group</b> list allows editing the selected
  79   group:
  80   <br><br>
  81   \image html add.png
  82   <center>adds to the group the nodes selected in the viewer.</center>
  83   <br>
  84   \image html remove.png
  85   <center>removes from the group the selected nodes.</center>
  86   <br>
  87   \image html sort.png
  88   <center>moves the selected node to the first position in the
  89     group in order to keep it in the mesh.</center><br>
  90 </li>
  91 </ul>
  92 </li>
  93 <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
  94 </ol>
  95
  96 \image html merging_nodes1.png "The initial object"
  97
  98 \image html merging_nodes2.png "The object has been merged"
  99
 100 <br><b>See Also</b> a sample TUI Script of a
 101 \ref tui_merging_nodes "Merge Nodes" operation.
 102
 103 */