From 38ca82064c538fe1d861d089eefa18d3cfa1a681 Mon Sep 17 00:00:00 2001
From: cg246364 <clarisse.genrault@cea.fr>
Date: Mon, 30 Aug 2021 08:41:48 +0200
Subject: [PATCH] CEA : Lot2 - Normal to a face

---
 src/FeaturesAPI/CMakeLists.txt                |   2 +
 src/FeaturesAPI/FeaturesAPI.i                 |   2 +
 src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp  | 113 ++++++++
 src/FeaturesAPI/FeaturesAPI_NormalToFace.h    |  93 +++++++
 src/FeaturesAPI/FeaturesAPI_swig.h            |   1 +
 src/FeaturesPlugin/CMakeLists.txt             |   6 +
 .../FeaturesPlugin_InspectNormalToFace.cpp    | 165 ++++++++++++
 .../FeaturesPlugin_InspectNormalToFace.h      | 103 ++++++++
 .../FeaturesPlugin_NormalToFace.cpp           | 114 +++++++++
 .../FeaturesPlugin_NormalToFace.h             |  84 ++++++
 src/FeaturesPlugin/FeaturesPlugin_Plugin.cpp  |   6 +
 src/FeaturesPlugin/Test/TestNormalToFace.py   |  77 ++++++
 .../create_normal_to_face_widget.xml          |  20 ++
 src/FeaturesPlugin/doc/FeaturesPlugin.rst     |   1 +
 .../doc/TUI_normalToFaceFeature.rst           |  22 ++
 .../doc/examples/create_normal_to_face.py     |  12 +
 .../create_normal_to_face_at_vertex.py        |  12 +
 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/icons/normale.png          | Bin 0 -> 655 bytes
 src/FeaturesPlugin/normal_to_face_widget.xml  |  21 ++
 src/FeaturesPlugin/plugin-Features.xml        |  10 +
 src/FeaturesPlugin/tests.set                  |   1 +
 src/GeomAlgoAPI/CMakeLists.txt                |   2 +
 src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.cpp  | 242 ++++++++++++++++++
 src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.h    |  46 ++++
 src/PythonAPI/model/features/__init__.py      |   1 +
 30 files changed, 1227 insertions(+)
 create mode 100644 src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp
 create mode 100644 src/FeaturesAPI/FeaturesAPI_NormalToFace.h
 create mode 100644 src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.cpp
 create mode 100644 src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.h
 create mode 100644 src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp
 create mode 100644 src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h
 create mode 100644 src/FeaturesPlugin/Test/TestNormalToFace.py
 create mode 100644 src/FeaturesPlugin/create_normal_to_face_widget.xml
 create mode 100644 src/FeaturesPlugin/doc/TUI_normalToFaceFeature.rst
 create mode 100644 src/FeaturesPlugin/doc/examples/create_normal_to_face.py
 create mode 100644 src/FeaturesPlugin/doc/examples/create_normal_to_face_at_vertex.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
 create mode 100644 src/FeaturesPlugin/icons/normale.png
 create mode 100644 src/FeaturesPlugin/normal_to_face_widget.xml
 create mode 100644 src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.cpp
 create mode 100644 src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.h

