Salome HOME
23080: [CEA 1497] Do not merge a middle node in quadratic with the extreme nodes...
[modules/smesh.git] / doc / salome / gui / SMESH / input / merging_nodes.doc
index 7c5d622733abd6c5dabc2392762923744d93e0ee..8e2aa4fadac00b990462791b83e58546c2bfcb56 100644 (file)
@@ -2,60 +2,86 @@
 
 \page merging_nodes_page Merging nodes
 
-\n This functionality allows user to detect groups of coincident nodes
-with desirable tolerance, edit these groups and merge.
+This functionality allows user to detect groups of coincident nodes
+with specified tolerance; each group of the coincident nodes can be
+then converted to the single node.
+
+\image html mergenodes_ico.png "Merge nodes menu button"
 
 <em>To merge nodes of your mesh:</em>
 <ol>
-<li>From the \b Modification choose \b Transformation and  from its
-sub-menu select the <b>Merge nodes</b> item. The following dialog box
-shall appear:
-
-\image html mergenodes.png
-
+<li>Choose \b Modification -> \b Transformation -> <b>Merge nodes</b>
+  menu item. The following dialog box shall appear:</li>
+<br>
+\image html mergenodes_auto.png
+<br>
 <ul>
 <li>\b Name is the name of the mesh whose nodes will be merged.</li>
+<li>\b Automatic or \b Manual mode allows choosing how the nodes are
+processed.
 <li>\b Tolerance is a maximum distance between nodes sufficient for
-merging.
+merging.</li>
+<li>Activation of <b>No merge of corner and medium nodes</b> check-box
+  prevents merging medium nodes of quadratic elements with corner
+  nodes. This check-box is enabled provided that the selected mesh
+  includes quadratic elements.</li>
+<li><b>Exclude Groups</b> group box allows to ignore the nodes which
+belong to the specified mesh groups.
+</ul>
+
+<li><b>Automatic mode:</b>
+<br>
+<ul>
+<li>In the \b Automatic Mode all Nodes within the indicated tolerance
+will be merged. The nodes which belong to the groups specified in the
+<b>Exclude Groups</b> will be not taken into account.</li>
+</ul>
+</li><br>
+<li> The \b Manual mode gives you full control of what the operation will do.
+In this mode additional controls are available:
 <ul>
 <li>\b Detect button generates the list of coincident nodes for the given
 \b Tolerance.</li>
-</ul>
-</li>
-<li><b>Coincident nodes</b> is a list of groupes of nodes for
-merging. All nodes of each group will form one after the
-operation.
+<li><b>Coincident nodes</b> is a list of groups of nodes for
+  merging. After the operation all nodes of each group will
+  be united into one node. The first node of a group is kept and
+  the others are removed.
 <ul>
 <li>\b Remove button deletes the selected group from the list.</li>
 <li>\b Add button adds to the list a group of nodes selected in the
 viewer with pressed "Shift" key.</li>
-<li><b>Select all</b> checkbox selects all groups.</li>
+<li><b>Select all</b> check-box selects all groups.</li>
+<li><b>Show double nodes IDs</b> check-box shows/hides identifiers of
+nodes of selected groups in the 3D viewer.</li>
 </ul>
-</li>
-<li><b>Edit selected group</b> list allows editing the selected
-group:
-<br><br>
-\image html add.gif
-<center>adds to the group the node selected in the viewer.</center>
+
 <br>
-\image html remove.gif
-<center>removes from the group the selected node.</center>
+\image html mergenodes.png
 <br>
-\image html sort.gif
-<center>moves the selected node to the first position in the
-group. This means that all other nodes will be merged into this
-one.</center><br>
+</li>
+<li><b>Edit selected group</b> list allows editing the selected
+  group:
+  <br><br>
+  \image html add.png
+  <center>adds to the group the nodes selected in the viewer.</center>
+  <br>
+  \image html remove.png
+  <center>removes from the group the selected nodes.</center>
+  <br>
+  \image html sort.png
+  <center>moves the selected node to the first position in the
+    group in order to keep it in the mesh.</center><br>
 </li>
 </ul>
 </li>
-<li>To confirm your choice click \b OK or \b Apply button.</li>
+<li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
 </ol>
 
-\image html merging_nodes1.png
+\image html merging_nodes1.png "The initial object" 
 
-\image html merging_nodes2.png
+\image html merging_nodes2.png "The object has been merged with a very big tolerance"
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_merging_nodes "Merge Nodes" operation.  
 
-*/
\ No newline at end of file
+*/