FEAT: Uncover face (#6122)

Co-authored-by: mcapodif <massimo.capodiferro@ansys.com>
Co-authored-by: pyansys-ci-bot <92810346+pyansys-ci-bot@users.noreply.github.com>
Co-authored-by: Samuel Lopez <85613111+Samuelopez-ansys@users.noreply.github.com>

Author: 4 people

doc/changelog.d/6122.added.md

@@ -0,0 +1 @@
+Uncover face

src/ansys/aedt/core/modeler/cad/primitives.py

@@ -1481,6 +1481,66 @@ def cover_faces(self, assignment):
         self.oeditor.CoverSurfaces(["NAME:Selections", "Selections:=", obj_to_cover, "NewPartsModelFlag:=", "Model"])
         return True
 
+    @pyaedt_function_handler()
+    def uncover_faces(self, assignment):
+        """Uncover faces.
+
+        Parameters
+        ----------
+        assignment : list
+            Sheet objects to uncover.
+
+        Returns
+        -------
+        bool
+            ``True`` when successful, ``False`` when failed.
+
+        References
+        ----------
+        >>> oEditor.UncoverFaces
+
+        Examples
+        --------
+        >>> from ansys.aedt.core import Maxwell3D
+        >>> app = Maxwell3D()
+        >>> circle_1 = app.modeler.create_circle(cs_plane=0, position=[0, 0, 0], radius=3, name="Circle1")
+        >>> box_1 = app.modeler.create_box(origin=[-13.9 ,0 ,0],sizes=[27.8,-40,25.4], name="Box1")
+        >>> app.modeler.uncover_faces([circle_1.faces[0], [box_1.faces[0], box_1.faces[2]]])
+        """
+
+        faces = {}
+        flat_assignment = []
+
+        # create a flat list from assignment
+        for item in assignment:
+            if isinstance(item, list):
+                flat_assignment.extend(item)
+            else:
+                flat_assignment.append(item)
+
+        # loop through each item in the flattened list and create a dictionary
+        # associating object names to the face ids of faces to be uncovered
+        for fid in flat_assignment:
+            face_id = int(self.convert_to_selections(fid, False))
+            if fid.name not in faces.keys():
+                faces[fid.name] = [face_id]
+            elif fid.name in faces.keys():
+                faces[fid.name].append(face_id)
+
+        # create variables used in the native api in the right format
+        # for selections a concatenated string and for faces_to_uncover a list of int
+        selections = ", ".join(str(x) for x in faces.keys())
+        faces_to_uncover = []
+        for key in faces.keys():
+            faces_to_uncover.append(["NAME:UncoverFacesParameters", "FacesToUncover:=", faces[key]])
+        # call native api to uncover assigned faces
+        self.oeditor.UncoverFaces(
+            ["NAME:Selections", "Selections:=", selections, "NewPartsModelFlag:=", "Model"],
+            ["NAME:Parameters", *faces_to_uncover],
+        )
+
+        return True
+
     @pyaedt_function_handler()
     def create_coordinate_system(
         self,

tests/system/general/test_08_Primitives3D.py

@@ -2110,3 +2110,18 @@ def test_96_sweep_around_axis(self):
         assert circle1.name in self.aedtapp.modeler.solid_names
         assert circle2.name in self.aedtapp.modeler.solid_names
         assert circle3.name in self.aedtapp.modeler.solid_names
+
+    def test_97_uncover_faces(self):
+        o1 = self.aedtapp.modeler.create_circle(cs_plane=0, position=[0, 0, 0], radius=10)
+        assert self.aedtapp.modeler.uncover_faces([o1.faces[0]])
+        c1 = self.aedtapp.modeler.create_circle(orientation=AXIS.X, origin=[0, 10, 20], radius="3", name="Circle1")
+        b1 = self.aedtapp.modeler.create_box(origin=[-13.9, 0, 0], sizes=[27.8, -40, 25.4], name="Box1")
+        assert self.aedtapp.modeler.uncover_faces([c1.faces[0], b1.faces[0], b1.faces[2]])
+        assert len(b1.faces) == 4
+        c2 = self.aedtapp.modeler.create_circle(orientation=AXIS.X, origin=[0, 10, 20], radius="3", name="Circle2")
+        b2 = self.aedtapp.modeler.create_box(origin=[-13.9, 0, 0], sizes=[27.8, -40, 25.4], name="Box2")
+        assert self.aedtapp.modeler.uncover_faces([c2.faces, b2.faces])
+        c3 = self.aedtapp.modeler.create_circle(orientation=AXIS.X, origin=[0, 10, 20], radius="3", name="Circle3")
+        b3 = self.aedtapp.modeler.create_box(origin=[-13.9, 0, 0], sizes=[27.8, -40, 25.4], name="Box3")
+        assert self.aedtapp.modeler.uncover_faces([c3.faces[0], b3.faces])
+        assert len(b3.faces) == 0