From d448f72525a9f49a2837dc22f5951ca39888d219 Mon Sep 17 00:00:00 2001
From: =?utf8?q?J=C3=A9r=C3=B4me?= <jerome.lucas@cesgenslab.fr>
Date: Thu, 26 Nov 2020 16:00:52 +0100
Subject: [PATCH] Add documentation and test unit

---
 src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp  |  16 +--
 src/FeaturesAPI/FeaturesAPI_NormalToFace.h    |   4 +-
 src/FeaturesPlugin/CMakeLists.txt             |   1 +
 .../CreateNormalToFace_widget.xml             |   5 +-
 .../FeaturesPlugin_CreateNormalToFace.cpp     |  65 ++++++------
 .../FeaturesPlugin_CreateNormalToFace.h       |   9 +-
 .../FeaturesPlugin_NormalToFace.cpp           |  93 +++++++++---------
 .../FeaturesPlugin_NormalToFace.h             |  11 +--
 src/FeaturesPlugin/NormalToFace_widget.xml    |   5 +-
 src/FeaturesPlugin/Test/TestNormalToFace.py   |  66 +++++++++++++
 src/FeaturesPlugin/doc/FeaturesPlugin.rst     |   1 +
 .../doc/TUI_NormalToFaceFeature.rst           |  22 +++++
 .../doc/examples/createNormalToFace.py        |  15 +++
 .../examples/createNormalToFaceAtVertex.py    |  17 ++++
 src/FeaturesPlugin/doc/images/normal.png      | Bin 0 -> 655 bytes
 .../doc/images/normalToFacePropertyPanel.png  | Bin 0 -> 10808 bytes
 .../doc/images/normalToFaceResult.png         | Bin 0 -> 2777 bytes
 .../images/normalToFaceResultwithVertex.png   | Bin 0 -> 2685 bytes
 .../doc/normalToFaceFeature.rst               |  71 +++++++++++++
 src/FeaturesPlugin/plugin-Features.xml        |   4 +-
 20 files changed, 295 insertions(+), 110 deletions(-)
 create mode 100644 src/FeaturesPlugin/Test/TestNormalToFace.py
 create mode 100644 src/FeaturesPlugin/doc/TUI_NormalToFaceFeature.rst
 create mode 100644 src/FeaturesPlugin/doc/examples/createNormalToFace.py
 create mode 100644 src/FeaturesPlugin/doc/examples/createNormalToFaceAtVertex.py
 create mode 100644 src/FeaturesPlugin/doc/images/normal.png
 create mode 100644 src/FeaturesPlugin/doc/images/normalToFacePropertyPanel.png
 create mode 100644 src/FeaturesPlugin/doc/images/normalToFaceResult.png
 create mode 100644 src/FeaturesPlugin/doc/images/normalToFaceResultwithVertex.png
 create mode 100644 src/FeaturesPlugin/doc/normalToFaceFeature.rst

diff --git a/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp b/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp
index 2875a9f97..fbc7bd650 100644
--- a/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp
+++ b/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp
@@ -25,7 +25,7 @@
 #include <ModelHighAPI_Selection.h>
 #include <ModelHighAPI_Tools.h>
 
-
+//=================================================================================================
 FeaturesAPI_NormalToFace::
           FeaturesAPI_NormalToFace(const std::shared_ptr<ModelAPI_Feature>& theFeature)
   : ModelHighAPI_Interface(theFeature)
@@ -33,6 +33,7 @@ FeaturesAPI_NormalToFace::
   initialize();
 }
 
+//=================================================================================================
 FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
                                     const std::shared_ptr<ModelAPI_Feature>& theFeature,
                                     const ModelHighAPI_Selection& theBaseFace,
@@ -47,6 +48,7 @@ FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
   }
 }
 
+//=================================================================================================
 FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
                                     const std::shared_ptr<ModelAPI_Feature>& theFeature,
                                     const ModelHighAPI_Selection& theBaseFace)
@@ -59,21 +61,23 @@ FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
   }
 }
 
+//=================================================================================================
 FeaturesAPI_NormalToFace::~FeaturesAPI_NormalToFace()
 {
 }
 
+//=================================================================================================
 void FeaturesAPI_NormalToFace::dump(ModelHighAPI_Dumper& theDumper) const
 {
   FeaturePtr aBase = feature();
   const std::string& aDocName = theDumper.name(aBase->document());
 
   AttributeSelectionPtr anAttrObject;
-    anAttrObject = aBase->selection(FeaturesPlugin_CreateNormalToFace::OBJECTS_LIST_ID());
+    anAttrObject = aBase->selection(FeaturesPlugin_CreateNormalToFace::FACE_SELECTED_ID());
 
   theDumper << aBase << " = model.getNormal(" << aDocName << ", " << anAttrObject;
 
-  if ( !aBase->string(FeaturesPlugin_CreateNormalToFace::VERTEX_OPTION_ID())->value().empty()){
+  if (!aBase->string(FeaturesPlugin_CreateNormalToFace::VERTEX_OPTION_ID())->value().empty()){
 
     AttributeSelectionPtr anAttrVertex =
             aBase->selection(FeaturesPlugin_CreateNormalToFace::VERTEX_SELECTED_ID());
@@ -85,10 +89,9 @@ void FeaturesAPI_NormalToFace::dump(ModelHighAPI_Dumper& theDumper) const
 }
 
 //==================================================================================================
-
 NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
-                          const ModelHighAPI_Selection& theBaseFace,
-                          const ModelHighAPI_Selection& theOptionnelPoint)
+                    const ModelHighAPI_Selection& theBaseFace,
+                    const ModelHighAPI_Selection& theOptionnelPoint)
 {
 
   FeaturePtr aFeature =
@@ -101,6 +104,7 @@ NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
   return aNormalToface;
 }
 