diff --git a/src/FeaturesAPI/CMakeLists.txt b/src/FeaturesAPI/CMakeLists.txt
index 9cb86e10b..6cd9ba368 100644
--- a/src/FeaturesAPI/CMakeLists.txt
+++ b/src/FeaturesAPI/CMakeLists.txt
@@ -32,6 +32,7 @@ SET(PROJECT_HEADERS
   FeaturesAPI_Fillet.h
   FeaturesAPI_Intersection.h
   FeaturesAPI_Measurement.h
+  FeaturesAPI_NormalToFace.h
   FeaturesAPI_MultiRotation.h
   FeaturesAPI_MultiTranslation.h
   FeaturesAPI_Partition.h
@@ -68,6 +69,7 @@ SET(PROJECT_SOURCES
   FeaturesAPI_Fillet.cpp
   FeaturesAPI_Intersection.cpp
   FeaturesAPI_Measurement.cpp
+  FeaturesAPI_NormalToFace.cpp
   FeaturesAPI_MultiRotation.cpp
   FeaturesAPI_MultiTranslation.cpp
   FeaturesAPI_Partition.cpp
diff --git a/src/FeaturesAPI/FeaturesAPI.i b/src/FeaturesAPI/FeaturesAPI.i
index 01804317a..d9fa7c0b5 100644
--- a/src/FeaturesAPI/FeaturesAPI.i
+++ b/src/FeaturesAPI/FeaturesAPI.i
@@ -63,6 +63,7 @@
 %shared_ptr(FeaturesAPI_BooleanSmash)
 %shared_ptr(FeaturesAPI_BooleanFill)
 %shared_ptr(FeaturesAPI_Chamfer)
+%shared_ptr(FeaturesAPI_NormalToFace)
 %shared_ptr(FeaturesAPI_Extrusion)
 %shared_ptr(FeaturesAPI_ExtrusionBoolean)
 %shared_ptr(FeaturesAPI_ExtrusionCut)
@@ -212,6 +213,7 @@
 %include "FeaturesAPI_Fillet.h"
 %include "FeaturesAPI_Intersection.h"
 %include "FeaturesAPI_Measurement.h"
+%include "FeaturesAPI_NormalToFace.h"
 %include "FeaturesAPI_MultiRotation.h"
 %include "FeaturesAPI_MultiTranslation.h"
 %include "FeaturesAPI_Partition.h"
diff --git a/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp b/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp
new file mode 100644
index 000000000..0dd67e05e
--- /dev/null
+++ b/src/FeaturesAPI/FeaturesAPI_NormalToFace.cpp
@@ -0,0 +1,113 @@
+// Copyright (C) 2014-2021  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
+//
+
+#include "FeaturesAPI_NormalToFace.h"
+
+#include <ModelHighAPI_Dumper.h>
+#include <ModelHighAPI_Selection.h>
+#include <ModelHighAPI_Tools.h>
+
+//=================================================================================================
+FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
+                                    const std::shared_ptr<ModelAPI_Feature>& theFeature)
+  : ModelHighAPI_Interface(theFeature)
+{
+  initialize();
+}
+
+//=================================================================================================
+FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
+                                    const std::shared_ptr<ModelAPI_Feature>& theFeature,
+                                    const ModelHighAPI_Selection& theBaseFace,
+                                    const ModelHighAPI_Selection& theOptionalPoint)
+:ModelHighAPI_Interface(theFeature)
+{
+  if (initialize()) {
+    fillAttribute(theBaseFace, myfaceSelected);
+    fillAttribute(theOptionalPoint, myvertexSelected);
+    feature()->string(FeaturesPlugin_NormalToFace::VERTEX_OPTION_ID())->setValue("true");
+    execute();
+  }
+}
+
+//=================================================================================================
+FeaturesAPI_NormalToFace::FeaturesAPI_NormalToFace(
+                                    const std::shared_ptr<ModelAPI_Feature>& theFeature,
+                                    const ModelHighAPI_Selection& theBaseFace)
+:ModelHighAPI_Interface(theFeature)
+{
+  if (initialize()) {
+    fillAttribute(theBaseFace, myfaceSelected);
+    feature()->string(FeaturesPlugin_NormalToFace::VERTEX_OPTION_ID())->setValue("");
+    execute();
+  }
+}
+
+//=================================================================================================
+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_NormalToFace::FACE_SELECTED_ID());
+
+  theDumper << aBase << " = model.getNormal(" << aDocName << ", " << anAttrObject;
+
+  if (!aBase->string(FeaturesPlugin_NormalToFace::VERTEX_OPTION_ID())->value().empty()) {
+
+    AttributeSelectionPtr anAttrVertex =
+            aBase->selection(FeaturesPlugin_NormalToFace::VERTEX_SELECTED_ID());
+
+    theDumper << ", " << anAttrVertex;
+  }
+
+  theDumper << ")" << std::endl;
+}
+
+//==================================================================================================
+NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
+                    const ModelHighAPI_Selection& theBaseFace,
+                    const ModelHighAPI_Selection& theOptionalPoint)
+{
+
+  FeaturePtr aFeature = thePart->addFeature(FeaturesPlugin_NormalToFace::ID());
+  NormalPtr aNormalToface;
+  aNormalToface.reset(new FeaturesAPI_NormalToFace(aFeature, theBaseFace, theOptionalPoint));
+
+  return aNormalToface;
+}
+
+//=================================================================================================
+NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
+                    const ModelHighAPI_Selection& theBaseFace)
+{
+
+  FeaturePtr aFeature = thePart->addFeature(FeaturesPlugin_NormalToFace::ID());
+  NormalPtr aNormalToface;
+  aNormalToface.reset(new FeaturesAPI_NormalToFace(aFeature, theBaseFace));
+
+  return aNormalToface;
+}
+
diff --git a/src/FeaturesAPI/FeaturesAPI_NormalToFace.h b/src/FeaturesAPI/FeaturesAPI_NormalToFace.h
new file mode 100644
index 000000000..da0719b06
--- /dev/null
+++ b/src/FeaturesAPI/FeaturesAPI_NormalToFace.h
@@ -0,0 +1,93 @@
+// Copyright (C) 2014-2021  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
+//
+
+#ifndef FeaturesAPI_NormalToFace_H_
+#define FeaturesAPI_NormalToFace_H_
+
+#include "FeaturesAPI.h"
+
+#include <FeaturesPlugin_NormalToFace.h>
+
+#include <ModelHighAPI_Interface.h>
+#include <ModelHighAPI_Macro.h>
+
+
+class ModelHighAPI_Selection;
+
+/// \class FeaturesAPI_NormalToFace
+/// \ingroup CPPHighAPI
+/// \brief Interface for NormalToface feature.
+class FeaturesAPI_NormalToFace: public ModelHighAPI_Interface
+{
+public:
+  /// Constructor without values.
+  FEATURESAPI_EXPORT
+  explicit FeaturesAPI_NormalToFace(const std::shared_ptr<ModelAPI_Feature>& theFeature);
+
+  /// Constructor with values.
+  FEATURESAPI_EXPORT
+  explicit FeaturesAPI_NormalToFace(const std::shared_ptr<ModelAPI_Feature>& theFeature,
+                                    const ModelHighAPI_Selection& theBaseFace,
+                                    const ModelHighAPI_Selection& theOptionalPoint);
+
+  /// Constructor with values.
+  FEATURESAPI_EXPORT
+  explicit FeaturesAPI_NormalToFace(const std::shared_ptr<ModelAPI_Feature>& theFeature,
+                                    const ModelHighAPI_Selection& theBaseFace);
+
+  /// Destructor.
+  FEATURESAPI_EXPORT
+  virtual ~FeaturesAPI_NormalToFace();
+
+  INTERFACE_3(FeaturesPlugin_NormalToFace::ID(),
+              faceSelected, FeaturesPlugin_NormalToFace::FACE_SELECTED_ID(),
+              ModelAPI_AttributeSelection, /** base face */,
+              vertexSelected, FeaturesPlugin_NormalToFace::VERTEX_SELECTED_ID(),
+              ModelAPI_AttributeSelection, /** vertex */,
+              vertexOption, FeaturesPlugin_NormalToFace::VERTEX_OPTION_ID(),
+              ModelAPI_AttributeString, /** use a vertex */)
+
+  /// Dump wrapped feature
+  FEATURESAPI_EXPORT
+  virtual void dump(ModelHighAPI_Dumper& theDumper) const;
+
+};
+
+/// Pointer on the NormalToface object.
+typedef std::shared_ptr<FeaturesAPI_NormalToFace> NormalPtr;
+
+/// \ingroup CPPHighAPI
+/// \brief Create normal to a face feature
+/// \param thePart the part
+/// \param theBaseFace the selected face
+/// \param theOptionalPoint the selected point
+FEATURESAPI_EXPORT
+NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
+                    const ModelHighAPI_Selection& theBaseFace,
+                    const ModelHighAPI_Selection& theOptionalPoint);
+
+/// \ingroup CPPHighAPI
+/// \brief Create normal to a face feature
+/// \param thePart the part
+/// \param theBaseFace the selected face
+FEATURESAPI_EXPORT
+NormalPtr getNormal(const std::shared_ptr<ModelAPI_Document>& thePart,
+                    const ModelHighAPI_Selection& theBaseFace);
+
+#endif // FeaturesAPI_NormalToFace_H_
diff --git a/src/FeaturesAPI/FeaturesAPI_swig.h b/src/FeaturesAPI/FeaturesAPI_swig.h
index ce4a8887e..ede8f2c11 100644
--- a/src/FeaturesAPI/FeaturesAPI_swig.h
+++ b/src/FeaturesAPI/FeaturesAPI_swig.h
@@ -35,6 +35,7 @@
   #include "FeaturesAPI_Fillet.h"
   #include "FeaturesAPI_Intersection.h"
   #include "FeaturesAPI_Measurement.h"
