pyedb 0.16.0__py3-none-any.whl → 0.18.0__py3-none-any.whl

pyedb/dotnet/edb_core/cell/hierarchy/component.py

@@ -24,6 +24,7 @@ import logging
 import re
 import warnings
 
+from pyedb.dotnet.edb_core.cell.hierarchy.hierarchy_obj import Group
 from pyedb.dotnet.edb_core.cell.hierarchy.model import PinPairModel, SPICEModel
 from pyedb.dotnet.edb_core.cell.hierarchy.netlist_model import NetlistModel
 from pyedb.dotnet.edb_core.cell.hierarchy.pin_pair_model import PinPair
@@ -44,7 +45,7 @@ if not is_ironpython:
 from pyedb.generic.general_methods import get_filename_without_extension
 
 
-class EDBComponent(object):
+class EDBComponent(Group):
     """Manages EDB functionalities for components.
 
     Parameters
@@ -56,9 +57,9 @@ class EDBComponent(object):
 
     """
 
-    def __init__(self, pedb, cmp):
-        self._pedb = pedb
-        self.edbcomponent = cmp
+    def __init__(self, pedb, edb_object):
+        super().__init__(pedb, edb_object)
+        self.edbcomponent = edb_object
         self._layout_instance = None
         self._comp_instance = None
 
@@ -186,7 +187,10 @@ class EDBComponent(object):
     @property
     def enabled(self):
         """Get or Set the component to active mode."""
-        return self.component_property.IsEnabled()
+        if self.type.lower() in ["resistor", "capacitor", "inductor"]:
+            return self.component_property.IsEnabled()
+        else:
+            return
 
     @enabled.setter
     def enabled(self, value):
@@ -319,11 +323,11 @@ class EDBComponent(object):
         str
             Reference Designator Name.
         """
-        return self.edbcomponent.GetName()
+        return self.name
 
     @refdes.setter
     def refdes(self, name):
-        self.edbcomponent.SetName(name)
+        self.name = name
 
     @property
     def is_null(self):
@@ -395,12 +399,7 @@ class EDBComponent(object):
         """
         if self.model_type == "RLC":
             if not self._pin_pairs:
-                if self.type == "Inductor":
-                    return 1e-9
-                elif self.type == "Resistor":
-                    return 1e6
-                else:
-                    return 1
+                return
             else:
                 pin_pair = self._pin_pairs[0]
             if len([i for i in pin_pair.rlc_enable if i]) == 1:
@@ -731,10 +730,6 @@ class EDBComponent(object):
         """Set component part name."""
         self.edbcomponent.GetComponentDef().SetName(name)
 
