0022475: EDF 2811 GEOM: Features for "Smoothing Surface" function

doc/salome/gui/GEOM/input/creating_smoothingsurface.doc

@@ -7,7 +7,7 @@ Advanced - > SmoothingSurface </b>
 
 To create a surface it is necessary to specify the \b Name of the surface, the list of \b Points
 from which it is approximated and some plate approximation parameters such as: <b>Max nbr of
-Bezier pieces</b>, <b>Max BSpline surface degree</b> and <b>Max plate criterion value</b>.
+Bezier pieces</b>, <b>Max BSpline surface degree</b> and <b>3D tolerance of initial approximation</b>.
 And then press "Apply" or "Apply & Close" button.
 
 \note The dialog accepts compounds of points as well as single nodes.
@@ -18,7 +18,13 @@ The result of the operation will be a GEOM_Object(Surface).
 - \em thelPoints list of points. Compounds of points are accepted as well
 - \em theNbMax maximum number of Bezier pieces in the resulting surface
 - \em theDegMax maximum degree of the resulting BSpline surface
-- \em theDMax specifies maximum value of the GeomPlate_PlateG0Criterion criterion
+- \em theDMax specifies 3D tolerance of initial approximation
+
+\note <b>3D tolerance of initial approximation</b> represents a tolerance of
+initial plate surface approximation. If this parameter is equal to 0 (default
+value) it is computed. In this case an error of initial plate surface
+computation is used as the approximation tolerance. This error represents a
+maximal distance between computed plate surface and given points.
 
 \image html smoothingsurface_dlg.png
 

src/AdvancedEngine/GEOMImpl_SmoothingSurfaceDriver.cxx

@@ -262,7 +262,7 @@ GetCreationInformation(std::string&             theOperationName,
 
       AddParam(theParams, "Max nbr of Bezier pieces", aCI.GetNbMax());
       AddParam(theParams, "Max BSpline surface degree", aCI.GetDegMax());
-      AddParam(theParams, "Max plate criterion value", aCI.GetDMax());
+      AddParam(theParams, "3D tolerance of initial approximation", aCI.GetDMax());
     }
     break;
   default:

src/AdvancedGUI/AdvancedGUI_msg_en.ts

@@ -303,7 +303,7 @@
     </message>
     <message>
         <source>GEOM_SMOOTHINGSURFACE_ARG_D_MAX</source>
-        <translation>Max plate criterion value</translation>
+        <translation>3D tolerance of initial approximation</translation>
     </message>
     <message>
         <source>GEOM_SMOOTHINGSURFACE_NO_POINTS</source>

src/GEOM_SWIG/geomBuilder.py

@@ -12695,12 +12695,17 @@ class geomBuilder(object, GEOM._objref_GEOM_Gen):
         #  @param theNbMax maximum number of Bezier pieces in the resulting
         #         surface.
         #  @param theDegMax maximum degree of the resulting BSpline surface.
-        #  @param theDMax specifies maximum value of the
+        #  @param theDMax 3D tolerance of initial approximation.
-        #         GeomPlate_PlateG0Criterion criterion.
         #  @param theName Object name; when specified, this parameter is used
         #         for result publication in the study. Otherwise, if automatic
         #         publication is switched on, default value is used for result name.
         #  @return New GEOM_Object, containing the created shape.
+        #  @note 3D tolerance of initial approximation represents a tolerance of
+        #        initial plate surface approximation. If this parameter is equal
+        #        to 0 (default value) it is computed. In this case an error of
+        #        initial plate surface computation is used as the approximation
+        #        tolerance. This error represents a maximal distance between
+        #        computed plate surface and given points.
         #
         #  @ref tui_creation_smoothingsurface "Example"
         def MakeSmoothingSurface(self, thelPoints, theNbMax=2, theDegMax=8,
@@ -12714,14 +12719,21 @@ class geomBuilder(object, GEOM._objref_GEOM_Gen):
                 theNbMax maximum number of Bezier pieces in the resulting
                          surface.
                 theDegMax maximum degree of the resulting BSpline surface.
-                theDMax specifies maximum value of the
+                theDMax 3D tolerance of initial approximation.
-                        GeomPlate_PlateG0Criterion criterion.
                 theName Object name; when specified, this parameter is used
                         for result publication in the study. Otherwise, if automatic
                         publication is switched on, default value is used for result name.
 
             Returns:
                 New GEOM_Object, containing the created shape.
+
+            Note:
+                3D tolerance of initial approximation represents a tolerance of
+                initial plate surface approximation. If this parameter is equal
+                to 0 (default value) it is computed. In this case an error of
+                initial plate surface computation is used as the approximation
+                tolerance. This error represents a maximal distance between
+                computed plate surface and given points.
             """
             anObj = self.AdvOp.MakeSmoothingSurface(thelPoints, theNbMax,
                                                     theDegMax, theDMax)