+  #include "FeaturesAPI_NormalToFace.h"
   #include "FeaturesAPI_MultiRotation.h"
   #include "FeaturesAPI_MultiTranslation.h"
   #include "FeaturesAPI_Partition.h"
diff --git a/src/FeaturesPlugin/CMakeLists.txt b/src/FeaturesPlugin/CMakeLists.txt
index 91dee176f..e3f25e81d 100644
--- a/src/FeaturesPlugin/CMakeLists.txt
+++ b/src/FeaturesPlugin/CMakeLists.txt
@@ -72,6 +72,8 @@ SET(PROJECT_HEADERS
     FeaturesPlugin_BoundingBox.h
     FeaturesPlugin_BoundingBoxBase.h
     FeaturesPlugin_InspectBoundingBox.h
+    FeaturesPlugin_NormalToFace.h
+    FeaturesPlugin_InspectNormalToFace.h
 )
 
 SET(PROJECT_SOURCES
@@ -124,6 +126,8 @@ SET(PROJECT_SOURCES
     FeaturesPlugin_BoundingBox.cpp
     FeaturesPlugin_BoundingBoxBase.cpp
     FeaturesPlugin_InspectBoundingBox.cpp
+    FeaturesPlugin_NormalToFace.cpp
+    FeaturesPlugin_InspectNormalToFace.cpp
 )
 
 SET(XML_RESOURCES
@@ -164,6 +168,8 @@ SET(XML_RESOURCES
   geometry_calculation_widget.xml
   bounding_box_widget.xml
   create_bounding_box_widget.xml
+  normal_to_face_widget.xml
+  create_normal_to_face_widget.xml
 )
 
 SET(TEXT_RESOURCES
diff --git a/src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.cpp b/src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.cpp
new file mode 100644
index 000000000..7cf17a3a2
--- /dev/null
+++ b/src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.cpp
@@ -0,0 +1,165 @@
+// Copyright (C) 2014-2021  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
+//
+
+#include "FeaturesPlugin_InspectNormalToFace.h"
+
+#include <FeaturesPlugin_NormalToFace.h>
+
+#include <ModelAPI_AttributeSelection.h>
+#include <ModelAPI_AttributeBoolean.h>
+#include <ModelAPI_AttributeString.h>
+#include <ModelAPI_Data.h>
+#include <ModelAPI_ResultConstruction.h>
+#include <ModelAPI_Session.h>
+#include <ModelAPI_Validator.h>
+
+#include <GeomAPI_Dir.h>
+#include <GeomAPI_Edge.h>
+#include <GeomAPI_Lin.h>
+#include <GeomAPI_Vertex.h>
+
+#include <GeomAlgoAPI_EdgeBuilder.h>
+#include <GeomAlgoAPI_NormalToFace.h>
+#include <GeomAlgoAPI_PointBuilder.h>
+
+#include <Config_PropManager.h>
+
+#include <iomanip>
+#include <sstream>
+
+//=================================================================================================
+FeaturesPlugin_InspectNormalToFace::FeaturesPlugin_InspectNormalToFace() {}
+
+//=================================================================================================
+void FeaturesPlugin_InspectNormalToFace::initAttributes()
+{
+  // attribute for object selected
+  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());
+  data()->addAttribute(VERTEX_OPTION_ID(), ModelAPI_AttributeString::typeId());
+
+  ModelAPI_Session::get()->validators()->registerNotObligatory(getKind(), VERTEX_SELECTED_ID());
+
+}
+
+//=================================================================================================
+void FeaturesPlugin_InspectNormalToFace::execute()
+{
+  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 (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;
+    std::shared_ptr<GeomAPI_Pnt> aPnt = theNormal->lastPoint();
+    if (theNormal.get()) {
+      if (theNormal->isLine()) {
+        theDir = theNormal->line()->direction();
+      }
+    }
+    aPnt->translate(theDir, 100);
+
+    std::shared_ptr<GeomAPI_Edge> anEdge =
+                      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())
+      createNormal();
+    updateNormal();
+  } else {
+    if (myCreateFeature.get()) {
+      myCreateFeature->eraseResults();
+      SessionPtr aSession = ModelAPI_Session::get();
+      DocumentPtr aDoc =  aSession->activeDocument();
+      aDoc->removeFeature(myCreateFeature);
+      myCreateFeature.reset();
+    }
+  }
+}
+
+//=================================================================================================
+void FeaturesPlugin_InspectNormalToFace::attributeChanged(const std::string& theID)
+{
+   if (theID == FACE_SELECTED_ID()) {
+    if (myCreateFeature.get())
+      updateNormal();
+  }
+}
+
+//=================================================================================================
+void FeaturesPlugin_InspectNormalToFace::createNormal()
+{
+  SessionPtr aSession = ModelAPI_Session::get();
+
+  DocumentPtr aDoc =  aSession->activeDocument();
+
+  if (aDoc.get()) {
+    myCreateFeature = aDoc->addFeature(FeaturesPlugin_NormalToFace::ID());
+  }
+}
+
+//=================================================================================================
+void FeaturesPlugin_InspectNormalToFace::updateNormal()
+{
+  myCreateFeature->selection(FeaturesPlugin_NormalToFace::FACE_SELECTED_ID())
+                        ->setValue(selection(FACE_SELECTED_ID())->context() ,
+                                    selection(FACE_SELECTED_ID())->value());
+
+  myCreateFeature->string(FeaturesPlugin_NormalToFace::VERTEX_OPTION_ID())
+                        ->setValue(string(VERTEX_OPTION_ID())->value());
+
+  if (!string(VERTEX_OPTION_ID())->value().empty()) {
+    myCreateFeature->selection(FeaturesPlugin_NormalToFace::VERTEX_SELECTED_ID())
+                        ->setValue(selection(VERTEX_SELECTED_ID())->context() ,
+                                    selection(VERTEX_SELECTED_ID())->value());
+  }
+
+  myCreateFeature->execute();
+}
diff --git a/src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.h b/src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.h
new file mode 100644
index 000000000..014c5c613
--- /dev/null
+++ b/src/FeaturesPlugin/FeaturesPlugin_InspectNormalToFace.h
@@ -0,0 +1,103 @@
+// Copyright (C) 2014-2021  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
+//
+
+#ifndef FeaturesPlugin_InspectNormalToFace_H_
+#define FeaturesPlugin_InspectNormalToFace_H_
+
+#include "FeaturesPlugin.h"
+#include <ModelAPI_Feature.h>
+
+#include <GeomAPI_IPresentable.h>
+#include <GeomAPI_IScreenParams.h>
+
+/// \class FeaturesPlugin_InspectNormalToFace
+/// \ingroup Plugins
+/// \brief Feature to view the normal to face
+
+class FeaturesPlugin_InspectNormalToFace : public ModelAPI_Feature
+{
+public:
+  /// Normal to face macro kind.
+  inline static const std::string& ID()
+  {
+    static const std::string MY_ID("NormalMacro");
+    return MY_ID;
+  }
+
+  /// Attribute name for face selected.
+  inline static const std::string& FACE_SELECTED_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("vertex");
+    return MY_VERTEX_SELECTED_ID;
+  }
+
+   /// Attribute name for checkbox create box.
+  inline static const std::string& CREATENORMAL_ID()
+  {
+    static const std::string MY_CREATENORMAL_ID("createnormal");
+    return MY_CREATENORMAL_ID;
+  }
+
+  /// Attribute name of vertex option.
+  inline static const std::string& VERTEX_OPTION_ID()
+  {
+    static const std::string MY_VERTEX_OPTION_ID("vertex_option");
+    return MY_VERTEX_OPTION_ID;
+  }
+
+  /// \return the kind of a feature.
+  virtual const std::string& getKind()
+  {
+    return ID();
+  }
+
+  /// Performs the algorithm and stores results it in the data structure.
+  FEATURESPLUGIN_EXPORT virtual void execute();
+
+  /// Request for initialization of data model of the feature: adding all attributes
+  FEATURESPLUGIN_EXPORT virtual void initAttributes();
+
+  /// Called on change of any argument-attribute of this object
+  /// \param theID identifier of changed attribute
+  FEATURESPLUGIN_EXPORT virtual void attributeChanged(const std::string& theID);
+
+  /// Reimplemented from ModelAPI_Feature::isMacro(). Returns true.
+  FEATURESPLUGIN_EXPORT virtual bool isMacro() const { return true; }
+
+  /// Use plugin manager for features creation
+  FeaturesPlugin_InspectNormalToFace();
+
+  private:
+  /// Create normal in feature
+  void createNormal();
+  /// Update normal in feature
+  void updateNormal();
+  /// Feature to create normal
+  FeaturePtr myCreateFeature;
+
+};
+
+#endif
diff --git a/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp
new file mode 100644
index 000000000..862707655
--- /dev/null
+++ b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.cpp
@@ -0,0 +1,114 @@
+// Copyright (C) 2014-2021  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
+//
+
+#include "FeaturesPlugin_NormalToFace.h"
+
+#include <ModelAPI_AttributeSelection.h>
+#include <ModelAPI_AttributeString.h>
+#include <ModelAPI_Data.h>
+#include <ModelAPI_Session.h>
+#include <ModelAPI_Validator.h>
+#include <GeomAPI_Vertex.h>
+#include <GeomAPI_Edge.h>
+#include <Config_PropManager.h>
+#include <GeomAlgoAPI_NormalToFace.h>
+#include <GeomAPI_Lin.h>
+#include <GeomAPI_Dir.h>
+#include <GeomAlgoAPI_EdgeBuilder.h>
+#include <ModelAPI_ResultConstruction.h>
+
+#include <iomanip>
+#include <sstream>
+
+//=================================================================================================
+FeaturesPlugin_NormalToFace::FeaturesPlugin_NormalToFace()
+{
+}
+
+//=================================================================================================
+void FeaturesPlugin_NormalToFace::initAttributes()
+{
+  // attribute for object selected
+  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());
+
+  ModelAPI_Session::get()->validators()->registerNotObligatory(getKind(), VERTEX_SELECTED_ID());
+}
+
+//=================================================================================================
+void FeaturesPlugin_NormalToFace::attributeChanged(const std::string& theID)
+{
+}
+
+//=================================================================================================
+void FeaturesPlugin_NormalToFace::execute()
+{
+
+  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 (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;
+    std::shared_ptr<GeomAPI_Pnt> aPnt = theNormal->lastPoint();
+    if (theNormal.get()) {
+      if (theNormal->isLine()) {
+        theDir = theNormal->line()->direction();
+      }
+    }
+    aPnt->translate(theDir, 100);
+
+    std::shared_ptr<GeomAPI_Edge> anEdge =
+                        GeomAlgoAPI_EdgeBuilder::line(theNormal->firstPoint(),
+                                                      aPnt);
+
+    ResultConstructionPtr aConstr = document()->createConstruction(data());
+    aConstr->setInfinite(true);
+    aConstr->setShape(anEdge);
+    setResult(aConstr);
+  }
+}
+
+
diff --git a/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h
new file mode 100644
index 000000000..0c62694c1
--- /dev/null
+++ b/src/FeaturesPlugin/FeaturesPlugin_NormalToFace.h
@@ -0,0 +1,84 @@
+// Copyright (C) 2014-2021  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
+//
+
+#ifndef FeaturesPlugin_NormalToFace_H_
+#define FeaturesPlugin_NormalToFace_H_
+
+#include "FeaturesPlugin.h"
+#include <ModelAPI_Feature.h>
+
+#include <GeomAPI_IPresentable.h>
+#include <GeomAPI_IScreenParams.h>
+
+/// \class FeaturesPlugin_NormalToFace
+/// \ingroup Plugins
+/// \brief Persistence feature to construct normal to face
+class FeaturesPlugin_NormalToFace : public ModelAPI_Feature
+{
+public:
+  /// Normal to face kind.
+  inline static const std::string& ID()
+  {
+    static const std::string MY_ID("Normal");
+    return MY_ID;
+  }
+
+  /// Attribute name for face selected.
+  inline static const std::string& FACE_SELECTED_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("vertex");
+    return MY_VERTEX_SELECTED_ID;
+  }
+
+  /// Attribute name of vertex option.
+  inline static const std::string& VERTEX_OPTION_ID()
+  {
+    static const std::string MY_VERTEX_OPTION_ID("vertex_option");
+    return MY_VERTEX_OPTION_ID;
+  }
+
+  /// \return the kind of a feature.
+  virtual const std::string& getKind()
+  {
+    return ID();
+  }
+
+  /// Performs the algorithm and stores results it in the data structure.
+  FEATURESPLUGIN_EXPORT virtual void execute();
+
+  /// Request for initialization of data model of the feature: adding all attributes
+  FEATURESPLUGIN_EXPORT virtual void initAttributes();
+
+  /// Called on change of any argument-attribute of this object
+  /// \param theID identifier of changed attribute
+  FEATURESPLUGIN_EXPORT virtual void attributeChanged(const std::string& theID);
+
+  /// Use plugin manager for features creation
+  FeaturesPlugin_NormalToFace();
+
+};
+
+#endif
diff --git a/src/FeaturesPlugin/FeaturesPlugin_Plugin.cpp b/src/FeaturesPlugin/FeaturesPlugin_Plugin.cpp
index 20121610e..3d00700d6 100644
--- a/src/FeaturesPlugin/FeaturesPlugin_Plugin.cpp
+++ b/src/FeaturesPlugin/FeaturesPlugin_Plugin.cpp
@@ -34,11 +34,13 @@
 #include <FeaturesPlugin_Fillet1D.h>
 #include <FeaturesPlugin_GeometryCalculation.h>
 #include <FeaturesPlugin_InspectBoundingBox.h>
