Fix for improvement 0019927 (EDF770 SMESH: Analyzing the Mesh Quality: Orphan nodes). Correspoding documetaion update.

doc/salome/gui/SMESH/input/about_quality_controls.doc

@@ -13,7 +13,12 @@ the meshing elements and these calculated values is shown with the
 help of a scalar bar, which is displayed near the presentation of your
 mesh.
 
-There are 1D, 2D and 3D quality controls.
+There are 0D, 1D, 2D and 3D quality controls.
+
+0D mesh quality controls:
+<ul>
+<li>\ref free_nodes_page "Free nodes"</li>
+</ul>
 
 1D mesh quality controls:
 <ul>

doc/salome/gui/SMESH/input/free_nodes.doc

@@ -0,0 +1,16 @@
+/*!
+
+\page free_nodes_page Free nodes
+
+\n This mesh quality control highlights nodes which are not connected
+to any  mesh element. Free nodes are shown with a color differs from
+the color of nodes.
+
+\image html free_nodes.png
+<center>In this picture some nodes don't connected to a mesh element as
+a result of deleting elements and adding several isolated nodes.
+
+<br><b>See Also</b> a sample TUI Script of a 
+\ref tui_free_nodes "Free Nodes quality control" operation.  
+
+*/

doc/salome/gui/SMESH/input/index.doc

@@ -51,6 +51,7 @@
 <li>\ref free_borders_page</li>
 <li>\ref borders_at_multi_connection_page</li>
 <li>\ref length_page</li>
+<li>\ref free_nodes_page</li>
 <li>\ref free_edges_page</li>
 <li>\ref length_2d_page</li>
 <li>\ref borders_at_multi_connection_2d_page</li>

doc/salome/gui/SMESH/input/quality_controls.doc

@@ -7,6 +7,7 @@
 <li>\subpage free_borders_page</li>
 <li>\subpage borders_at_multi_connection_page</li>
 <li>\subpage length_page</li>
+<li>\subpage free_nodes_page</li>
 <li>\subpage free_edges_page</li>
 <li>\subpage length_2d_page</li>
 <li>\subpage borders_at_multi_connection_2d_page</li>

doc/salome/gui/SMESH/input/tui_quality_controls.doc

@@ -189,6 +189,59 @@ for i in range(len(aBorders)):
 salome.sg.updateObjBrowser(1)
 \endcode
 
+<br>
+\anchor tui_free_nodes
+<h2>Free Nodes</h2>
+
+\code
+import salome
+import geompy
+
+import smesh
+
+# create box
+box = geompy.MakeBox(0., 0., 0., 100., 200., 300.)
+idbox = geompy.addToStudy(box, "box")
+
+# create a mesh
+mesh = smesh.Mesh(box, "Mesh_free_nodes")
+algo = mesh.Segment()
+algo.NumberOfSegments(10)
+algo = mesh.Triangle(smesh.MEFISTO)
+algo.MaxElementArea(150.)
+mesh.Compute() 
+
+# Remove some elements to obtain free nodes
+# Criterion : AREA < 80.
+area_margin = 80.
+
+aFilter = smesh.GetFilter(smesh.FACE, smesh.FT_Area, smesh.FT_LessThan, area_margin)
+
+anIds = mesh.GetIdsFromFilter(aFilter)
+
+mesh.RemoveElements(anIds)
+
+# criterion : free nodes
+aFilter = smesh.GetFilter(smesh.NODE, smesh.FT_FreeNodes) 
+anNodeIds = mesh.GetIdsFromFilter(aFilter)
+
+# create a group
+aGroup = mesh.CreateEmptyGroup(smesh.NODE, "Free_nodes")
+aGroup.Add(anNodeIds)
+
+# print the result
+print "Criterion: Free nodes Nb = ", len(anNodeIds)
+j = 1
+for i in range(len(anNodeIds)):
+  if j > 20: j = 1; print ""
+  print anNodeIds[i],
+  j = j + 1
+  pass
+print ""
+
+salome.sg.updateObjBrowser(1)
+\endcode
+
 <br>
 \anchor tui_length_2d
 <h2>Length 2D</h2>