-    @property
-    def _edb(self):
-        return self._pedb.edb_api
-
     @property
     def placement_layer(self):
         """Placement layer.

pyedb/dotnet/edb_core/cell/hierarchy/hierarchy_obj.py

@@ -0,0 +1,50 @@
+# Copyright (C) 2023 - 2024 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+import logging
+
+from pyedb.dotnet.edb_core.cell.layout_obj import Connectable
+
+
+class HierarchyObj(Connectable):
+    def __init__(self, pedb, edb_object):
+        super().__init__(pedb, edb_object)
+
+    @property
+    def component_def(self):
+        """Component definition."""
+        return self._edb_object.GetComponentDef().GetName()
+
+    @property
+    def location(self):
+        """XY Coordinates."""
+        flag, x, y = self._edb_object.GetLocation()
+        if flag:
+            return [x, y]
+        else:  # pragma no cover
+            logging.warning(f"Failed to get location of '{self.name}'.")
+            return
+
+
+class Group(HierarchyObj):
+    def __init__(self, pedb, edb_object):
+        super().__init__(pedb, edb_object)

pyedb/dotnet/edb_core/cell/layout.py

@@ -84,8 +84,6 @@ class Layout(EdbLayout):
 
         Parameters
         ----------
-        layout : :class:`Layout <ansys.edb.layout.Layout>`
-            Layout this bondwire will be in.
         bondwire_type : :class:`BondwireType`
             Type of bondwire: kAPDBondWire or kJDECBondWire types.
         definition_name : str
@@ -96,16 +94,12 @@ class Layout(EdbLayout):
             Bondwire width.
         material : str
             Bondwire material name.
-        start_context : :class:`CellInstance <ansys.edb.hierarchy.CellInstance>`
-            Start context: None means top level.
         start_layer_name : str
             Name of start layer.
         start_x : :class:`Value <ansys.edb.utility.Value>`
             X value of start point.
         start_y : :class:`Value <ansys.edb.utility.Value>`
             Y value of start point.
-        end_context : :class:`CellInstance <ansys.edb.hierarchy.CellInstance>`
-            End context: None means top level.
         end_layer_name : str
             Name of end layer.
         end_x : :class:`Value <ansys.edb.utility.Value>`

pyedb/dotnet/edb_core/cell/voltage_regulator.py

@@ -51,11 +51,6 @@ class VoltageRegulator(Connectable):
             return
         self._edb_object.SetGroup(self._pedb.components.instances[value].edbcomponent)
 
-    @property
-    def id(self):
-        """Retrieve voltage regulator ID."""
-        return self._edb_object.GetId()
-
     @property
     def load_regulator_current(self):
         """Retrieve load regulator current value"""

pyedb/dotnet/edb_core/components.py

@@ -174,7 +174,7 @@ class Components(object):
         Examples
         --------
 
-        >>> from pyedb.dotnet.edb import Edb
+        >>> from pyedb import Edb
         >>> edbapp = Edb("myaedbfolder")
         >>> edbapp.components.components
 
@@ -194,7 +194,7 @@ class Components(object):
         Examples
         --------
 
-        >>> from pyedb.dotnet.edb import Edb
+        >>> from pyedb import Edb
         >>> edbapp = Edb("myaedbfolder")
         >>> edbapp.components.components
 

pyedb/dotnet/edb_core/dotnet/primitive.py

@@ -72,10 +72,38 @@ class PrimitiveDotNet:
         self.edb_api = api._edb
         self.prim_obj = prim_object
 
+    @property
+    def id(self):
+        return self.prim_obj.GetId()
+
     @property
     def api_class(self):
         return self.api
 
+    @property
+    def aedt_name(self):
+        """Name to be visualized in AEDT.
+
+        Returns
+        -------
+        str
+            Name.
+        """
+        from System import String
+
+        val = String("")
+
+        _, name = self.prim_obj.GetProductProperty(self._app._edb.ProductId.Designer, 1, val)
+        name = str(name).strip("'")
+        if name == "":
+            name = "{}__{}".format(self.primitive_type, self.id)
+            self.prim_obj.SetProductProperty(self._app._edb.ProductId.Designer, 1, name)
+        return name
+
+    @aedt_name.setter
+    def aedt_name(self, value):
+        self.prim_obj.SetProductProperty(self._app._edb.ProductId.Designer, 1, value)
+
     @property
     def api_object(self):
         return self.prim_obj
@@ -298,9 +326,9 @@ class PrimitiveDotNet:
                 # i += 1
             else:
                 arc_h = point.GetArcHeight().ToDouble()
-                p1 = [my_net_points[i-1].X.ToDouble(), my_net_points[i-1].Y.ToDouble()]
-                if i+1 < len(my_net_points):
-                    p2 = [my_net_points[i+1].X.ToDouble(), my_net_points[i+1].Y.ToDouble()]
+                p1 = [my_net_points[i - 1].X.ToDouble(), my_net_points[i - 1].Y.ToDouble()]
+                if i + 1 < len(my_net_points):
+                    p2 = [my_net_points[i + 1].X.ToDouble(), my_net_points[i + 1].Y.ToDouble()]
                 else:
                     p2 = [my_net_points[0].X.ToDouble(), my_net_points[0].Y.ToDouble()]
                 x_arc, y_arc = self._eval_arc_points(p1, p2, arc_h, num)
@@ -352,6 +380,61 @@ class PrimitiveDotNet:
         except:
             return points
 
+    def expand(self, offset=0.001, tolerance=1e-12, round_corners=True, maximum_corner_extension=0.001):
+        """Expand the polygon shape by an absolute value in all direction.
+        Offset can be negative for negative expansion.
+
+        Parameters
+        ----------
+        offset : float, optional
+            Offset value in meters.
+        tolerance : float, optional
+            Tolerance in meters.
+        round_corners : bool, optional
+            Whether to round corners or not.
+            If True, use rounded corners in the expansion otherwise use straight edges (can be degenerate).
+        maximum_corner_extension : float, optional
+            The maximum corner extension (when round corners are not used) at which point the corner is clipped.
+        """
+        new_poly = self.polygon_data.edb_api.Expand(offset, tolerance, round_corners, maximum_corner_extension)
+        self.polygon_data = new_poly[0]
+        return True
+
+    def scale(self, factor, center=None):
+        """Scales the polygon relative to a center point by a factor.
+
+        Parameters
+        ----------
+        factor : float
+            Scaling factor.
+        center : List of float or str [x,y], optional
+            If None scaling is done from polygon center.
+
+        Returns
+        -------
+        bool
+           ``True`` when successful, ``False`` when failed.
+        """
+        if not isinstance(factor, str):
+            factor = float(factor)
+            polygon_data = self.polygon_data.create_from_arcs(self.polygon_data.edb_api.GetArcData(), True)
+            if not center:
+                center = self.polygon_data.edb_api.GetBoundingCircleCenter()
+                if center:
+                    polygon_data.Scale(factor, center)
+                    self.polygon_data = polygon_data
+                    return True
+                else:
+                    self._pedb.logger.error(f"Failed to evaluate center on primitive {self.id}")
+            elif isinstance(center, list) and len(center) == 2:
+                center = self._edb.Geometry.PointData(
+                    self._edb.Utility.Value(center[0]), self._edb.Utility.Value(center[1])
+                )
+                polygon_data.Scale(factor, center)
+                self.polygon_data = polygon_data
+                return True
+        return False
+
 
 class RectangleDotNet(PrimitiveDotNet):
     """Class representing a rectangle object."""
@@ -577,6 +660,28 @@ class CircleDotNet(PrimitiveDotNet):
         """:obj:`bool`: If a circle can be a zone."""
         return True
 
+    def expand(self, offset=0.001, tolerance=1e-12, round_corners=True, maximum_corner_extension=0.001):
+        """Expand the polygon shape by an absolute value in all direction.
+        Offset can be negative for negative expansion.
+
+        Parameters
+        ----------
+        offset : float, optional
+            Offset value in meters.
+        tolerance : float, optional
+            Tolerance in meters. Ignored for Circle and Path.
+        round_corners : bool, optional
+            Whether to round corners or not.
+            If True, use rounded corners in the expansion otherwise use straight edges (can be degenerate).
+             Ignored for Circle and Path.
+        maximum_corner_extension : float, optional
+            The maximum corner extension (when round corners are not used) at which point the corner is clipped.
+             Ignored for Circle and Path.
+        """
+        center_x, center_y, radius = self.get_parameters()
+        self.set_parameters(center_x, center_y, radius.ToFloat() + offset)
+        return True
+
 
 class TextDotNet(PrimitiveDotNet):
     """Class representing a text object."""
@@ -851,6 +956,27 @@ class PathDotNet(PrimitiveDotNet):
         """
         return True
 
+    def expand(self, offset=0.001, tolerance=1e-12, round_corners=True, maximum_corner_extension=0.001):
+        """Expand the polygon shape by an absolute value in all direction.
+        Offset can be negative for negative expansion.
+
+        Parameters
+        ----------
+        offset : float, optional
+            Offset value in meters.
+        tolerance : float, optional
+            Tolerance in meters. Ignored for Circle and Path.
+        round_corners : bool, optional
+            Whether to round corners or not.
+            If True, use rounded corners in the expansion otherwise use straight edges (can be degenerate).
+             Ignored for Circle and Path.
+        maximum_corner_extension : float, optional
+            The maximum corner extension (when round corners are not used) at which point the corner is clipped.
+             Ignored for Circle and Path.
+        """
+        self.width = self.width + offset
+        return True
+
 
 class BondwireDotNet(PrimitiveDotNet):
     """Class representing a bondwire object."""