+#include <FeaturesPlugin_InspectNormalToFace.h>
 #include <FeaturesPlugin_Intersection.h>
 #include <FeaturesPlugin_Measurement.h>
 #include <FeaturesPlugin_PointCoordinates.h>
 #include <FeaturesPlugin_MultiRotation.h>
 #include <FeaturesPlugin_MultiTranslation.h>
+#include <FeaturesPlugin_NormalToFace.h>
 #include <FeaturesPlugin_Partition.h>
 #include <FeaturesPlugin_Pipe.h>
 #include <FeaturesPlugin_Placement.h>
@@ -209,6 +211,10 @@ FeaturePtr FeaturesPlugin_Plugin::createFeature(std::string theFeatureID)
     return FeaturePtr(new FeaturesPlugin_InspectBoundingBox);
   } else if (theFeatureID == FeaturesPlugin_BoundingBox::ID()) {
     return FeaturePtr(new FeaturesPlugin_BoundingBox);
+  } else if (theFeatureID == FeaturesPlugin_InspectNormalToFace::ID()) {
+    return FeaturePtr(new FeaturesPlugin_InspectNormalToFace);
+  } else if (theFeatureID == FeaturesPlugin_NormalToFace::ID()) {
+    return FeaturePtr(new FeaturesPlugin_NormalToFace);
   }
 
 
