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