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</b> check-box
  25   prevents merging medium nodes of quadratic elements with corner
  26   nodes. This check-box is enabled provided that the selected mesh
  27   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.
  30 </ul>
  31
  32 <li><b>Automatic mode:</b>
  33 <br>
  34 <ul>
  35 <li>In the \b Automatic Mode all Nodes within the indicated tolerance
  36 will be merged. The nodes which belong to the groups specified in the
  37 <b>Exclude Groups</b> will be not taken into account.</li>
  38 </ul>
  39 </li><br>
  40 <li> The \b Manual mode gives you full control of what the operation will do.
  41 In this mode additional controls are available:
  42 <ul>
  43 <li>\b Detect button generates the list of coincident nodes for the given
  44 \b Tolerance.</li>
  45 <li><b>Coincident nodes</b> is a list of groups of nodes for
  46   merging. After the operation all nodes of each group will
  47   be united into one node. The first node of a group is kept and
  48   the others are removed.
  49 <ul>
  50 <li>\b Remove button deletes the selected group from the list.</li>
  51 <li>\b Add button adds to the list a group of nodes selected in the
  52 viewer with pressed "Shift" key.</li>
  53 <li><b>Select all</b> check-box selects all groups.</li>
  54 <li><b>Show double nodes IDs</b> check-box shows/hides identifiers of
  55 nodes of selected groups in the 3D viewer.</li>
  56 </ul>
  57
  58 <br>
  59 \image html mergenodes.png
  60 <br>
  61 </li>
  62 <li><b>Edit selected group</b> list allows editing the selected
  63   group:
  64   <br><br>
  65   \image html add.png
  66   <center>adds to the group the nodes selected in the viewer.</center>
  67   <br>
  68   \image html remove.png
  69   <center>removes from the group the selected nodes.</center>
  70   <br>
  71   \image html sort.png
  72   <center>moves the selected node to the first position in the
  73     group in order to keep it in the mesh.</center><br>
  74 </li>
  75 </ul>
  76 </li>
  77 <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
  78 </ol>
  79
  80 \image html merging_nodes1.png "The initial object"
  81
  82 \image html merging_nodes2.png "The object has been merged with a very big tolerance"
  83
  84 <br><b>See Also</b> a sample TUI Script of a
  85 \ref tui_merging_nodes "Merge Nodes" operation.
  86
  87 */