diff --git a/src/FeaturesPlugin/Test/TestNormalToFace.py b/src/FeaturesPlugin/Test/TestNormalToFace.py
new file mode 100644
index 000000000..51ed2424c
--- /dev/null
+++ b/src/FeaturesPlugin/Test/TestNormalToFace.py
@@ -0,0 +1,77 @@
+# Copyright (C) 2014-2021  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"
+
+#=========================================================================
+# Initialization of the test
+#=========================================================================
+model.begin()
+partSet = model.moduleDocument()
+
+### Create Part
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+
+### Create Box
+Box_1 = model.addBox(Part_1_doc, 10, 10, 10)
+model.do()
+
+#=========================================================================
+# Test 1. Create a normal to a face with only a face
+#=========================================================================
+Normal_1 = model.getNormal(Part_1_doc, model.selection("FACE", "Box_1_1/Top"))
+model.do()
+
+#=========================================================================
+# Test 2. Create a normal to a face with a face and a vertex
+#=========================================================================
+Normal_2 = model.getNormal(Part_1_doc, model.selection("FACE", "Box_1_1/Front"), model.selection("VERTEX", "[Box_1_1/Front][Box_1_1/Right][Box_1_1/Bottom]"))
+model.do()
+
+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)
+
+assert (len(Normal_2.results()) > 0)
+assert(Normal_2.feature().error() == "")
+anAxisResult = modelAPI_ResultConstruction(Normal_2.feature().firstResult())
+assert (anAxisResult is not None)
+
+#=========================================================================
+# End of test
+#=========================================================================
diff --git a/src/FeaturesPlugin/create_normal_to_face_widget.xml b/src/FeaturesPlugin/create_normal_to_face_widget.xml
new file mode 100644
index 000000000..82ee3be95
--- /dev/null
+++ b/src/FeaturesPlugin/create_normal_to_face_widget.xml
@@ -0,0 +1,20 @@
+<source>
+  <shape_selector id="face"
+                  label="Face"
+                  tooltip="Select a face"
+                  shape_types="face"
+                  default=""
+                  geometrical_selection="true">
+    <validator id="GeomValidators_ShapeType" parameters="wire,face"/>
+  </shape_selector>
+  <optionalbox id="vertex_option" title="Option">
+    <shape_selector id="vertex"
+                    label="Vertex"
+                    tooltip="Select a vertex"
+                    shape_types="vertex"
+                    default=""
+                    geometrical_selection="true">
+      <validator id="GeomValidators_ShapeType" parameters="vertex"/>
+    </shape_selector>
+  </optionalbox>
+</source>
diff --git a/src/FeaturesPlugin/doc/FeaturesPlugin.rst b/src/FeaturesPlugin/doc/FeaturesPlugin.rst
index 34e8fea42..6fc8177bd 100644
--- a/src/FeaturesPlugin/doc/FeaturesPlugin.rst
+++ b/src/FeaturesPlugin/doc/FeaturesPlugin.rst
@@ -26,6 +26,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
    pointCoordinatesFeature.rst
