Orientation property updated.

Author: ramin4667

src/ansys/aedt/core/emit_core/nodes/emit_node.py

@@ -406,24 +406,37 @@ def _add_child_node(self, child_type, child_name=None):
         return new_id
 
     @property
-    def reorient(self) -> None:
-        """Reorient an emit node in the schematic.
+    def orientation(self) -> int:
+        """Returns the orientation of the component.
 
         Returns:
-            int: The new orientation of the component (0 or 1).
-
-        Raises:
-            RuntimeError: If the component does not support orientation.
+            int: The orientation of the component, where valid values range from 0 to 3.
         """
-        try:
-            orientation = self._emit_obj.oeditor.GetComponentOrientation(self.name)
-            new_orientation = 1 - orientation
-            self._emit_obj.oeditor.ReorientComponent(self.name, new_orientation)
-            self._emit_obj.logger.info(f"Successfully reoriented component '{self.name}'.")
-        except Exception as e:
+        return self._emit_obj.oeditor.GetComponentOrientation(self.name)
+
+    @orientation.setter
+    def orientation(self, value: int) -> None:
+        if self.properties["Type"] != "Multiplexer" and value not in [0, 1]:
+            raise ValueError(f"Orientation must be either 0 or 1 for component '{self.name}'.")
+        elif self.properties["Type"] == "Multiplexer" and value not in [0, 1, 2, 3]:
+            raise ValueError("Orientation must be one of the following: 0, 1, 2, or 3 for Multiplexer components.")
+        if self.orintation_count > 1:
+            self._emit_obj.oeditor.ReorientComponent(self.name, value)
+            self._emit_obj.logger.info(f"Successfully set orientation to {value} for component '{self.name}'.")
+        else:
             error_message = (
-                f"Reorientation failed; orientation adjustment is not supported "
-                f"for component '{self.name}'. Error: {e}"
+                f"Orientation adjustment is not supported for component '{self.name}'. "
+                "This component cannot be reoriented."
             )
             self._emit_obj.logger.error(error_message)
-            raise RuntimeError(error_message)
+            raise ValueError(error_message)
+
+    @property
+    def orintation_count(self) -> int:
+        """Returns the number of orientations available for the component.
+
+        Returns:
+            int: The number of valid orientations. A value of 1 indicates the component cannot be reoriented,
+            2 indicates support for basic reorientation, and 4 is used for multiplexer components.
+        """
+        return self._emit_obj.oeditor.GetNumComponentOrientations(self.name)

tests/system/solvers/test_26_emit.py

@@ -1681,18 +1681,28 @@ def test_30_connect_components(self, add_app):
         ) in str(e.value)
 
     @pytest.mark.skipif(config["desktopVersion"] < "2025.2", reason="Skipped on versions earlier than 2025 R2.")
-    def test_31_reorient_component(self, add_app):
+    def test_31_orientation(self, add_app):
         self.aedtapp = add_app(project_name="reorient_component", application=Emit)
         new_circulator = self.aedtapp.schematic.create_component("Circulator")
+        assert 2 == new_circulator.orintation_count
         assert ["2", "3"] == [x for x in new_circulator.properties["AntennaSidePorts"].split("|")]
         assert ["1"] == [x for x in new_circulator.properties["RadioSidePorts"].split("|")]
-        new_circulator.reorient
+        new_circulator.orientation = 1
         assert ["1"] == [x for x in new_circulator.properties["AntennaSidePorts"].split("|")]
         assert ["3", "2"] == [x for x in new_circulator.properties["RadioSidePorts"].split("|")]
-        with pytest.raises(RuntimeError) as e:
+        with pytest.raises(ValueError) as e:
+            new_circulator.orientation = 3
+        assert "Orientation must be either 0 or 1 for component 'Circulator'." in str(e.value)
+        new_multiplexer = self.aedtapp.schematic.create_component("5 Port")
+        assert 4 == new_multiplexer.orintation_count
+        assert ["2", "3", "4", "5"] == [x for x in new_multiplexer.properties["AntennaSidePorts"].split("|")]
+        assert ["1"] == [x for x in new_multiplexer.properties["RadioSidePorts"].split("|")]
+        new_multiplexer.orientation = 2
+        assert ["1"] == [x for x in new_multiplexer.properties["AntennaSidePorts"].split("|")]
+        assert ["5", "4", "3", "2"] == [x for x in new_multiplexer.properties["RadioSidePorts"].split("|")]
+        with pytest.raises(ValueError) as e:
             new_radio = self.aedtapp.schematic.create_component("New Radio")
-            new_radio.reorient
+            new_radio.orientation = 1
         assert (
-            "Reorientation failed; orientation adjustment is not supported for component 'Radio'. "
-            "Error: Failed to execute gRPC AEDT command: ReorientComponent"
+            "Orientation adjustment is not supported for component 'Radio'. " "This component cannot be reoriented."
         ) in str(e.value)