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. In \b Manual mode you can adjust groups of coincident nodes
  22   detected by the program and/or select any nodes to be merged.</li>
  23 <li>\b Tolerance is a maximum distance between nodes sufficient for
  24 merging.</li>
  25 <li>Activation of <b>No merge of corner and medium nodes of quadratic
  26     cells</b> check-box prevents merging medium nodes of quadratic
  27     elements with corner nodes. This check-box is enabled provided
  28     that the selected mesh includes quadratic elements.</li>
  29 <li><b>Exclude groups from detection</b> group allows to ignore the
  30   nodes which belong to the specified mesh groups. This control is
  31   active provided that the mesh includes groups.</li>
  32 <li><b>Nodes to keep during the merge</b> group allows to specify
  33   nodes to keep in the mesh. (By default a node being the first in a
  34   group of coincident nodes is kept.) It is possible to either select
  35   nodes in the Viewer or select groups of any element type whose nodes
  36   will be kept.
  37   <ul>
  38     <li>\a Selection button activates selection of nodes to keep.</li>
  39     <li><b>Nodes</b> button activates selection of nodes in the
  40       Viewer.</li>
  41     <li><b>Groups and sub-meshes</b> button activates selection of
  42       groups and sub-meshes.</li>
  43     <li>\b Add button adds selected nodes or groups to the list.</li>
  44     <li> Nodes or groups selected in the list can be removed using \b
  45       Remove button.</li>
  46   </ul>
  47 </li>
  48 </ul>
  49
  50 <li><b>Automatic mode:</b>
  51 <br>
  52 <ul>
  53 <li>In the \b Automatic Mode all nodes within the indicated tolerance
  54 will be merged. The nodes which belong to the groups specified in
  55 <b>Exclude groups from detection</b> will NOT be taken into account.</li>
  56 </ul>
  57 </li><br>
  58 <li> The \b Manual mode gives you full control of what the operation will do.
  59 In this mode additional controls are available:
  60 <ul>
  61   <li>\b Detect button generates the list of coincident nodes for the given
  62     \b Tolerance.</li>
  63   <li><b>Coincident nodes</b> is a list of groups of nodes for
  64     merging. Upon \b Apply all nodes of each group will
  65     be united into one node. The first node of a group is kept and
  66     the others are removed. By default the first node has a lowest ID
  67     within the group.
  68 <ul>
  69 <li>\b Remove button deletes the selected group from the list.</li>
  70 <li>\b Add button adds to the list a group of nodes selected in the
  71 viewer.</li>
  72 <li><b>Select all</b> check-box selects all groups.</li>
  73 <li><b>Show double nodes IDs</b> check-box shows/hides identifiers of
  74 nodes of selected groups in the 3D viewer.</li>
  75 </ul>
  76
  77 <br>
  78 \image html mergenodes.png
  79 <br>
  80 </li>
  81   <li><b>Edit selected group of coincident nodes</b> list allows
  82   editing the selected group:
  83     <br><br>
  84     \image html add.png
  85     <center>adds to the group the nodes selected in the viewer.</center>
  86     <br>
  87     \image html remove.png
  88     <center>removes from the group the selected nodes.</center>
  89     <br>
  90     \image html sort.png
  91     <center>moves the selected node to the first position in the
  92       group in order to keep it in the mesh.</center><br>
  93   </li>
  94 </ul>
  95 </li>
  96 <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
  97 </ol>
  98
  99 \image html merging_nodes1.png
 100 <center> The initial object. Nodes 25, 26 and 5 are added to <b>Nodes
 101     to keep during the merge</b> group.
 102 </center>
 103 <br>
 104 \image html merging_nodes2.png
 105 <center> The object has been merged
 106 </center>
 107
 108 <br><b>See Also</b> a sample TUI Script of a
 109 \ref tui_merging_nodes "Merge Nodes" operation.
 110
 111 */