diff --git a/src/FeaturesPlugin/doc/TUI_normalToFaceFeature.rst b/src/FeaturesPlugin/doc/TUI_normalToFaceFeature.rst
new file mode 100644
index 000000000..196cebf1d
--- /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/create_normal_to_face.py
+    :linenos:
+    :language: python
+
+:download:`Download this script <examples/create_normal_to_face.py>`
+
+  .. _tui_create_normal_to_face_at_vertex:
+
+Create normal to a face at vertex
+=================================
+
+.. literalinclude:: examples/create_normal_to_face_at_vertex.py
+    :linenos:
+    :language: python
+
+:download:`Download this script <examples/create_normal_to_face_at_vertex.py>`
diff --git a/src/FeaturesPlugin/doc/examples/create_normal_to_face.py b/src/FeaturesPlugin/doc/examples/create_normal_to_face.py
new file mode 100644
index 000000000..c89e07c6b
--- /dev/null
+++ b/src/FeaturesPlugin/doc/examples/create_normal_to_face.py
@@ -0,0 +1,12 @@
+from salome.shaper import model
+import os
+
+model.begin()
+Box_1 = model.addBox(Part_1_doc, 10, 10, 10)
+model.do()
+    
+### Create BoundingBox
+Normal_1 = model.getNormal(Part_1_doc, model.selection("FACE", "Box_1_1/Top"))
+model.do()
+
+model.end()
diff --git a/src/FeaturesPlugin/doc/examples/create_normal_to_face_at_vertex.py b/src/FeaturesPlugin/doc/examples/create_normal_to_face_at_vertex.py
new file mode 100644
index 000000000..eb0071efb
--- /dev/null
+++ b/src/FeaturesPlugin/doc/examples/create_normal_to_face_at_vertex.py
@@ -0,0 +1,12 @@
+
+from salome.shaper import model
+import os
+
+model.begin()
+Box_1 = model.addBox(Part_1_doc, 10, 10, 10)
+model.do()
+    
+Normal_1 = model.getNormal(Part_1_doc, model.selection("FACE", "Box_1_1/Front"), model.selection("VERTEX", "[Box_1_1/Front][Box_1_1/Right][Box_1_1/Bottom]"))
+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
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

literal 0
HcmV?d00001

diff --git a/src/FeaturesPlugin/doc/normalToFaceFeature.rst b/src/FeaturesPlugin/doc/normalToFaceFeature.rst
new file mode 100644
index 000000000..e9da2793c
--- /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 in the center of the face.
+
+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.
diff --git a/src/FeaturesPlugin/icons/normale.png b/src/FeaturesPlugin/icons/normale.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/normal_to_face_widget.xml b/src/FeaturesPlugin/normal_to_face_widget.xml
new file mode 100644
index 000000000..71cde51e1
--- /dev/null
+++ b/src/FeaturesPlugin/normal_to_face_widget.xml
@@ -0,0 +1,21 @@
+<source>
+  <shape_selector id="face"
+                  label="Face"
+                  tooltip="Select a face"
+                  shape_types="face"
+                  default=""
+                  geometrical_selection="true">
+    <validator id="GeomValidators_ShapeType" parameters="wire,face"/>
+  </shape_selector>
+  <optionalbox id="vertex_option" title="Option">
+    <shape_selector id="vertex"
+                    label="Vertex"
+                    tooltip="Select a vertex"
+                    shape_types="vertex"
+                    default=""
+                    geometrical_selection="true">
+      <validator id="GeomValidators_ShapeType" parameters="vertex"/>
+    </shape_selector>
+  </optionalbox>
+  <boolvalue id="createnormal" label="Create normal" default="false"/>
+</source>
diff --git a/src/FeaturesPlugin/plugin-Features.xml b/src/FeaturesPlugin/plugin-Features.xml
index 7fb18f31f..87e47c378 100644
--- a/src/FeaturesPlugin/plugin-Features.xml
+++ b/src/FeaturesPlugin/plugin-Features.xml
@@ -196,5 +196,15 @@
         <source path="measurement_widget.xml"/>
       </feature>
     </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="normalToFaceFeature.html">
+        <source path="normal_to_face_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="normalToFaceFeature.html" internal="1">
+        <source path="create_normal_to_face_widget.xml"/>
+      </feature>
+    </group>
   </workbench>
 </plugin>
diff --git a/src/FeaturesPlugin/tests.set b/src/FeaturesPlugin/tests.set
index 404476a40..7e5e58612 100644
--- a/src/FeaturesPlugin/tests.set
+++ b/src/FeaturesPlugin/tests.set
@@ -521,4 +521,5 @@ SET(TEST_NAMES
                TestGeometryCalculation.py
                TestBoundingBox.py
                Test23885.py
+               TestNormalToFace.py
 )