+//=================================================================================================
 NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
                     const ModelHighAPI_Selection& theBaseFace)
 {
diff --git a/src/FeaturesAPI/FeaturesAPI_NormalToFace.h b/src/FeaturesAPI/FeaturesAPI_NormalToFace.h
index a1ad49159..f7c1facc0 100644
--- a/src/FeaturesAPI/FeaturesAPI_NormalToFace.h
+++ b/src/FeaturesAPI/FeaturesAPI_NormalToFace.h
@@ -52,8 +52,8 @@ public:
   FEATURESAPI_EXPORT
   virtual ~FeaturesAPI_NormalToFace();
 
-    INTERFACE_3(FeaturesPlugin_CreateNormalToFace::ID(),
-              faceSelected, FeaturesPlugin_CreateNormalToFace::OBJECTS_LIST_ID(),
+  INTERFACE_3(FeaturesPlugin_CreateNormalToFace::ID(),
+              faceSelected, FeaturesPlugin_CreateNormalToFace::FACE_SELECTED_ID(),
                               ModelAPI_AttributeSelection,
                               /** base face */,
               vertexSelected, FeaturesPlugin_CreateNormalToFace::VERTEX_SELECTED_ID(),
diff --git a/src/FeaturesPlugin/CMakeLists.txt b/src/FeaturesPlugin/CMakeLists.txt
index 4777f6aea..0375dd1d0 100644
--- a/src/FeaturesPlugin/CMakeLists.txt
+++ b/src/FeaturesPlugin/CMakeLists.txt
@@ -704,4 +704,5 @@ ADD_UNIT_TESTS(TestExtrusion.py
                TestFillet1D_Wire_3.py
                TestFillet1D_Wire_4.py
                TestFillet1D_Wire_5.py
+               TestNormalToFace.py
 )
diff --git a/src/FeaturesPlugin/CreateNormalToFace_widget.xml b/src/FeaturesPlugin/CreateNormalToFace_widget.xml
index c2b4bece0..f7fc96d17 100644
--- a/src/FeaturesPlugin/CreateNormalToFace_widget.xml
+++ b/src/FeaturesPlugin/CreateNormalToFace_widget.xml
@@ -1,5 +1,5 @@
 <source>
-  <shape_selector id="main_objects"
+  <shape_selector id="face"
                   label="Face"
                   tooltip="Select a face"
                   shape_types="face"
@@ -9,14 +9,13 @@
     <validator id="GeomValidators_ShapeType" parameters="wire,face"/>
   </shape_selector>
   <optionalbox id="vertex_option" title="Option">
-    <shape_selector id="tool_objects"
+    <shape_selector id="vertex"
                     label="Vertex"
                     tooltip="Select a vertex"
                     shape_types="vertex"
                     default=""
                     geometrical_selection="true">
       <validator id="PartSet_DifferentObjects"/>
-      <!--validator id="GeomValidators_ShapeType" parameters="vertex"/-->
     </shape_selector>
   </optionalbox>
 </source>
diff --git a/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.cpp b/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.cpp
index 4e9f7df11..14c8848ca 100644
--- a/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.cpp
+++ b/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.cpp
@@ -20,21 +20,14 @@
 #include "FeaturesPlugin_CreateNormalToFace.h"
 
 #include <ModelAPI_AttributeSelection.h>
-#include <ModelAPI_AttributeDoubleArray.h>
-#include <ModelAPI_AttributeBoolean.h>
 #include <ModelAPI_AttributeString.h>
 #include <ModelAPI_Data.h>
 #include <ModelAPI_Session.h>
 #include <ModelAPI_Validator.h>
-#include <PrimitivesPlugin_Box.h>
-#include <GeomAlgoAPI_PointBuilder.h>
 #include <GeomAPI_Vertex.h>
 #include <GeomAPI_Edge.h>
 #include <Config_PropManager.h>
-#include <ModelAPI_ResultBody.h>
 #include <GeomAlgoAPI_NormalToFace.h>
-#include <GeomAPI_ShapeExplorer.h>
-#include <GeomAPI_Ax1.h>
 #include <GeomAPI_Lin.h>
 #include <GeomAPI_Dir.h>
 #include <GeomAlgoAPI_EdgeBuilder.h>
@@ -42,16 +35,17 @@
 
 #include <iomanip>
 #include <sstream>
-#include <iostream>
 
+//=================================================================================================
 FeaturesPlugin_CreateNormalToFace::FeaturesPlugin_CreateNormalToFace()
 {
 }
 
+//=================================================================================================
 void FeaturesPlugin_CreateNormalToFace::initAttributes()
 {
   // attribute for object selected
-  data()->addAttribute(OBJECTS_LIST_ID(), ModelAPI_AttributeSelection::typeId());
+  data()->addAttribute(FACE_SELECTED_ID(), ModelAPI_AttributeSelection::typeId());
   data()->addAttribute(VERTEX_SELECTED_ID(), ModelAPI_AttributeSelection::typeId());
   // attributes for result message and values
   data()->addAttribute(VERTEX_OPTION_ID(), ModelAPI_AttributeString::typeId());
@@ -60,35 +54,37 @@ void FeaturesPlugin_CreateNormalToFace::initAttributes()
 
 }
 
+//=================================================================================================
 void FeaturesPlugin_CreateNormalToFace::execute()
 {
-AttributeSelectionPtr aSelectionFace = selection(OBJECTS_LIST_ID());
-AttributeSelectionPtr aSelectionPoint = selection(VERTEX_SELECTED_ID());
 
-GeomShapePtr aShape;
-GeomShapePtr aShapePoint;
+  AttributeSelectionPtr aSelectionFace = selection(FACE_SELECTED_ID());
+  AttributeSelectionPtr aSelectionPoint = selection(VERTEX_SELECTED_ID());
+
+  GeomShapePtr aShape;
+  GeomShapePtr aShapePoint;
   if(!string(VERTEX_OPTION_ID())->value().empty())
-{
-  if (aSelectionPoint && aSelectionPoint->isInitialized()) {
-    aShapePoint = aSelectionPoint->value();
-    if (!aShapePoint && aSelectionPoint->context())
-      aShapePoint = aSelectionPoint->context()->shape();
-    }
-}
+  {
+    if (aSelectionPoint && aSelectionPoint->isInitialized()) {
+      aShapePoint = aSelectionPoint->value();
+      if (!aShapePoint && aSelectionPoint->context())
+        aShapePoint = aSelectionPoint->context()->shape();
+      }
+  }
 
-if (aSelectionFace && aSelectionFace->isInitialized()) {
-  aShape = aSelectionFace->value();
-  if (!aShape && aSelectionFace->context())
-    aShape = aSelectionFace->context()->shape();
-}
+  if (aSelectionFace && aSelectionFace->isInitialized()) {
+    aShape = aSelectionFace->value();
+    if (!aShape && aSelectionFace->context())
+      aShape = aSelectionFace->context()->shape();
+  }
 
-if (aShape){
-  std::string aError;
-  std::shared_ptr<GeomAPI_Edge> theNormal(new GeomAPI_Edge);
-  if( !GeomAlgoAPI_NormalToFace::normal(aShape,
-                                        aShapePoint,
-                                        theNormal,
-                                        aError))
+  if (aShape) {
+    std::string aError;
+    std::shared_ptr<GeomAPI_Edge> theNormal(new GeomAPI_Edge);
+    if( !GeomAlgoAPI_NormalToFace::normal(aShape,
+                                          aShapePoint,
+                                          theNormal,
+                                          aError))
       setError("Error in bounding box calculation :" +  aError);
 
     GeomDirPtr theDir;
@@ -98,8 +94,8 @@ if (aShape){
         theDir = theNormal->line()->direction();
       }
     }
-    aPnt->translate(theDir, 100 );
-    
+    aPnt->translate(theDir, 100);
+
     std::shared_ptr<GeomAPI_Edge> anEdge =
                         GeomAlgoAPI_EdgeBuilder::line(theNormal->firstPoint(),
                                                       aPnt);
@@ -111,6 +107,7 @@ if (aShape){
   }
 }
 
+//=================================================================================================
 void FeaturesPlugin_CreateNormalToFace::attributeChanged(const std::string& theID)
 {
 }
diff --git a/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.h b/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.h
index 77ad40c52..83210022b 100644
--- a/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.h
+++ b/src/FeaturesPlugin/FeaturesPlugin_CreateNormalToFace.h
@@ -25,7 +25,6 @@
 
 #include <GeomAPI_IPresentable.h>
 #include <GeomAPI_IScreenParams.h>
-#include <GeomAlgoAPI_Box.h>
 
 /// \class FeaturesPlugin_CreateNormalToFace
 /// \ingroup Plugins
@@ -47,16 +46,16 @@ public:
   }
 
   /// Attribute name for face selected.
-  inline static const std::string& OBJECTS_LIST_ID()
+  inline static const std::string& FACE_SELECTED_ID()
   {
-    static const std::string MY_OBJECTS_LIST_ID("main_objects");
-    return MY_OBJECTS_LIST_ID;
+    static const std::string MY_FACE_ID("face");
+    return MY_FACE_ID;
   }
 
   /// Attribute name for vertex selected.
   inline static const std::string& VERTEX_SELECTED_ID()
   {
-    static const std::string MY_VERTEX_SELECTED_ID("tool_objects");
+    static const std::string MY_VERTEX_SELECTED_ID("vertex");
     return MY_VERTEX_SELECTED_ID;
   }
 
diff --git a/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp
index ab98fed58..a70e8fd79 100644
--- a/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp
+++ b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp
@@ -20,7 +20,6 @@
 #include "FeaturesPlugin_NormalToFace.h"
 
 #include <ModelAPI_AttributeSelection.h>
-#include <ModelAPI_AttributeDoubleArray.h>
 #include <ModelAPI_AttributeBoolean.h>
 #include <ModelAPI_AttributeString.h>
 #include <ModelAPI_Data.h>
@@ -31,10 +30,7 @@
 #include <GeomAPI_Vertex.h>
 #include <GeomAPI_Edge.h>
 #include <Config_PropManager.h>
-#include <ModelAPI_ResultBody.h>
 #include <GeomAlgoAPI_NormalToFace.h>
-#include <GeomAPI_ShapeExplorer.h>
-#include <GeomAPI_Ax1.h>
 #include <GeomAPI_Lin.h>
 #include <GeomAPI_Dir.h>
 #include <GeomAlgoAPI_EdgeBuilder.h>
@@ -44,16 +40,17 @@
 
 #include <iomanip>
 #include <sstream>
-#include <iostream>
 
+//=================================================================================================
 FeaturesPlugin_NormalToFace::FeaturesPlugin_NormalToFace()
 {
 }
 
+//=================================================================================================
 void FeaturesPlugin_NormalToFace::initAttributes()
 {
   // attribute for object selected
-  data()->addAttribute(OBJECTS_LIST_ID(), ModelAPI_AttributeSelection::typeId());
+  data()->addAttribute(FACE_SELECTED_ID(), ModelAPI_AttributeSelection::typeId());
   data()->addAttribute(VERTEX_SELECTED_ID(), ModelAPI_AttributeSelection::typeId());
   // attributes for result message and values
   data()->addAttribute(CREATENORMAL_ID(), ModelAPI_AttributeBoolean::typeId());
@@ -63,35 +60,35 @@ void FeaturesPlugin_NormalToFace::initAttributes()
 
 }
 
+//=================================================================================================
 void FeaturesPlugin_NormalToFace::execute()
 {
-AttributeSelectionPtr aSelectionFace = selection(OBJECTS_LIST_ID());
-AttributeSelectionPtr aSelectionPoint = selection(VERTEX_SELECTED_ID());
-
-GeomShapePtr aShape;
-GeomShapePtr aShapePoint;
-  if(!string(VERTEX_OPTION_ID())->value().empty())
-{
-  if (aSelectionPoint && aSelectionPoint->isInitialized()) {
-    aShapePoint = aSelectionPoint->value();
-    if (!aShapePoint && aSelectionPoint->context())
-      aShapePoint = aSelectionPoint->context()->shape();
+  AttributeSelectionPtr aSelectionFace = selection(FACE_SELECTED_ID());
+  AttributeSelectionPtr aSelectionPoint = selection(VERTEX_SELECTED_ID());
+
+  GeomShapePtr aShape;
+  GeomShapePtr aShapePoint;
+  if (!string(VERTEX_OPTION_ID())->value().empty()) {
+    if (aSelectionPoint && aSelectionPoint->isInitialized()) {
+      aShapePoint = aSelectionPoint->value();
+      if (!aShapePoint && aSelectionPoint->context())
+        aShapePoint = aSelectionPoint->context()->shape();
     }
-}
+  }
 
-if (aSelectionFace && aSelectionFace->isInitialized()) {
-  aShape = aSelectionFace->value();
-  if (!aShape && aSelectionFace->context())
-    aShape = aSelectionFace->context()->shape();
-}
+  if (aSelectionFace && aSelectionFace->isInitialized()) {
+    aShape = aSelectionFace->value();
+      if (!aShape && aSelectionFace->context())
+        aShape = aSelectionFace->context()->shape();
+  }
 
-if (aShape){
-  std::string aError;
-  std::shared_ptr<GeomAPI_Edge> theNormal(new GeomAPI_Edge);
-  if( !GeomAlgoAPI_NormalToFace::normal(aShape,
-                                        aShapePoint,
-                                        theNormal,
-                                        aError))
+  if (aShape) {
+    std::string aError;
+    std::shared_ptr<GeomAPI_Edge> theNormal(new GeomAPI_Edge);
+    if( !GeomAlgoAPI_NormalToFace::normal(aShape,
+                                          aShapePoint,
+                                          theNormal,
+                                          aError))
       setError("Error in bounding box calculation :" +  aError);
 
     GeomDirPtr theDir;
@@ -101,26 +98,23 @@ if (aShape){
         theDir = theNormal->line()->direction();
       }
     }
-    aPnt->translate(theDir, 100 );
-    
+    aPnt->translate(theDir, 100);
+
     std::shared_ptr<GeomAPI_Edge> anEdge =
-                        GeomAlgoAPI_EdgeBuilder::line(theNormal->firstPoint(),
-                                                      aPnt);
+                      GeomAlgoAPI_EdgeBuilder::line(theNormal->firstPoint(), aPnt);
 
     ResultConstructionPtr aConstr = document()->createConstruction(data());
     aConstr->setInfinite(true);
     aConstr->setShape(anEdge);
     setResult(aConstr);
   }
-  
-  if(boolean(CREATENORMAL_ID())->value())
-  {
-    if( !myCreateFeature.get() )
+
+  if (boolean(CREATENORMAL_ID())->value()) {
+    if (!myCreateFeature.get())
       createNormal();
     updateNormal();
-  }else{
-    if( myCreateFeature.get() )
-    {
+  } else {
+    if (myCreateFeature.get()) {
       myCreateFeature->eraseResults();
       SessionPtr aSession = ModelAPI_Session::get();
       DocumentPtr aDoc =  aSession->activeDocument();
@@ -130,10 +124,11 @@ if (aShape){
   }
 }
 
+//=================================================================================================
 void FeaturesPlugin_NormalToFace::attributeChanged(const std::string& theID)
 {
-   if (theID == OBJECTS_LIST_ID()) {
-    if( myCreateFeature.get() )
+   if (theID == FACE_SELECTED_ID()) {
+    if (myCreateFeature.get())
       updateNormal();
   }
 }
@@ -142,7 +137,7 @@ void FeaturesPlugin_NormalToFace::attributeChanged(const std::string& theID)
 void FeaturesPlugin_NormalToFace::createNormal()
 {
   SessionPtr aSession = ModelAPI_Session::get();
-  
+
   DocumentPtr aDoc =  aSession->activeDocument();
 
   if (aDoc.get()) {
@@ -150,17 +145,17 @@ void FeaturesPlugin_NormalToFace::createNormal()
   }
 }
 
+//=================================================================================================
 void FeaturesPlugin_NormalToFace::updateNormal()
 {
-  myCreateFeature->selection(FeaturesPlugin_CreateNormalToFace::OBJECTS_LIST_ID())
-                        ->setValue( selection(OBJECTS_LIST_ID())->context() ,
-                                    selection(OBJECTS_LIST_ID())->value() );
+  myCreateFeature->selection(FeaturesPlugin_CreateNormalToFace::FACE_SELECTED_ID())
+                        ->setValue( selection(FACE_SELECTED_ID())->context() ,
+                                    selection(FACE_SELECTED_ID())->value() );
 
   myCreateFeature->string(FeaturesPlugin_CreateNormalToFace::VERTEX_OPTION_ID())
                         ->setValue( string(VERTEX_OPTION_ID())->value());
 
-  if(!string(VERTEX_OPTION_ID())->value().empty())
-  {
+  if (!string(VERTEX_OPTION_ID())->value().empty()) {
     myCreateFeature->selection(FeaturesPlugin_CreateNormalToFace::VERTEX_SELECTED_ID())
                         ->setValue( selection(VERTEX_SELECTED_ID())->context() ,
                                     selection(VERTEX_SELECTED_ID())->value() );
diff --git a/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h
index 1b171ff9e..261b29770 100644
--- a/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h
+++ b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h
@@ -25,7 +25,6 @@
 
 #include <GeomAPI_IPresentable.h>
 #include <GeomAPI_IScreenParams.h>
-#include <GeomAlgoAPI_Box.h>
 
 /// \class FeaturesPlugin_NormalToFace
 /// \ingroup Plugins
@@ -47,16 +46,16 @@ public:
   }
 
   /// Attribute name for face selected.
-  inline static const std::string& OBJECTS_LIST_ID()
+  inline static const std::string& FACE_SELECTED_ID()
   {
-    static const std::string MY_OBJECTS_LIST_ID("main_objects");
-    return MY_OBJECTS_LIST_ID;
+    static const std::string MY_FACE_SELECTED_ID("face");
+    return MY_FACE_SELECTED_ID;
   }
 
   /// Attribute name for vertex selected.
   inline static const std::string& VERTEX_SELECTED_ID()
   {
-    static const std::string MY_VERTEX_SELECTED_ID("tool_objects");
+    static const std::string MY_VERTEX_SELECTED_ID("vertex");
     return MY_VERTEX_SELECTED_ID;
   }
 
@@ -92,7 +91,7 @@ public:
 
   private:
 
-  void createNormal(); 
+  void createNormal();
   void updateNormal();
   FeaturePtr myCreateFeature;
 
diff --git a/src/FeaturesPlugin/NormalToFace_widget.xml b/src/FeaturesPlugin/NormalToFace_widget.xml
index e130762e4..a0b818a56 100644
--- a/src/FeaturesPlugin/NormalToFace_widget.xml
+++ b/src/FeaturesPlugin/NormalToFace_widget.xml
@@ -1,5 +1,5 @@
 <source>
-  <shape_selector id="main_objects"
+  <shape_selector id="face"
                   label="Face"
                   tooltip="Select a face"
                   shape_types="face"
@@ -9,14 +9,13 @@
     <validator id="GeomValidators_ShapeType" parameters="wire,face"/>
   </shape_selector>
   <optionalbox id="vertex_option" title="Option">
-    <shape_selector id="tool_objects"
+    <shape_selector id="vertex"
                     label="Vertex"
                     tooltip="Select a vertex"
                     shape_types="vertex"
                     default=""
                     geometrical_selection="true">
       <validator id="PartSet_DifferentObjects"/>
-      <!--validator id="GeomValidators_ShapeType" parameters="vertex"/-->
     </shape_selector>
   </optionalbox>
   <boolvalue id="createnormal" label="Create normal" default="false"/>
diff --git a/src/FeaturesPlugin/Test/TestNormalToFace.py b/src/FeaturesPlugin/Test/TestNormalToFace.py
new file mode 100644
index 000000000..179b2246a
--- /dev/null
+++ b/src/FeaturesPlugin/Test/TestNormalToFace.py
@@ -0,0 +1,66 @@
+# Copyright (C) 2014-2020  CEA/DEN, EDF R&D
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
+#
+# See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
+#
+
+"""
+      Unit test of ...
+"""
+#=========================================================================
+# Initialization of the test
+#=========================================================================
+
+
+import os
+import math
+
+from ModelAPI import *
+from salome.shaper import model
+
+
+__updated__ = "2020-11-12"
+
+
+#=========================================================================
+# test creating normal to face  
+#=========================================================================
+def test_Normal_to_face():
+
+    model.begin()
+    file_path = os.path.join(os.getenv("DATA_DIR"),"Shapes","Brep","box1.brep")
+    partSet = model.moduleDocument()
+    Part_1 = model.addPart(partSet)
+    Part_1_doc = Part_1.document()
+    Import_1 = model.addImport(Part_1_doc,file_path)
+    model.do()
+    ### Create Normal
+    Normal_1 = model.getNormal(Part_1_doc, model.selection("FACE", "box1_1/Shape_6"))
+    model.end()
+    
+    assert (len(Normal_1.results()) > 0)
+    assert(Normal_1.feature().error() == "")
+    anAxisResult = modelAPI_ResultConstruction(Normal_1.feature().firstResult())
+    assert (anAxisResult is not None)
+
+    
+if __name__ == '__main__':
+
+    test_Normal_to_face()
+        
+    #=========================================================================
+    # End of test
+    #=========================================================================
diff --git a/src/FeaturesPlugin/doc/FeaturesPlugin.rst b/src/FeaturesPlugin/doc/FeaturesPlugin.rst
index fb8e2a344..11cddbe42 100644
--- a/src/FeaturesPlugin/doc/FeaturesPlugin.rst
+++ b/src/FeaturesPlugin/doc/FeaturesPlugin.rst
@@ -24,6 +24,7 @@ Features plug-in provides a set of common topological operations. It implements
    importResultFeature.rst
    linearCopyFeature.rst
    measurementFeature.rst
+   normalToFaceFeature.rst
    pipeFeature.rst
    placementFeature.rst
    recoverFeature.rst
diff --git a/src/FeaturesPlugin/doc/TUI_NormalToFaceFeature.rst b/src/FeaturesPlugin/doc/TUI_NormalToFaceFeature.rst
new file mode 100644
index 000000000..eb8b036f8
--- /dev/null
+++ b/src/FeaturesPlugin/doc/TUI_NormalToFaceFeature.rst
@@ -0,0 +1,22 @@
+
+  .. _tui_create_Normal_To_Face:
+
+Create Normal to a face
+=======================
+
+.. literalinclude:: examples/createNormalToFace.py 
+    :linenos:
+    :language: python
+
+:download:`Download this script <examples/createNormalToFace.py>`
+
+  .. _tui_create_Normal_To_Face_At_Vertex:
+
+Create Normal to a face at vertex
+=================================
+
+.. literalinclude:: examples/createNormalToFaceAtVertex.py 
+    :linenos:
+    :language: python
+
+:download:`Download this script <examples/createNormalToFaceAtVertex.py>`
\ No newline at end of file
diff --git a/src/FeaturesPlugin/doc/examples/createNormalToFace.py b/src/FeaturesPlugin/doc/examples/createNormalToFace.py
new file mode 100644
index 000000000..a1f973011
--- /dev/null
+++ b/src/FeaturesPlugin/doc/examples/createNormalToFace.py
@@ -0,0 +1,15 @@
+from salome.shaper import model
+import os
+
+model.begin()
+file_path = os.path.join(os.getenv("DATA_DIR"),"Shapes","Brep","box1.brep")
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Import_1 = model.addImport(Part_1_doc,file_path)
+model.do()
+    
+### Create BoundingBox
+Normal_1 = model.getNormal(Part_1_doc, model.selection("FACE", "box1_1/Shape_6"))
+model.do()
+model.end()
diff --git a/src/FeaturesPlugin/doc/examples/createNormalToFaceAtVertex.py b/src/FeaturesPlugin/doc/examples/createNormalToFaceAtVertex.py
new file mode 100644
index 000000000..c59aa67c5
--- /dev/null
+++ b/src/FeaturesPlugin/doc/examples/createNormalToFaceAtVertex.py
@@ -0,0 +1,17 @@
+
+from salome.shaper import model
+import os
+
+model.begin()
+file_path = os.path.join(os.getenv("DATA_DIR"),"Shapes","Brep","box1.brep")
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Import_1 = model.addImport(Part_1_doc,file_path)
+model.do()
+    
+### Create BoundingBox
+Normal_1 = model.getNormal(Part_1_doc, model.selection("FACE", "box1_1/Shape_6"), 
+                                    model.selection("VERTEX", "[box1_1/Shape_2][box1_1/Shape_4][box1_1/Shape_6]"))
+model.do()
+model.end()
diff --git a/src/FeaturesPlugin/doc/images/normal.png b/src/FeaturesPlugin/doc/images/normal.png
new file mode 100644
index 0000000000000000000000000000000000000000..16080764e8d275a433c96cfb3c849a9d1bd931e0
GIT binary patch
literal 655
zcmV;A0&x9_P)<h;3K|Lk000e1NJLTq000yK000yS1^@s6jfou%00009a7bBm000XU
z000XU0RWnu7ytkO1ZP1_K>z@;j(q!3lK=n!AY({UO#lFTB>(_`g8%^e{{R4h=>PzA
zFaQARU;qF*m;eA5Z<1fdMgRZ;1xZ9fRCwBA{Qv(y12q9a05LI882|(jQ3hU9S0~yV
z00G3r$jHb*2!jAI>OdGEfT-?efB+(B;8iuX|41|kA@u+OM5+q~2q^#vAVy+bhYYlD
z-NLH}Ab^NL98iM;f!KhMw*dl(7%y`mc~_8-fdB!-LclO&FV7=nvzV9|13&=bGw}b!
z4ObYx|N6tgP!q;bGUp`2-@pGD{`~vT@ay+KhHpQAGra%ui{bO<&kVo5ePp<`x{Tq~
zt5=Eu0ffuI|C2XeW%&Bz4;X{M=Wo9me*XRow%`+x{q5@)hM%9`GW`7dp5gws4u%gO
zJ|qE^SpozQwix^0v-T3$pwHiaF(h`!!6kBo`Wb$I2fFCXJBFWM-ZK0G8us|$Y>+FP
zfzm&K_&z`Yp&R(WYQbrS&)<JDy!-qUjK6>X&M<XTIYW|N0mJVfUl@LW{Rs5pdxqcN
zJ~6yJx1Qna*ROEHfcQK>03jRrKW)-shL2x=F}wvD^yABWpbI`Q`~e#B=jS(uzrVf#
z*<XP!`~)`m&6S-X%TNph;s*c$1T*k|VDoOUVLw6M`TPcA*w3#F|9<~u_zT4U{s8G;
zKN$Y}{?72^%qEZ?48uTtfB<4dOB%!itcHOk00M{+not#h*bs;ni75bZ83qCX0mK3|
pKoH7*PNWMz0P%Hn!$1HazyS1?`dP5-m?8iG002ovPDHLkV1fqo76kwR

literal 0
HcmV?d00001

diff --git a/src/FeaturesPlugin/doc/images/normalToFacePropertyPanel.png b/src/FeaturesPlugin/doc/images/normalToFacePropertyPanel.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ed5e80955276be30726aeece75cdaf03a1e316a
GIT binary patch
literal 10808
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

literal 0
HcmV?d00001

diff --git a/src/FeaturesPlugin/doc/images/normalToFaceResult.png b/src/FeaturesPlugin/doc/images/normalToFaceResult.png
new file mode 100644
index 0000000000000000000000000000000000000000..ecfb260ab9a0efbf3924a3c16b59c7754bea6b1d
GIT binary patch
literal 2777
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

literal 0
HcmV?d00001

diff --git a/src/FeaturesPlugin/doc/images/normalToFaceResultwithVertex.png b/src/FeaturesPlugin/doc/images/normalToFaceResultwithVertex.png
new file mode 100644
index 0000000000000000000000000000000000000000..98f1aa8ed9875d7a6cc11a010fc5ebe019a46b56
GIT binary patch
literal 2685
zcmZ{m2~?8X7RM>Org=$IpI&pQoY0p;H&fCSa>~qsFw&g0)JhyuaY}{kI+4AMTT$0u
zk@{2`l%9zbhH0iKnReC81nntkp(0>};PgIixbMBY-naHz=bXL1efIwLIp1&n@khPg
zz+1L&0f9hZ_roqez$gKMHfSrz12g$7RXt$Xl;q@&QUIPzg@^)Rt%Y$tfjJf*g-H!h
zj0ByIi;s;oPdb$t85x&!CLS{<*8&59wkW&1IHJ=2KFg+EG4#{z6k1KEZ`3z5+w4L#
zFjS>jqF<Yi7N&Zk^bhKDbzfS|u-j)9nxWUOaHx%j5gLgFMsnMV!mP6^&u3(yn;op!
z!O7UEd4ieN)gkLa@$BmTW9;XxnxW<zKNKW|&&YvNCLZ4!QR(939Uad*n(xcK`gIDd
z^l}|dw4+tJYjm9O+Fwmq)&_~#+qmm`!#6{a9ZjxjJ4weCa=!Y()(Vk{&x=EsX2NEi
z-)>28HlcC%7~WF?-Wopo%Lc{ZTP&3$->iG?&o0P7*g+>v`u>g18=D@R<*!u+n9aJ^
z7@DIB%@LXWn70WNp6Cn|xMyd{+ScDol<NN3m9zcF!yno--NFtZ)Fg7hX7A2h_kQ_w
zz1-HT7c4yE6e69$@`meM1BHLD{Yx5VqJmM}SBrG6a=bZapT>v7rL>1(!EIVXlSjL5
zT4HyIGqInRaI2G!=_06RThd1F&VRk#{0tjJPZKx|Je4k;(V{bw3J$Q``_BijwiMdu
zH#o;`7uyl09+zl*=vFpsg;KXmC*<W23wSU7PQO?Ct8k1=Z0%A~;N|A16sBBII(iXF
z;jOYFIk?#OrHTvNy!e-9?Rd#d#+cn113@>Q=HoYNx0)sP@0oIALNy48n_y~p5PQBB
z*2Pn|EWhp+PJk@!Gfp+CP!%_=q*dn~3b9H+uux?o_1hbtRXVcNQj*&jc~6Rai#&yR
zfl188YI<-d5Uu1PZb79Hj;ArEW5`|%YBvyZd1+zl{0SsStn;zUj0qWkHzGD~g$}L;
z4UNLce-*sLXGEOsm*u|%N+J1iXb?W3R$csH&@|){Bh{Ui@g{m;+J&BxuQY{;howOz
zblD?c1Dt@1vFOOL@Z>uzyw~lQMNZC_anp-^IM!;Ct#}zmHg71JRgr8hkY)NBXf6!n
zGng#D_@Z)|bRp**F$h|fdNS+&%E!C<h!1TX7z8=zhQm_kY(>S=afVhf&Trt<iN7uN
zTc)H5<$<FnwTe^Oenqh`cmTbXzfW`tzo_mxeb(PQfuLMdQkSh=dbd{0Sgp-vs5R|r
z3?0uiO0$*?ee9rZ4peMT8HZ(`4W<CcDwR=n8XJZR?4GYRxrgDf<v_~BuVl5SD$;(i
z<-!Gv81fAtSTl!i$KEUQ*vu``-gLLmwVx?c_L`ntYtK;DH3s@k1gkVIaJ8w@Z4|{S
zjT(&R;IpA>^^4Kozc!(YR&}FW&iB?%a(ycoN+XuGQk72act*#tV`iMg#${+u7-!-w
z(U{0xrX{Y9|2F<8pvA&R-cc<<;u~t8eeB3*Y9ERPTtS9<e2@|a_k?ux2`aw7f|BZ_
z>E+EoPUOX&5qhyS-LCjQn6m5FPCcmEgIII>2jFyHI2`08&o^aJhQU;?h8+~9O_?{)
z-O&q+!jJRvOZo}%44<sxW<AK0K<p8HQr;cXD)2+`trFody{Swqn}Jtd%L^+r^Y##+
z<?-3&vN&7HX#>8wsx-y6Xv%=Edk&7pzG6%98TqUt(%pHggRsRpHipQ%{o6aK`&uS7
z4{`XhLOXne<fYHDRy>Ag#NSp+N5zY$MxhBsWGW+2YFpU`88F_tjBV~9t2GH;5ER{;
zcThfqci&TDitz6K4~DQyitP?a>Y<Pkp|P5zeGmf=dH!=<dtQK1MJ60JIAK?`cI_^C
z#@>hBm<YSouzTNUpWuOHfytwjr_2U#H&V6&rBt)%L|#R5Rt!1!?Qu@kp*wxKUAj?$
zk_lky!YX-{1Rs5wmApS;^MP3(cI~T^_01bB3xfva0G^e+xmvQA;2{WC3~sk%wn*nF
zOf>xN4FoJ<gQQ{!>01YZ@o~#j^;~Az*yXIBt{Kk6Xm-FrVbIbE?5rEY!?e6vCfjYW
zLve-#w*KjA-;3ND6C*JtekJvOvt-_bJ3?t0nY1nYL9GGXyXg0+Mkl~{9a(>HEmS9a
z*M_eU{x1fuGk*<(G33?@ITmKjZ;S_Ezn&}CEqo2+-!b^dp5F-%VEBI^&pSsrm$V^}
z*yk#DZ82;{?gDb33bgh<zJV5J^Lf`%eD&=c@Fm+YuaG0QI*Xu`DqKlZD7M9()LYbH
zuVegR2go%1=I?#^Ctw=3ax(Jbw88!SN&0?~@N_4k1-Da>XI=)Q>!}_n2qls@6TKSc
z8Dr}4$f2IQuDXwg8$8mnmu~8dFqWRv=e#=EYUy=vO8M4LO6u^7{LZpZNC^dv9%|}x
zcu!vx@{-vxTFDRFvo0<YdB+1tZ_Lqr<lD1sT%wLNl7JZA%Y!r))p;{HqkYkwjU;0A
zZHK~QBkkx)%v@KSI;j8~FqToXhrIa~>-4!^pDffvWYXRQ(sKt7@l#dt$ASzcv%yr#
zbW|zKh{g>}oD&MwTl7V-0p8P{N(bIoMmWbZ`PHr~QaH?V47<#}m5(Zi@m4aMyb--M
znQnYo$aN@IRD0d0`yr)8UjVLh>lwBdqKO@%UR-Fv$}-^HJ5CrVnU3P}CvqRxw{u4S
zIrwahwt!5ZsBB4v(>rQM!3lG(r$Vz(eAo)3V&rG!91%?2#_}J=psfYfx6ONhL7#)#
zZ_$2z$F1=9;8^q}Nx$rsK~Y^wPfcb-s-7-FC}5BZi=V1UT>f#$f+sA<IO%IZaR5T`
z=Ur?DjCm<9BooWE^ks(M&z%v8h_|!dMBYQB6^zFHOT)5YzX;tQ^uV$V`@v7g3*Qw?
z7*W<Nr`c4QjwU}jjkGcyuYL)DGqRZxdh3nn6)^P(d%LL!Xu;T=>^F;Rw8Z+)7&u+e
zx*x(<sZU9Rk0x6o{SLDn>z<;ZRnwEm6ZZm@uNbVpk0Agl-oN(ki6Q?$YgCn1WT&!Y
zq`i$cyeR+C3%8XuEbojj*YclNV8`Ryd#L5-5d)1|<6tM!j%$CSO)y;VFgbD8$@9Q1
zUROY?m7D(13+obxoe1cgb#1Vwj=so;|0|c+mH(lrfVW^J@+E-E;1(Ku3$+>8dA$o<
q(he?}Av&)~skO{sWDcNoWbn&@0<9QU01D8LAa_@9mujc5i~k1w#!|Qd

literal 0
HcmV?d00001

diff --git a/src/FeaturesPlugin/doc/normalToFaceFeature.rst b/src/FeaturesPlugin/doc/normalToFaceFeature.rst
new file mode 100644
index 000000000..b4f9b16b2
--- /dev/null
+++ b/src/FeaturesPlugin/doc/normalToFaceFeature.rst
@@ -0,0 +1,71 @@
+.. |normalToFace.icon|    image:: images/normal.png
+
+Normal to a face
+================
+
+The **Normal to a face** feature displays the normal to a face. A vertex can be specified to indicate the position of the normal else the center of face is used. 
+
+the resulting normal can be created via a dedicated check-box **Create normal**. If this last is checked corresponding result and feature would be created. 
+
+If the check-box **Create normal** isn't checked, **Apply** button does not generate any result and has the same effect as **Cancel** for this feature.  
+
+To display the normal to a face in the active part:
+
+#. select in the Main Menu *Inspection - > Normal to a face* item  or
+#. click |normalToFace.icon| **Normal to a face** button in the toolbar
+
+The property panel is shown below.
+
+.. figure:: images/normalToFacePropertyPanel.png
+   :align: center
+
+   Normal to a face
+
+
+Input fields:
+
+- **Face** contains face selected in 3D OCC viewer or object browser. 
+- **Vertex** contains optionnal vertex selected in 3D OCC viewer or object browser. 
+- **Create normal** check-box allow the creation of the normal (result and feature). 
+
+**TUI Command**:
+
+.. py:function:: model.getNormal(Part, face)
+ 
+    :param part: The current part object.
+    :param object: A face in format *model.selection("FACE", face)*.
+    :return: Created normal to a face at center.
+
+Result
+""""""
+
+Result of **Normal to a face**.
+
+.. figure:: images/normalToFaceResult.png
+   :align: center
+
+   Normal to a face
+
+**See Also** a sample TUI Script of :ref:`tui_create_Normal_To_Face` operation.
+
+
+**TUI Command**:
+
+.. py:function:: model.getNormal(Part, face, vertex)
+ 
+    :param part: The current part object.
+    :param object: A face in format *model.selection("FACE", face)*.
+    :param object: A vertex in format *model.selection("VERTEX", vertex)*.
+    :return: Created normal to a face at vertex.
+
+Result
+""""""
+
+Result of **Normal to aface** where **Vertex** is selecteted.
+
+.. figure:: images/normalToFaceResultwithVertex.png
+   :align: center
+
+   Normal to a face at vertex
+
+**See Also** a sample TUI Script of :ref:`tui_create_Normal_To_Face_At_Vertex` operation.
\ No newline at end of file
diff --git a/src/FeaturesPlugin/plugin-Features.xml b/src/FeaturesPlugin/plugin-Features.xml
index 3e17f562a..4a480d18f 100644
--- a/src/FeaturesPlugin/plugin-Features.xml
+++ b/src/FeaturesPlugin/plugin-Features.xml
@@ -180,11 +180,11 @@
     </group>
     <group id="Face">
       <feature id="NormalMacro" title="Normal to a face" tooltip="Calculate the normal to a face" auto_preview="true"
-               icon="icons/Features/normale.png" helpfile="measurementFeature.html"> 
+               icon="icons/Features/normale.png" helpfile="normalToFaceFeature.html"> 
         <source path="NormalToFace_widget.xml"/>
       </feature>
       <feature id="Normal" title="Normal to a face" tooltip="Calculate the normal to a face" auto_preview="true"
-               icon="icons/Features/axis.png" helpfile="measurementFeature.html" internal="1"> 
+               icon="icons/Features/axis.png" helpfile="normalToFaceFeature.html" internal="1"> 
         <source path="CreateNormalToFace_widget.xml"/>
       </feature>
     </group>
-- 
2.39.2