diff --git a/src/GeomAlgoAPI/CMakeLists.txt b/src/GeomAlgoAPI/CMakeLists.txt
index 0c549a45b..2fa736470 100644
--- a/src/GeomAlgoAPI/CMakeLists.txt
+++ b/src/GeomAlgoAPI/CMakeLists.txt
@@ -91,6 +91,7 @@ SET(PROJECT_HEADERS
     GeomAlgoAPI_Chamfer.h
     GeomAlgoAPI_Defeaturing.h
     GeomAlgoAPI_BoundingBox.h
+    GeomAlgoAPI_NormalToFace.h
 )
 
 SET(PROJECT_SOURCES
@@ -161,6 +162,7 @@ SET(PROJECT_SOURCES
     GeomAlgoAPI_Chamfer.cpp
     GeomAlgoAPI_Defeaturing.cpp
     GeomAlgoAPI_BoundingBox.cpp
+    GeomAlgoAPI_NormalToFace.cpp
 )
 
 SET(PROJECT_LIBRARIES
diff --git a/src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.cpp b/src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.cpp
new file mode 100644
index 000000000..2028b9902
--- /dev/null
+++ b/src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.cpp
@@ -0,0 +1,242 @@
+// Copyright (C) 2014-2021  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
+//
+
+#include "GeomAlgoAPI_NormalToFace.h"
+
+#include <TopoDS_Shape.hxx>
+#include <TopoDS_Face.hxx>
+#include <TopoDS.hxx>
+#include <BRep_Tool.hxx>
+#include <gp_Ax3.hxx>
+#include <Geom_Plane.hxx>
+#include <gp_Pln.hxx>
+#include <TopoDS_Iterator.hxx>
+#include <GProp_GProps.hxx>
+#include <BRepGProp.hxx>
+#include <ShapeAnalysis.hxx>
+#include <ShapeAnalysis_Surface.hxx>
+#include <BRepAdaptor_Surface.hxx>
+#include <BRepBndLib.hxx>
+#include <GeomLProp_SLProps.hxx>
+#include <BRepBuilderAPI_MakeEdge.hxx>
+#include <GeomAPI_Edge.h>
+
+ /*!
+   * \brief Return type of shape for explode. In case of compound it will be a type of its first sub shape.
+   * \param theShape The shape to get type of.
+   * \retval TopAbs_ShapeEnum Return type of shape for explode.
+   */
+TopAbs_ShapeEnum GetTypeOfSimplePart(const TopoDS_Shape& theShape)
+{
+  TopAbs_ShapeEnum aType = theShape.ShapeType();
+  if      (aType == TopAbs_VERTEX)                             return TopAbs_VERTEX;
+  else if (aType == TopAbs_EDGE  || aType == TopAbs_WIRE)      return TopAbs_EDGE;
+  else if (aType == TopAbs_FACE  || aType == TopAbs_SHELL)     return TopAbs_FACE;
+  else if (aType == TopAbs_SOLID || aType == TopAbs_COMPSOLID) return TopAbs_SOLID;
+  else if (aType == TopAbs_COMPOUND) {
+    // Only the iType of the first shape in the compound is taken into account
+    TopoDS_Iterator It (theShape, Standard_False, Standard_False);
+    if (It.More()) {
+      return GetTypeOfSimplePart(It.Value());
+    }
+  }
+  return TopAbs_SHAPE;
+}
+
+ /*!
+   * \brief Get Local Coordinate System, corresponding to the given shape.
+   * \param theShape The shape to get type of.
+   * \retval gp_Ax3 Return axis.
+   *
+   * Origin of the LCS is situated at the shape's center of mass.
+   * Axes of the LCS are obtained from shape's location or,
+   * if the shape is a planar face, from position of its plane.
+   */
+gp_Ax3 GetPosition(const TopoDS_Shape& theShape)
+{
+  gp_Ax3 aResult;
+
+  if (theShape.IsNull())
+    return aResult;
+
+  // Axes
+  aResult.Transform(theShape.Location().Transformation());
+  if (theShape.ShapeType() == TopAbs_FACE) {
+    Handle(Geom_Surface) aGS = BRep_Tool::Surface(TopoDS::Face(theShape));
+    if (!aGS.IsNull() && aGS->IsKind(STANDARD_TYPE(Geom_Plane))) {
+      Handle(Geom_Plane) aGPlane = Handle(Geom_Plane)::DownCast(aGS);
+      gp_Pln aPln = aGPlane->Pln();
+      aResult = aPln.Position();
+      // In case of reverse orinetation of the face invert the plane normal
+      // (the face's normal does not mathc the plane's normal in this case)
+      if (theShape.Orientation() == TopAbs_REVERSED) {
+        gp_Dir Vx =  aResult.XDirection();
+        gp_Dir N  =  aResult.Direction().Mirrored(Vx);
+        gp_Pnt P  =  aResult.Location();
+        aResult = gp_Ax3(P, N, Vx);
+      }
+    }
+  }
+
+  // Origin
+  gp_Pnt aPnt;
+
+  TopAbs_ShapeEnum aShType = theShape.ShapeType();
+
+  if (aShType == TopAbs_VERTEX) {
+    aPnt = BRep_Tool::Pnt(TopoDS::Vertex(theShape));
+  } else {
+    if (aShType == TopAbs_COMPOUND) {
+      aShType = GetTypeOfSimplePart(theShape);
+    }
+
+    GProp_GProps aSystem;
+    if (aShType == TopAbs_EDGE || aShType == TopAbs_WIRE)
+      BRepGProp::LinearProperties(theShape, aSystem);
+    else if (aShType == TopAbs_FACE || aShType == TopAbs_SHELL)
+      BRepGProp::SurfaceProperties(theShape, aSystem);
+    else
+      BRepGProp::VolumeProperties(theShape, aSystem);
+
+    aPnt = aSystem.CentreOfMass();
+  }
+
+  aResult.SetLocation(aPnt);
+
+  return aResult;
+}
+
+//=================================================================================================
+bool GeomAlgoAPI_NormalToFace::normal(GeomShapePtr theFace,
+                                      GeomShapePtr thePoint,
+                                      GeomEdgePtr  theNormal,
+                                      std::string& theError)
+{
+  #ifdef _DEBUG
+  std::cout << "GeomAlgoAPI_NormalToFace::normal" << std::endl;
+  #endif
+
+  if (!theFace.get()) {
+    theError = "Face for normale calculation is null";
+    return false;
+  }
+
+  TopoDS_Shape aShape = theFace->impl<TopoDS_Shape>();
+
+  if (aShape.ShapeType() != TopAbs_FACE) {
+    theError = "Shape for normale calculation is not a face";
+    return false;
+  }
+
+  TopoDS_Face aFace = TopoDS::Face(aShape);
+
+  // Point
+  gp_Pnt p1 (0,0,0);
+  // Point parameters on surface
+  double u1, u2, v1, v2;
+  Handle(Geom_Surface) aSurf = BRep_Tool::Surface(aFace);
+  Handle(ShapeAnalysis_Surface) aSurfAna = new ShapeAnalysis_Surface (aSurf);
+  gp_Ax3 aPos = GetPosition(aFace);
+  p1 = aPos.Location();
+  // Set default starting point using UV bounds
+  ShapeAnalysis::GetFaceUVBounds(aFace, u1, u2, v1, v2);
+  gp_Pnt2d pUV ((u2 + u1) * 0.5, (v2 + v1) * 0.5);
+
+  // Change to Vertex coord if selected
+  if (thePoint.get()) {
+    TopoDS_Shape anOptPnt = thePoint->impl<TopoDS_Shape>();
+    if (anOptPnt.IsNull()) {
+      theError = "Invalid shape given for point argument";
+      return false;
+    }
+    p1 = BRep_Tool::Pnt(TopoDS::Vertex(anOptPnt));
+    pUV = aSurfAna->ValueOfUV(p1, Precision::Confusion());
+  }
+
+  // Normal direction
+  gp_Vec Vec1,Vec2;
+  BRepAdaptor_Surface SF (aFace);
+  SF.D1(pUV.X(), pUV.Y(), p1, Vec1, Vec2);
+  if (Vec1.Magnitude() < Precision::Confusion()) {
+    gp_Vec tmpV;
+    gp_Pnt tmpP;
+    SF.D1(pUV.X(), pUV.Y()-0.1, tmpP, Vec1, tmpV);
+  }
+  else if (Vec2.Magnitude() < Precision::Confusion()) {
+    gp_Vec tmpV;
+    gp_Pnt tmpP;
+    SF.D1(pUV.X()-0.1, pUV.Y(), tmpP, tmpV, Vec2);
+  }
+
+  gp_Vec V = Vec1.Crossed(Vec2);
+  Standard_Real mod = V.Magnitude();
+  if (mod < Precision::Confusion())
+    Standard_NullObject::Raise("Normal vector of a face has null magnitude");
+
+  // Set length of normal vector to average radius of curvature
+  Standard_Real radius = 0.0;
+  GeomLProp_SLProps aProperties (aSurf, pUV.X(), pUV.Y(), 2, Precision::Confusion());
+  if (aProperties.IsCurvatureDefined()) {
+    Standard_Real radius1 = Abs(aProperties.MinCurvature());
+    Standard_Real radius2 = Abs(aProperties.MaxCurvature());
+    if (Abs(radius1) > Precision::Confusion()) {
+      radius = 1.0 / radius1;
+      if (Abs(radius2) > Precision::Confusion()) {
+        radius = (radius + 1.0 / radius2) / 2.0;
+      }
+    } else {
+      if (Abs(radius2) > Precision::Confusion()) {
+        radius = 1.0 / radius2;
+      }
+    }
+  }
+
+  // Set length of normal vector to average dimension of the face
+  // (only if average radius of curvature is not appropriate)
+  if (radius < Precision::Confusion()) {
+    Bnd_Box B;
+    Standard_Real Xmin, Xmax, Ymin, Ymax, Zmin, Zmax;
+    BRepBndLib::Add(aFace, B);
+    B.Get(Xmin, Ymin, Zmin, Xmax, Ymax, Zmax);
+    radius = ((Xmax - Xmin) + (Ymax - Ymin) + (Zmax - Zmin)) / 3.0;
+  }
+
+  if (radius < Precision::Confusion())
+    radius = 1.0;
+
+  V *= radius / mod;
+
+  // consider the face orientation
+  if (aFace.Orientation() == TopAbs_REVERSED ||
+      aFace.Orientation() == TopAbs_INTERNAL) {
+    V = - V;
+  }
+
+  // Edge
+  gp_Pnt p2 = p1.Translated(V);
+  BRepBuilderAPI_MakeEdge aBuilder (p1, p2);
+  if (!aBuilder.IsDone())
+    Standard_NullObject::Raise("Vector construction failed");
+  aShape = aBuilder.Shape();
+
+  theNormal->setImpl(new TopoDS_Shape(aShape));
+
+  return true;
+}
+
diff --git a/src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.h b/src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.h
new file mode 100644
index 000000000..4ee12c740
--- /dev/null
+++ b/src/GeomAlgoAPI/GeomAlgoAPI_NormalToFace.h
@@ -0,0 +1,46 @@
+// Copyright (C) 2014-2021  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
+//
+
+#ifndef GeomAlgoAPI_NormalToFace_H_
+#define GeomAlgoAPI_NormalToFace_H_
+
+#include <GeomAlgoAPI.h>
+#include <GeomAPI_Edge.h>
+#include <GeomAPI_Face.h>
+
+/**\class GeomAlgoAPI_NormalToFace
+ * \ingroup DataAlgo
+ * \brief Allows to create normal to face-shapes
+ */
+
+class GeomAlgoAPI_NormalToFace
+{
+ public:
+  /// Get the normal to face-shapes
+  /// \param theface   the face
+  /// \param thePoint the optional point
+  /// \param theNormal the normal
+  /// \param theError the error
+  GEOMALGOAPI_EXPORT  static bool normal(GeomShapePtr theFace,
+                                         GeomShapePtr thePoint,
+                                         GeomEdgePtr  theNormal,
+                                         std::string& theError);
+};
+
+#endif
diff --git a/src/PythonAPI/model/features/__init__.py b/src/PythonAPI/model/features/__init__.py
index 5ce684790..62a0ca1a8 100644
--- a/src/PythonAPI/model/features/__init__.py
+++ b/src/PythonAPI/model/features/__init__.py
@@ -31,6 +31,7 @@ from FeaturesAPI import addFillet, addChamfer
 from FeaturesAPI import addFusionFaces
 from FeaturesAPI import measureLength, measureDistance, measureRadius, measureAngle
 from FeaturesAPI import getPointCoordinates, getGeometryCalculation, getBoundingBox
+from FeaturesAPI import getNormal
 from FeaturesAPI import addRemoveResults
 from FeaturesAPI import addCopy, addImportResult
 from FeaturesAPI import addDefeaturing
-- 
2.30.2